Applications Laravel.
Ce qu'un projet Laravel obtient d'emblée : APP_KEY et réglages de production, SQLite tant que vous n'avez pas ajouté de base de données, les migrations comme commande de release, un worker de file d'attente et le planificateur.
Laravel est reconnu grâce à laravel/framework dans composer.json. Vous le déployez tel quel : aucune configuration serveur, aucun fichier supplémentaire dans le dépôt.
Build et exécution
- PHP : la plus basse des versions 8.2, 8.3 et 8.4 qui satisfait l'exigence
phpdecomposer.json(8.3 si rien n'est précisé). - Composer :
composer install --no-dev --optimize-autoloader. - Assets front-end : si
package.jsoncontient un scriptbuild(Vite), il est exécuté etpublic/buildest inclus. - Au démarrage :
storage:link, puis les caches de configuration, de routes et de vues sont générés. - HTTPS : votre application considère les requêtes HTTPS comme sécurisées, donc
url(),asset()et les redirections utilisenthttps://sans que vous ayez à déclarer vous-même les proxys de confiance.
Variables définies pour vous
| Variable | Valeur |
|---|---|
APP_KEY | générée une fois lors du premier déploiement et conservée avec vos variables |
APP_ENV | production |
APP_DEBUG | false |
APP_URL | l'adresse de l'application |
LOG_CHANNEL | stderr, pour que l'onglet Journaux affiche le journal de Laravel |
SESSION_DRIVER, CACHE_STORE | redis quand l'application dispose de Valkey, sinon file |
Chacune peut être remplacée par votre propre variable du même nom, par exemple SESSION_DRIVER=database. Voir Variables d'environnement.
La base de données : SQLite d'abord
Une nouvelle application Laravel sans base de données conserve ses données dans SQLite (le choix par défaut de Laravel), dans storage/app/database.sqlite sur le disque de l'application. Le fichier survit aux déploiements et fait partie des sauvegardes quotidiennes de l'application : vous pouvez donc lancer d'abord et choisir une base de données plus tard.
Quand vous ajoutez PostgreSQL ou MySQL au projet (Vue d'ensemble → Services → Ajouter un service), l'application bascule dessus au déploiement suivant, et les migrations s'y exécutent. Les données du fichier SQLite ne sont pas reprises : exportez-les d'abord si vous en avez besoin, puis importez-les dans l'onglet Données de la base. Voir Bases de données.
Les migrations comme commande de release
La commande de release recommandée est php artisan migrate --force. Elle s'exécute une fois à chaque déploiement, avant que la nouvelle version ne reçoive les visiteurs ; si une migration échoue, la version actuelle continue de tourner. Vous pouvez la modifier dans l'onglet Processus. Voir Déploiements.
Worker de file d'attente et planificateur
D'emblée, l'onglet Processus fait tourner :
| Quoi | Commande |
|---|---|
| Worker en arrière-plan « queue » | php artisan queue:work --sleep=3 --tries=3 --max-time=3600 |
| Commande planifiée, chaque minute | php artisan schedule:run |
Ils partagent les ressources de l'application et redémarrent à chaque déploiement. Modifiez-les ou supprimez-les dans l'onglet Processus : par exemple, remplacez le worker par php artisan horizon si vous utilisez Horizon avec Valkey.
Pour une file d'attente chargée, faites tourner le worker comme un service worker en arrière-plan distinct, avec ses propres ressources, et retirez-le de Processus. Voir Services d'un projet.
Valkey pour le cache, les sessions et les files d'attente
Ajoutez Valkey au projet : les sessions et le cache y passent d'eux-mêmes (au déploiement suivant ; les visiteurs devront se reconnecter une fois). Pour les files d'attente et tout le reste, définissez les valeurs dans l'onglet Variables, par exemple :
CACHE_STORE=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redisREDIS_HOST, REDIS_PASSWORD, REDIS_PORT et REDIS_CLIENT=phpredis sont définis pour vous.
WebSockets (Laravel Reverb)
Faites tourner Reverb comme service web à partir du code de ce projet, avec la commande php artisan reverb:start --host=0.0.0.0 --port=$PORT. Il reçoit sa propre adresse.
Fichiers et envois des utilisateurs
Les fichiers de storage/app (les disques local et public de Laravel) restent sur le disque de l'application d'un déploiement à l'autre et sont sauvegardés chaque jour. Tout le reste du dossier du projet est repris à neuf depuis le dépôt à chaque déploiement. Pour de nombreux fichiers ou de gros fichiers, utilisez le stockage objet avec le disque s3 de Laravel.