Aplicaciones Laravel.
Lo que un proyecto Laravel recibe de serie: APP_KEY y ajustes de producción, SQLite hasta que añadas una base de datos, las migraciones como comando de release, un worker de colas y el programador de tareas.
Laravel se reconoce por laravel/framework en composer.json. Lo despliegas tal cual, sin configurar ningún servidor ni añadir archivos al repositorio.
Cómo se compila y se ejecuta
- PHP: la versión más baja entre 8.2, 8.3 y 8.4 que cumpla el requisito
phpdecomposer.json(8.3 si no indica ninguno). - Composer:
composer install --no-dev --optimize-autoloader. - Recursos de front-end: si
package.jsontiene un scriptbuild(Vite), se ejecuta y se incluyepublic/build. - Al arrancar:
storage:linky, después, se generan las cachés de configuración, rutas y vistas. - HTTPS: tu aplicación ve las peticiones HTTPS como seguras, así que
url(),asset()y las redirecciones usanhttps://sin que tengas que configurar los proxies de confianza.
Variables que configuramos por ti
| Variable | Valor |
|---|---|
APP_KEY | se genera una vez en el primer despliegue y se guarda con tus variables |
APP_ENV | production |
APP_DEBUG | false |
APP_URL | la dirección de la aplicación |
LOG_CHANNEL | stderr, para que la pestaña Registros muestre el log de Laravel |
SESSION_DRIVER, CACHE_STORE | redis cuando la aplicación tiene Valkey; si no, file |
Cualquiera de ellas se puede sustituir por una variable tuya con el mismo nombre, por ejemplo SESSION_DRIVER=database. Consulta Variables de entorno.
La base de datos: primero SQLite
Una aplicación Laravel nueva sin base de datos guarda sus datos en SQLite (la opción por defecto del propio Laravel), en storage/app/database.sqlite, en el disco de la aplicación. El archivo se mantiene entre despliegues y entra en las copias de seguridad diarias de la aplicación, así que puedes lanzar primero y decidir la base de datos más adelante.
Cuando añades PostgreSQL o MySQL al proyecto (Resumen → Servicios → Añadir un servicio), la aplicación se pasa a ella con el siguiente despliegue y las migraciones se ejecutan allí. Los datos del archivo SQLite no se trasladan: si los necesitas, expórtalos antes e impórtalos en la pestaña Datos de la base de datos. Consulta Bases de datos.
Migraciones: el comando de release
El comando de release recomendado es php artisan migrate --force. Se ejecuta una vez en cada despliegue, antes de que la nueva versión reciba visitantes; si una migración falla, la versión actual sigue funcionando. Puedes cambiarlo en la pestaña Procesos. Consulta Despliegues.
Worker de colas y programador
De serie, la pestaña Procesos ejecuta:
| Qué | Comando |
|---|---|
| Worker en segundo plano «queue» | php artisan queue:work --sleep=3 --tries=3 --max-time=3600 |
| Comando programado, cada minuto | php artisan schedule:run |
Comparten los recursos de la aplicación y se reinician con cada despliegue. Cámbialos o quítalos en la pestaña Procesos; por ejemplo, sustituye el worker por php artisan horizon si usas Horizon con Valkey.
Para una cola con mucha carga, ejecuta el worker como un servicio worker en segundo plano aparte, con sus propios recursos, y quítalo de Procesos. Consulta Servicios de un proyecto.
Valkey para caché, sesiones y colas
Añade Valkey al proyecto: las sesiones y la caché pasan a él solas (con el siguiente despliegue; los visitantes tendrán que iniciar sesión otra vez). Las colas y todo lo demás lo configuras en la pestaña Variables, por ejemplo:
CACHE_STORE=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redisREDIS_HOST, REDIS_PASSWORD, REDIS_PORT y REDIS_CLIENT=phpredis los configuramos por ti.
WebSockets (Laravel Reverb)
Ejecuta Reverb como un servicio web a partir del código de este proyecto con el comando php artisan reverb:start --host=0.0.0.0 --port=$PORT. Recibe su propia dirección.
Archivos y subidas
Los archivos de storage/app (los discos local y public de Laravel) se quedan en el disco de la aplicación entre despliegues y se copian cada día. Todo lo demás de la carpeta del proyecto llega de nuevo desde el repositorio con cada despliegue. Para muchos archivos o archivos grandes, usa el almacenamiento de objetos con el disco s3 de Laravel.