Pular para o conteúdo principal

🐘 Deploy de Aplicação PHP com Apache na SaveinCloud

⚠️ Todas as configurações demonstradas neste manual são exemplos simples e hipotéticos. Pode ser necessário realizar adaptações conforme a topologia do seu ambiente.

Este guia mostra como realizar o deploy de uma aplicação PHP utilizando Apache dentro da plataforma SaveinCloud.


✅ Requisitos recomendados

Antes de iniciar o deploy, certifique-se de que o projeto contenha:

  • Arquivos PHP prontos para execução (exemplo: index.php, config.php);

  • Estrutura de diretórios bem organizada;

  • Configurações de banco de dados ajustáveis (se aplicável);

  • Eventuais arquivos .htaccess (opcional);


Parte 1 - Configurando a Topologia com Apache PHP

🔧 Passo 1 – Montagem da Topologia

Adicione à camada de aplicação o serviço Apache PHP.

Topologia típica recomendada:

imagem


Load Balancer (opcional) → Apache PHP → Banco de Dados (opcional) → Armazenamento (opcional)

💡 Caso deseje utilizar HTTPS, configure diretamente no Apache o addon do Let's Encrypt ou um Load Balancer com certificado SSL.

Ajuste os cloudlets reservados conforme a necessidade da aplicação.


Parte 2 - Realizando deploy da aplicação

📁 Deploy via Upload ZIP

  1. Acesse a aba de **Implementar Arquivo ** no Apache PHP.

imagem

  1. Faça o upload do arquivo .zip.

imagem

✅ O conteúdo será automaticamente extraído para o contexto selecionado no momento do deploy, Ex: /var/www/webroot/ROOT


Parte 3 - Configuração de Ambiente PHP

📑 Customização de .htaccess (opcional)

Se necessário, adicione um arquivo .htaccess para controle de URL Rewriting, segurança ou outras diretivas Apache.

Exemplo básico para reescrita de URL:


RewriteEngine On

RewriteCond %{REQUEST_FILENAME} !-f

RewriteCond %{REQUEST_FILENAME} !-d

RewriteRule ^ index.php [L]

ℹ️ O módulo mod_rewrite já vem habilitado por padrão.


🛠️ Troubleshooting

❌ Erro 500 – Internal Server Error

Causa: Permissões incorretas ou erro de sintaxe no PHP.

Solução:
Verifique os logs de erro do Apache:

/var/log/httpd/


❌ Página em branco

Causa: Erros de PHP ocultos.

Solução:
Ative temporariamente o display_errors no php.ini:

display_errors = On

⚠️ Lembre-se de desativar em produção.


❌ Falha na conexão com o banco de dados

Causa: Hostname incorreto, usuário ou senha inválidos.

Solução:
Verifique e ajuste as credenciais de conexão no arquivo de configuração da sua aplicação (ex.: config.php).


❌ Limite de upload muito baixo

Causa: Restrições de tamanho configuradas no php.ini.

Solução:
Aumente os limites no painel da SaveinCloud, acessando Configuração > php.ini, e ajustando os parâmetros:

upload_max_filesize = 64M post_max_size = 64M

Logs principais:

var/log/

/var/log/httpd/