Aplicações Laravel.
O que um projeto Laravel recebe de origem: APP_KEY e definições de produção, SQLite até adicionar uma base de dados, migrações como comando de release, um worker de filas e o agendador.
O Laravel é reconhecido pelo laravel/framework no composer.json. Publica-o tal como está — sem configuração de servidor nem ficheiros adicionais no repositório.
Como é feito o build e a execução
- PHP — a versão mais baixa entre 8.2, 8.3 e 8.4 que cumpra o requisito
phpdocomposer.json(8.3 quando não indica nada). - Composer —
composer install --no-dev --optimize-autoloader. - Recursos de front-end — se o
package.jsontiver um scriptbuild(Vite), este é executado epublic/buildé incluído. - No arranque —
storage:linke depois são geradas as caches de configuração, rotas e vistas. - HTTPS — a aplicação vê os pedidos HTTPS como seguros, por isso
url(),asset()e os redirecionamentos usamhttps://sem ter de configurar proxies de confiança.
Variáveis definidas automaticamente
| Variável | Valor |
|---|---|
APP_KEY | gerada uma vez no primeiro deploy e guardada com as suas variáveis |
APP_ENV | production |
APP_DEBUG | false |
APP_URL | o endereço da aplicação |
LOG_CHANNEL | stderr — para que o separador Registos mostre o registo do Laravel |
SESSION_DRIVER, CACHE_STORE | redis quando a aplicação tem Valkey, caso contrário file |
Qualquer uma pode ser substituída por uma variável sua com o mesmo nome — por exemplo, SESSION_DRIVER=database. Consulte Variáveis de ambiente.
A base de dados: primeiro SQLite
Uma aplicação Laravel nova sem base de dados guarda os dados em SQLite — a predefinição do próprio Laravel — em storage/app/database.sqlite, no disco da aplicação. O ficheiro sobrevive aos deploys e está incluído nas cópias de segurança diárias da aplicação, por isso pode lançar primeiro e decidir a base de dados mais tarde.
Quando adiciona PostgreSQL ou MySQL ao projeto (Visão geral → Serviços → Adicionar um serviço), a aplicação passa a usá-la no deploy seguinte e as migrações correm lá. Os dados do ficheiro SQLite não são transferidos — exporte-os primeiro, se precisar deles, e importe-os no separador Dados da base de dados. Consulte Bases de dados.
Migrações — o comando de release
O comando de release recomendado é php artisan migrate --force. Corre uma vez em cada deploy, antes de a nova versão receber visitantes; se uma migração falhar, a versão atual continua a funcionar. Pode alterá-lo no separador Processos. Consulte Deploys.
Worker de filas e agendador
De origem, o separador 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 |
Partilham os recursos da aplicação e reiniciam a cada deploy. Altere-os ou remova-os no separador Processos — por exemplo, substitua o worker por php artisan horizon quando usar o Horizon com Valkey.
Para uma fila pesada, execute o worker como um serviço worker em segundo plano separado, com recursos próprios, e remova-o de Processos. Consulte Serviços de um projeto.
Valkey para cache, sessões e filas
Adicione o Valkey ao projeto: as sessões e a cache passam para ele sozinhas (no deploy seguinte; os visitantes têm de iniciar sessão mais uma vez). As filas e tudo o resto define no separador 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 automaticamente.
WebSockets (Laravel Reverb)
Execute o Reverb como serviço web a partir do código deste projeto, com o comando php artisan reverb:start --host=0.0.0.0 --port=$PORT. Recebe um endereço próprio.
Ficheiros e uploads
Os ficheiros em storage/app — os discos local e public do Laravel — ficam no disco da aplicação entre deploys e têm cópia de segurança diária. Tudo o resto na pasta do projeto vem de novo do repositório a cada deploy. Para muitos ficheiros ou ficheiros grandes, use o armazenamento de objetos com o disco s3 do Laravel.