Préparez votre application Laravel pour le cloud

Les annonces récentes de Laraconus ont suscité un regain d'intérêt pour les déploiements basés sur le cloud au sein de la communauté Laravel. Alors que le débat se poursuit sur la façon de déployer vos applications, une chose est claire: le cloud devient une option plus viable pour les utilisateurs de Laravel.

Dans cet article, nous explorerons comment préparer votre application Laravel pour le déploiement dans un environnement cloud en utilisant FrankenPhp, Caddy, Dockerfiles et enfin le déploier sur Sevalla.

Alors, par où commencer? Dans l'environnement local bien sûr! ?

#Local Development Environment

Pour la simplicité, nous supposerons que vous avez une nouvelle application Laravel installée sur votre machine locale, qui se connecte à une base de données PostgreSQL pour lire / écrire des données.

Avant de passer à autre chose, assurez-vous d'avoir un fichier .env dans la racine de votre projet avec le contenu suivant:

.env:

<!-- Syntax highlighted by torchlight.dev -->...
DB_CONNECTION=pgsql
...

Une fois que cela est vérifié, nous pouvons commencer à construire. ? ☕️

C'est toujours une bonne idée d'avoir un environnement de développement local qui ressemble étroitement à votre environnement de production. De cette façon, vous pouvez assumer les problèmes dès le début et éviter les surprises lorsque vous déploiez votre application en production.

Pour imiter la configuration de production, nous allons utiliser Docker et Docker Compose. Si Docker n'est pas installé sur votre machine, vous pouvez le télécharger à partir du site officiel.

#Running Laravel sans la base de données

Tout d'abord, créez un nouveau fichier appelé compose.yml à la racine de votre projet Laravel et ajoutez le contenu suivant:

compose.yml:

<!-- Syntax highlighted by torchlight.dev -->services:
  php:
    image: dunglas/frankenphp:php8.3-bookworm
    environment:
      SERVER_NAME: ":8080"
    ports:
      - 8080:8080
    volumes:
      - .:/app

Ce fichier de configuration définit un service appelé php qui utilise l'image dunglas/frankenphp:php8.3-bookworm, qui est une image FrankenPHP qui inclut les extensions nécessaires pour exécuter une application Laravel. La variable d'environnement SERVER_NAME configure Caddy pour écouter sur le port 8080. Nous exposons également le port 8080 pour accéder à l'application à partir de la machine hôte.

Pour tester votre configuration, essayez d'exécuter la commande suivante dans votre terminal:

<!-- Syntax highlighted by torchlight.dev -->docker compose up [-d]

Vous devriez voir une page d'erreur Laravel expliquant que la connexion n'a pas été établie dans la base de données en raison d'un pilote manquant lorsque vous accédez à http://localhost:8080 dans votre navigateur. Ceci est attendu car nous n'avons pas encore connecté notre application Laravel à une base de données.

génial, jusqu'à présent, nous avons configuré notre application Laravel à servir par un serveur FrankenPhp.

Ensuite, connectons notre application locale avec une base de données PostgreSQL!

#Running Laravel avec la base de données

Pour connecter votre application Laravel à une base de données PostgreSQL, nous devons faire quelques choses.

Tout d'abord, nous devons définir les variables d'environnement suivantes dans votre fichier .env:

.env:

<!-- Syntax highlighted by torchlight.dev -->...
DB_CONNECTION=pgsql
...

Suite à cela, vous devrez ajouter de nouveaux services à votre fichier compose.yml et créer un Dockerfile personnalisé pour votre environnement de développement. Créez et mettez à jour les fichiers avec le contenu suivant:

Dockerfile.dev:

<!-- Syntax highlighted by torchlight.dev -->services:
  php:
    image: dunglas/frankenphp:php8.3-bookworm
    environment:
      SERVER_NAME: ":8080"
    ports:
      - 8080:8080
    volumes:
      - .:/app

Dockerfile.dev est censé être utilisé par votre environnement local / de développement, et il étend l'image dunglas/frankenphp:php8.3-bookworm pour inclure l'extension pdo_pgsql, qui est nécessaire pour se connecter à une base de données postgresql.

compose.yml:

<!-- Syntax highlighted by torchlight.dev -->docker compose up [-d]

Il se passe beaucoup de choses ici, jetons un coup d'œil à ce qui a changé et pourquoi:

1. Nous avons mis à jour le service php pour utiliser un dockerfile personnalisé appelé Dockerfile.dev pour créer une nouvelle image qui inclut les extensions nécessaires pour se connecter à une base de données postgresql.
2. Nous avons ajouté un nouveau service appelé db qui utilise l'image postgres:16.4-alpine pour exécuter une base de données PostgreSQL. Nous avons également défini certaines variables d'environnement pour configurer l'utilisateur de la base de données, le mot de passe et le nom de la base de données.
3. Nous avons créé un nouveau volume appelé db_data pour persister les données de la base de données sur votre machine, et Docker pourrait le réutiliser lorsque vous redémarrez les services.
4. Un nouveau service appelé init a également été ajouté qui réutilise Dockerfile.dev. Cette image est utilisée pour exécuter la commande php artisan migrate pour exécuter vos migrations de base de données. La clé depends_on garantit que le service db est opérationnel avant l'exécution des migrations.
5. Le service php dépend désormais du service init pour s'assurer que les migrations de la base de données sont exécutées avant le début de l'application Laravel.
6. Nous avons ajouté un contrôle de santé au service db pour nous assurer que la base de données PostgreSQL est opérationnelle avant le service init exécute les migrations.

Pour tester votre configuration, exécutez la commande suivante dans votre terminal:

<!-- Syntax highlighted by torchlight.dev -->...
DB_CONNECTION=pgsql
DB_HOST=db
DB_PORT=5432 # default PostgreSQL port
DB_DATABASE=main
DB_USERNAME=admin
DB_PASSWORD=password

Votre application devrait désormais se connecter à votre base de données PostgreSQL, et vos migrations de base de données sont toujours exécutées. ?

Votre environ local est maintenant prêt à imiter votre environnement de production. Vous pouvez désormais développer votre application localement et tester une configuration vraiment similaire que vous utilisez dans la production.

#préparisation pour la production

Il est temps d'apporter les modifications nécessaires à votre environnement de production.

La première étape consiste à dire à Docker quels répertoires il peut ignorer en toute sécurité lors de la construction de l'image de production. Créez un nouveau fichier appelé .dockerignore dans la racine de votre projet Laravel et ajoutez le contenu suivant:

.dockerignore:

<!-- Syntax highlighted by torchlight.dev -->FROM dunglas/frankenphp:php8.3-bookworm

RUN install-php-extensions pdo_pgsql

Ce fichier dit à Docker d'ignorer les répertoires vendor, bootstrap/cache et tests.

Ensuite, créez un Dockerfile qui sera utilisé pour construire votre image de production:

Dockerfile:

<!-- Syntax highlighted by torchlight.dev -->...
DB_CONNECTION=pgsql
...

Ce Dockerfile est similaire à la Dockerfile.dev que nous avons créée plus tôt, mais il comprend quelques étapes supplémentaires:

1. Comme l'image FrankenPHP utilise Caddy comme serveur Web par défaut, nous avons défini la variable d'environnement SERVER_NAME pour :8080 pour demander à Caddy d'écouter sur le port 8080.
2. Nous installons l'extension @composer PHP pour installer le compositeur dans l'image.
3. composer install La commande est exécutée pour installer les dépendances de votre application Laravel.
4. Nous avons défini le répertoire de travail sur /app et copié le contenu de votre application Laravel sur l'image.

Pour tester vos modifications dans votre environnement local, vous devrez produire une génération de production de votre application. Exécutez la commande suivante dans votre terminal:

<!-- Syntax highlighted by torchlight.dev -->services:
  php:
    image: dunglas/frankenphp:php8.3-bookworm
    environment:
      SERVER_NAME: ":8080"
    ports:
      - 8080:8080
    volumes:
      - .:/app

Cette commande construit une nouvelle image docker appelée my-laravel-app basée sur le Dockerfile dans le répertoire actuel.

Pour tester votre image de production nouvellement construite, utilisez la commande suivante:

<!-- Syntax highlighted by torchlight.dev -->docker compose up [-d]

Remplacer <your-app-key> par la valeur de la variable d'environnement APP_KEY dans votre fichier .env ou saisissez une clé d'ici.

Visitez LocalHost: 8080 dans votre navigateur, et votre application devrait commencer en mode de production. Il peut errer en raison de l'absence d'une connexion de base de données, mais c'est attendu.

#deploying vers le cloud

Maintenant que vous avez une image Docker prête pour la production, vous pouvez le déployer sur un fournisseur de cloud. ?

Dans ce tutoriel, nous utiliserons Sevalla, un nouveau fournisseur de cloud qui offre un moyen simple de déployer des déploiements basés sur Dockerfile.

Comme votre application dépend d'une base de données PostgreSQL, vous feriez mieux de provisionner une nouvelle base de données PostgreSQL sur Sevalla. Une fois que vous êtes connecté dans le tableau de bord Sevalla,

1. Accédez à la base de données Create Database Modal
2. Sélectionnez la base de données PostgreSQL
3. confirmer les paramètres et créer la base de données

Une fois votre base de données prête, vous pouvez créer votre application Laravel sur Sevalla.

1. Accédez à la création d'applications modal
2. Sélectionnez le référentiel de votre application dans votre fournisseur GIT préféré
3. Assurez-vous de sélectionner le même centre de données dans votre base de données dans
4. Définissez la variable d'environnement APP_KEY requise par Laravel
5. sélectionnez Dockerfile comme type de construction
6. Confirmez le reste des paramètres et appuyez sur le bouton "Déployer plus tard"

Si votre application est prête, vous pouvez désormais la connecter avec votre base de données PostgreSQL.

1. Accédez à la page de l'application
2. Accédez à l'onglet "réseau"
3. Cliquez sur le bouton "Ajouter une connexion" et sélectionnez votre base de données PostgreSQL
4. Confirmez les paramètres et appuyez sur "connecter"

Ensuite, définissez les variables d'environnement suivantes dans l'onglet "Variables d'environnement" avec les détails de la connexion de votre base de données:

• DB_CONNECTION
• DB_HOST
• DB_PORT
• DB_DATABASE
• DB_USERNAME
• DB_PASSWORD

Nous avons recommandé d'utiliser l'adresse réseau interne de votre base de données comme valeur DB_HOST. De cette façon, votre application peut se connecter à la base de données sur un réseau privé.

La dernière étape consiste à configurer un processus de travail pour que votre application exécute les mirgations de la base de données avant de démarrer l'application.

1. Accédez à l'onglet "Processus"
2. Cliquez sur le bouton "Créer le processus" et sélectionnez "Job"
3. Définissez la commande sur php artisan migrate --force
4. Définissez la stratégie de démarrage sur "avant le déploiement"
5. Confirmez les paramètres et appuyez sur "Create"

Si cela est également fait, vous pouvez désormais lancer un déploiement manuel de votre application dans l'onglet Déploiements. ?

Si tout s'est bien passé, félicitations! Vous avez réussi à préparer votre application Laravel pour le cloud. ?

#conclusion

Dans cet article, nous avons exploré:

• Comment configurer votre environnement local pour imiter votre environnement de production à l'aide de Docker et docker compose.
• Comment préparer votre application Laravel pour le déploiement dans un environnement cloud à l'aide de Docker, FrankenPhp et Caddy.
• Nous avons également couvert comment déployer votre application sur un fournisseur de cloud comme Sevalla.

En suivant ces étapes, vous pouvez amener votre application Laravel à de nouveaux sommets et profiter des avantages des déploiements basés sur le cloud. ?

#Update: 8 septembre 2024

Nous avons reçu des commentaires précieux de la communauté grâce à une discussion sur X.

Le premier point a mis en évidence que l'inclusion de la commande php artisan serve dans le fichier compose.yml n'était pas nécessaire, car il a contourné le serveur FrankenPhp. Nous avons corrigé cela en mettant à jour les sections pertinentes du fichier compose.yml.

Le deuxième point, partagé par Kévin Dunglas (créateur de FrankenPhp), a recommandé d'utiliser une image basée à Debian (bookworm) au lieu d'Alpine (alpine), car Debian offre une meilleure compatibilité avec PHP et de meilleures performances avec FrankenPhp. En conséquence, nous avons mis à jour les fichiers Dockerfile.dev et Dockerfile.

Nous sommes reconnaissants du soutien et des commentaires de la communauté. ? ❤️

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!