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.
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
phpdocomposer.json(8.3 quando ele não diz nada). - Composer —
composer install --no-dev --optimize-autoloader. - Assets de front-end — se o
package.jsontiver um scriptbuild(Vite), ele é executado e opublic/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 usamhttps://sem que você precise configurar proxies confiáveis.
Variáveis definidas para você
| Variável | Valor |
|---|---|
APP_KEY | gerada uma vez no primeiro deploy e guardada junto com suas variáveis |
APP_ENV | production |
APP_DEBUG | false |
APP_URL | o endereço do aplicativo |
LOG_CHANNEL | stderr — assim a aba Logs mostra o log do Laravel |
SESSION_DRIVER, CACHE_STORE | redis 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 minuto | php 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=redisREDIS_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.