Este guia mostra como colocar uma aplicação Laravel no ar usando o painel do cliente: enviar o código, configurar o .env, rodar as migrações, agendar o scheduler e manter o worker de fila rodando.
Nos exemplos, o usuário é cliente, o domínio é exemplo.com.br e o PHP é 8.3. Troque pelos seus dados.
Antes de começar: peça ao administrador
Alguns itens só o administrador configura. Peça ao seu provedor:
- O domínio
exemplo.com.brcriado na sua conta, com a versão do PHP exigida pelo projeto. - A pasta pública (document root) apontando para
public_html/public. O Laravel só deve expor a pastapublic. - Um banco de dados, com nome, usuário e senha.
- O certificado SSL do domínio.
Confira em Meus Dominios se a coluna Document Root termina em /public_html/public.
Atenção: se o document root apontar para
public_html, o.enve o código-fonte ficam acessíveis pela internet. Não publique o site antes de corrigir.
1. Enviar o código
Opção A: Git Clone
- Abra Meus Arquivos e entre em
public_html. Ela precisa estar vazia: exclua oindex.htmlde exemplo, se houver. - Clique em Git Clone.
- Em URL do Repositorio, informe o endereço do projeto.
- Em Diretorio destino, digite
public_html. - Em Branch, informe a branch de produção (ex.:
main). - Clique em Clonar e aguarde "Repositorio clonado com sucesso".
Opção B: Upload de .zip
- Compacte o projeto em um
.zip(sem a pastanode_modules). - Em Meus Arquivos, entre em
public_htmle clique em Upload. - Selecione o
.zip, marque Descompactar apos upload e clique em Enviar. - Confira se o arquivo
artisanficou direto empublic_html, e não em uma subpasta.
2. Instalar dependências
Abra o Terminal e rode:
cd ~/public_html
composer install --no-dev --optimize-autoloader
Se o comando composer não existir no servidor, peça ao administrador ou envie a pasta vendor junto com o código.
3. Configurar o .env
-
Abra Associacoes. No quadro Arquivo .env da aplicação, confira em Arquivo se o caminho termina em
public_html/.env. Com o campo Pasta do projeto (onde a aplicacao le o .env) vazio, o painel detecta o Laravel sozinho e mostra a sugestão "automatico: public_html" (desde que ainda não exista um~/.env). Se o caminho for outro, digitepublic_htmlno campo e clique em Usar esta pasta. -
Clique em Banco de Dados. Preencha com os dados do administrador e clique em Adicionar.
-
Clique em Testar Conexao para conferir se o banco responde.
-
Se usar Redis, cadastre também em Redis.
-
No quadro Arquivo .env da aplicação, clique em Gerar das Associacoes.
-
Complete o restante das variáveis do projeto, por exemplo:
APP_NAME=Exemplo APP_ENV=production APP_DEBUG=false APP_URL=https://exemplo.com.br QUEUE_CONNECTION=database -
Clique em Salvar.
-
No Terminal, gere a chave da aplicação:
cd ~/public_html php8.3 artisan key:generate --force
Atenção: mantenha
APP_DEBUG=falseem produção. Comtrue, erros mostram senhas e caminhos para qualquer visitante.
4. Preparar a aplicação
No Terminal:
cd ~/public_html
php8.3 artisan migrate --force
php8.3 artisan storage:link
php8.3 artisan optimize
Se o projeto usa front-end compilado (Vite), envie a pasta public/build já gerada no seu computador ou no pipeline.
5. Agendar o scheduler (cron)
-
Abra Cron Jobs e clique em Novo Cron Job.
-
Clique no atalho A cada min.
-
Em Comando:
/usr/bin/php8.3 /home/cliente/public_html/artisan schedule:run >> /dev/null 2>&1 -
Clique em Adicionar.
6. Criar o worker de fila
Se o projeto usa filas (QUEUE_CONNECTION diferente de sync):
- Abra Servicos e clique em Laravel Queue em Templates Rapidos.
- Confira a Versao PHP e o Comando. Ajuste
--queue=se usar outras filas. - Clique em Criar e Iniciar e confira se o status ficou Ativo.
Se usar Horizon, crie o serviço com o modelo Laravel Horizon no lugar do Laravel Queue.
7. Recarregar o PHP e testar
- Em Meus Dominios, clique em Reload no quadro PHP-FPM.
- Abra
https://exemplo.com.brno navegador. - Se aparecer erro, consulte Meus Logs (tipo Error) e o arquivo
storage/logs/laravel.logem Meus Arquivos.
Atualizações seguintes (deploy)
A cada nova versão:
-
Meus Arquivos > Git Pull na pasta
public_html(ou novo upload). -
No Terminal:
cd ~/public_html composer install --no-dev --optimize-autoloader php8.3 artisan migrate --force php8.3 artisan optimize -
Servicos > Reiniciar no worker de fila.
-
Meus Dominios > Reload do PHP-FPM.
Dica: se a página mostrar erro 500 logo após o deploy, rode
php8.3 artisan optimize:cleare confira as permissões das pastasstorageebootstrap/cache.