à 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

1. 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.
2. 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.
3. 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.

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

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

2. Départ de la voile

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

./vendor/bin/sail up -d

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

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

• 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

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

./vendor/bin/sail up -d

3. Utilisation des commandes de voile

Vous pouvez utiliser Sail pour effectuer diverses taches de développement. Voici quelques exemples.

• Démarrage de l'application?:

echo $SHELL

• Arrêt de l'application?:

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

• Exécuter les commandes Artisan?:

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

• Exécuter les commandes Composer?:

sail up -d

• Exécution des commandes npm?:

sail up -d

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

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

sail artisan migrate

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

sail composer install

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

sail npm install

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)

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"

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"

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

Sélectionnez pgsql

sail build --no-cache

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

sail up -d

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)

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

sail php artisan sail:install

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.

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

Exécutez les fichiers de migration.

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

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

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

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

./vendor/bin/sail up -d

Connectez-vous à pgsql.

echo $SHELL

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

Vérifiez les tables dans pgsql

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

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

Conclusion

Grace à 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!