[Laravel vx Docker] Configurer efficacement un environnement de développement d'applications Laravel avec Laravel Sail-tutoriel php-php.cn

À propos de Laravel Sail

Laravel Sail est l'environnement de développement officiel du framework Laravel. Sail fournit une interface de ligne de commande (CLI) légère pour configurer et gérer facilement un environnement de développement d'applications Laravel à l'aide de Docker. Ci-dessous, nous expliquons les principales fonctionnalités et l'utilisation de Laravel Sail.

Avantages de l'utilisation de Laravel Sail

Construire un environnement de développement indépendant du système d'exploitation
- Sail utilise Docker pour conteneuriser l'environnement de développement des applications Laravel. Cela vous permet de créer un environnement de développement indépendant du système d'exploitation.
Configuration facile de l'environnement de développement
- Avec Sail, vous pouvez configurer un environnement de développement Laravel avec seulement quelques commandes. Même des environnements de développement complexes utilisant MySQL, Redis, MailHog, etc. peuvent être facilement créés.
Gestion facile des projets avec différentes versions
- Par exemple, la version de Laravel dépend de la version de PHP, mais en définissant l'environnement pour chaque projet dans le fichier docker-compose.yml, vous pouvez facilement changer de version.

[Laravel vx Docker] Efficiently Set Up a Laravel App Dev Environment with Laravel Sail
Lorsque vous créez un projet à l'aide de Docker avec Laravel Sail, la structure ressemblera au schéma ci-dessus.

Usage

Environnement de développement

Mac
PHP v8.3
Laravel v11
Docker

Prérequis

Avant de créer un projet Laravel, téléchargez et démarrez Docker Desktop.
https://www.docker.com/products/docker-desktop/

1. Création d'un projet Laravel

Exécutez la commande suivante pour créer un nouveau projet Laravel et configurer Laravel Sail.

curl -s "https://laravel.build/example-app" | bash
cd example-app

Copier après la connexion

Cela créera les fichiers du projet Laravel. L'environnement de développement est décrit dans le fichier docker-compose.yml généré.

Spécifier les services avec la requête with

Si vous souhaitez spécifier la version de PHP ou utiliser PostgreSQL au lieu de MySQL, vous pouvez spécifier with=,,... dans la commande lors de la génération du projet.

curl -s "https://laravel.build/example-app?php=81&with=pgsql,redis" | bash

Copier après la connexion

2. Départ de la voile

Allez dans le répertoire du projet et démarrez Sail.

./vendor/bin/sail up -d

Copier après la connexion

Cette commande démarre les conteneurs Docker et exécute l'application Laravel.

※Enregistrement d'un pseudonyme

Taper ./vendor/bin/sail peut s'avérer fastidieux, alors enregistrez-le sous un alias Sail dans le fichier de configuration de votre shell.

Vérifiez le chemin du shell que vous utilisez avec la commande suivante

echo $SHELL

Copier après la connexion

Exemple : /bin/zsh

Modification du fichier de configuration Shell

Pour zsh

Le fichier de configuration Shell est ~/.zshrc.
Pour ajouter un alias, exécutez la commande suivante

curl -s "https://laravel.build/example-app" | bash
cd example-app

Copier après la connexion

Pour la fête

Le fichier de configuration du shell est ~/.bash_profile ou ~/.bashrc.
Pour ajouter un alias, exécutez la commande suivante :

curl -s "https://laravel.build/example-app?php=81&with=pgsql,redis" | bash

Copier après la connexion

Avec les paramètres ci-dessus, vous pouvez exécuter la commande sail sous une forme raccourcie.

./vendor/bin/sail up -d

Copier après la connexion

3. Utilisation des commandes de voile

Vous pouvez utiliser Sail pour effectuer diverses tâches de développement. Voici quelques exemples.

Démarrage de l'application :

echo $SHELL

Copier après la connexion

Arrêt de l'application :

echo "alias sail='sh $([ -f sail ] && echo sail || echo vendor/bin/sail)'" >> ~/.zshrc
source ~/.zshrc

Copier après la connexion

Exécuter les commandes Artisan :

echo "alias sail='sh $([ -f sail ] && echo sail || echo vendor/bin/sail)'" >> ~/.bash_profile
source ~/.bash_profile

Copier après la connexion

Exécuter les commandes Composer :

sail up -d

Copier après la connexion

Exécution des commandes npm :

sail up -d

Copier après la connexion

4. Modification des services

Même après avoir créé le projet, vous pouvez changer les services en modifiant le fichier docker-compose.yml, qui est le fichier de configuration Docker. Ici, nous allons changer la version PHP et la base de données utilisée.

Changer la version de PHP

Tout d'abord, vérifiez la version actuelle de PHP

sail down

Copier après la connexion

Ensuite, modifiez les informations sur l'environnement de développement décrites dans le fichier docker-compose.yml.

sail artisan migrate

Copier après la connexion

Changez le contexte et l'image de build en 8.1.

sail composer install

Copier après la connexion

Après avoir modifié docker-compose.yml, arrêtez l'application.

sail npm install

Copier après la connexion

Ensuite, reconstruisez les conteneurs Docker pour refléter les modifications.

sail php -v
PHP 8.3.12 (cli) (built: Sep 27 2024 03:53:05) (NTS)

Copier après la connexion

Redémarrez l'application.

services:
    laravel.test:
        build:
            context: "./vendor/laravel/sail/runtimes/8.3"
            dockerfile: Dockerfile
            args:
                WWWGROUP: "${WWWGROUP}"
        image: "sail-8.3/app"

Copier après la connexion

Vérifiez si la version de PHP a changé.

services:
    laravel.test:
        build:
            context: "./vendor/laravel/sail/runtimes/8.1"
            dockerfile: Dockerfile
            args:
                WWWGROUP: "${WWWGROUP}"
        image: "sail-8.1/app"

Copier après la connexion

La version PHP est passée de PHP 8.3 à PHP 8.1.

Changer la base de données utilisée

Changer un projet créé avec MySQL en PostgreSQL.

Exécutez la commande d'installation de Sail

sail down

Copier après la connexion

Sélectionnez pgsql

sail build --no-cache

Copier après la connexion

Vérifiez le fichier docker-compose.yml et confirmez que les entrées pgsql ont été ajoutées.

sail up -d

Copier après la connexion

ext, ouvrez le fichier .env dans le répertoire du projet et confirmez que DB_CONNECTION=pgsql et DB_HOST=pgsql sont définis.
Sinon, modifiez-les manuellement.

sail php -v
PHP 8.1.30 (cli) (built: Sep 27 2024 04:07:29) (NTS)

Copier après la connexion

Après avoir confirmé les modifications dans docker-compose.yml et .env, arrêtez l'application.

sail php artisan sail:install

Copier après la connexion

Ensuite, reconstruisez les conteneurs Docker pour refléter les modifications.

 ┌ Which services would you like to install? ───────────────────┐
 │   ◼ mysql                                                  ┃ │
 │ › ◻ pgsql                                                  │ │
 │   ◻ mariadb                                                │ │
 │   ◻ redis                                                  │ │
 │   ◻ memcached                                              │ │
 └────────────────────────────────────────────────── 1 selected ┘
  Use the space bar to select options.

Copier après la connexion

Redémarrez l'application.

services:
    laravel.test:
...
        depends_on:
            - mysql
            - redis
            - meilisearch
            - mailpit
            - selenium
            - pgsql
...
        pgsql:
            image: 'postgres:17'
            ports:
                - '${FORWARD_DB_PORT:-5432}:5432'
            environment:
                PGPASSWORD: '${DB_PASSWORD:-secret}'
                POSTGRES_DB: '${DB_DATABASE}'
                POSTGRES_USER: '${DB_USERNAME}'
                POSTGRES_PASSWORD: '${DB_PASSWORD:-secret}'
            volumes:
                - 'sail-pgsql:/var/lib/postgresql/data'
                - './vendor/laravel/sail/database/pgsql/create-testing-database.sql:/docker-entrypoint-initdb.d/10-create-testing-database.sql'
            networks:
                - sail
            healthcheck:
                test:
                    - CMD
                    - pg_isready
                    - '-q'
                    - '-d'
                    - '${DB_DATABASE}'
                    - '-U'
                    - '${DB_USERNAME}'
                retries: 3
                timeout: 5s

Copier après la connexion

Exécutez les fichiers de migration.

DB_CONNECTION=pgsql
DB_HOST=pgsql
DB_PORT=5432
DB_DATABASE=laravel
DB_USERNAME=sail
DB_PASSWORD=******

Copier après la connexion

Démarrez un shell dans Docker et vérifiez pgsql

Affichez la liste des conteneurs Docker en cours d'exécution.

curl -s "https://laravel.build/example-app" | bash
cd example-app

Copier après la connexion

curl -s "https://laravel.build/example-app?php=81&with=pgsql,redis" | bash

Copier après la connexion

Vérifiez le nom du conteneur de l'application et démarrez le bash de l'application dans Docker.

./vendor/bin/sail up -d

Copier après la connexion

Connectez-vous à pgsql.

echo $SHELL

Copier après la connexion

Un mot de passe vous sera demandé, alors entrez le DB_PASSWORD spécifié dans le fichier .env.

echo "alias sail='sh $([ -f sail ] && echo sail || echo vendor/bin/sail)'" >> ~/.zshrc
source ~/.zshrc

Copier après la connexion

Vérifiez les tables dans pgsql

echo "alias sail='sh $([ -f sail ] && echo sail || echo vendor/bin/sail)'" >> ~/.bash_profile
source ~/.bash_profile

Copier après la connexion

De cette façon, vous pouvez passer de MySQL à PostgreSQL même après avoir créé le projet.

Conclusion

Grâce à cet article, vous comprendrez comment configurer et gérer efficacement un environnement de développement à l'aide de Laravel Sail. En sélectionnant les services appropriés et en personnalisant les paramètres en fonction des exigences du projet, vous pouvez obtenir un environnement de développement plus flexible et plus puissant.

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!