Começar

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.

3 MIN DE LEITURA

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 php do composer.json (8.3 quando não indica nada).
  • Composer — composer install --no-dev --optimize-autoloader.
  • Recursos de front-end — se o package.json tiver um script build (Vite), este é executado e public/build é incluído.
  • No arranque — storage:link e 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 usam https:// sem ter de configurar proxies de confiança.

Variáveis definidas automaticamente

VariávelValor
APP_KEYgerada uma vez no primeiro deploy e guardada com as suas variáveis
APP_ENVproduction
APP_DEBUGfalse
APP_URLo endereço da aplicação
LOG_CHANNELstderr — para que o separador Registos mostre o registo do Laravel
SESSION_DRIVER, CACHE_STOREredis 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 minutophp 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=redis

REDIS_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.

Ainda com dúvidas?

Fale connosco por chat — a AI responde de imediato e um engenheiro entra quando for preciso, a qualquer hora.

Contactar o suporte