Começar

Aplicativos Laravel.

O que um projeto Laravel recebe pronto: APP_KEY e configurações de produção, SQLite até você adicionar um banco de dados, migrations como comando de release, um worker de filas e o agendador.

3 MIN DE LEITURA

O Laravel é reconhecido pelo laravel/framework no composer.json. Você faz o deploy do jeito que ele está — sem configurar servidor, sem arquivos extras no repositório.

Como ele é construído e executado

  • PHP — a menor versão entre 8.2, 8.3 e 8.4 que atende ao requisito php do composer.json (8.3 quando ele não diz nada).
  • Composer — composer install --no-dev --optimize-autoloader.
  • Assets de front-end — se o package.json tiver um script build (Vite), ele é executado e o public/build é incluído.
  • Na inicialização — storage:link, depois são gerados os caches de configuração, rotas e views.
  • HTTPS — seu aplicativo enxerga as requisições HTTPS como seguras, então url(), asset() e os redirecionamentos usam https:// sem que você precise configurar proxies confiáveis.

Variáveis definidas para você

VariávelValor
APP_KEYgerada uma vez no primeiro deploy e guardada junto com suas variáveis
APP_ENVproduction
APP_DEBUGfalse
APP_URLo endereço do aplicativo
LOG_CHANNELstderr — assim a aba Logs mostra o log do Laravel
SESSION_DRIVER, CACHE_STOREredis quando o aplicativo tem Valkey; caso contrário, file

Qualquer uma delas pode ser substituída por uma variável sua com o mesmo nome — por exemplo, SESSION_DRIVER=database. Veja Variáveis de ambiente.

O banco de dados: primeiro o SQLite

Um aplicativo Laravel novo sem banco de dados guarda os dados no SQLite — o padrão do próprio Laravel — em storage/app/database.sqlite, no disco do aplicativo. O arquivo é mantido entre deploys e entra nos backups diários do aplicativo, então você pode lançar primeiro e escolher um banco de dados depois.

Quando você adiciona PostgreSQL ou MySQL ao projeto (Visão geral → Serviços → Adicionar um serviço), o aplicativo passa a usá-lo no próximo deploy, e as migrations rodam nele. Os dados do arquivo SQLite não são levados junto — exporte-os antes se precisar deles e importe-os na aba Dados do banco. Veja Bancos de dados.

Migrations — o comando de release

O comando de release recomendado é php artisan migrate --force. Ele roda uma vez a cada deploy, antes de a nova versão receber visitantes; se uma migration falhar, a versão atual continua rodando. Você pode alterá-lo na aba Processos. Veja Deploys.

Worker de filas e agendador

De fábrica, a aba Processos executa:

O quêComando
Worker em segundo plano «queue»php artisan queue:work --sleep=3 --tries=3 --max-time=3600
Comando agendado, a cada minutophp artisan schedule:run

Eles dividem os recursos do aplicativo e reiniciam a cada deploy. Altere ou remova-os na aba Processos — por exemplo, troque o worker por php artisan horizon quando usar o Horizon com Valkey.

Para uma fila pesada, rode o worker como um serviço separado de worker em segundo plano, com recursos próprios, e remova-o de Processos. Veja Serviços de um projeto.

Valkey para cache, sessões e filas

Adicione o Valkey ao projeto: as sessões e o cache passam para ele sozinhos (no próximo deploy; os visitantes precisam entrar mais uma vez). As filas e o que mais você quiser você define na aba Variáveis, por exemplo:

CACHE_STORE=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redis

REDIS_HOST, REDIS_PASSWORD, REDIS_PORT e REDIS_CLIENT=phpredis são definidas para você.

WebSockets (Laravel Reverb)

Rode o Reverb como um serviço web a partir do código deste projeto, com o comando php artisan reverb:start --host=0.0.0.0 --port=$PORT. Ele recebe um endereço próprio.

Arquivos e uploads

Os arquivos em storage/app — os discos local e public do Laravel — ficam no disco do aplicativo entre deploys e têm backup diário. Todo o resto da pasta do projeto vem novo do repositório a cada deploy. Para muitos arquivos ou arquivos grandes, use o armazenamento de objetos com o disco s3 do Laravel.

Ainda com dúvidas?

Fale com a gente no chat — a AI responde na hora e um engenheiro entra quando é preciso, a qualquer hora do dia.

Falar com o suporte