Commencer

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.

3 MIN DE LECTURE

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 php de composer.json (8.3 si rien n'est précisé).
  • Composer : composer install --no-dev --optimize-autoloader.
  • Assets front-end : si package.json contient un script build (Vite), il est exécuté et public/build est 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 utilisent https:// sans que vous ayez à déclarer vous-même les proxys de confiance.

Variables définies pour vous

VariableValeur
APP_KEYgénérée une fois lors du premier déploiement et conservée avec vos variables
APP_ENVproduction
APP_DEBUGfalse
APP_URLl'adresse de l'application
LOG_CHANNELstderr, pour que l'onglet Journaux affiche le journal de Laravel
SESSION_DRIVER, CACHE_STOREredis 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 :

QuoiCommande
Worker en arrière-plan « queue »php artisan queue:work --sleep=3 --tries=3 --max-time=3600
Commande planifiée, chaque minutephp 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=redis

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

Toujours bloqué ?

Écrivez-nous dans le chat — l'AI répond immédiatement et un ingénieur intervient si besoin, à toute heure.

Contacter l'assistance