[Laravel vx Docker] Richten Sie mit Laravel Sail effizient eine Laravel-App-Entwicklungsumgebung ein

Über Laravel Sail

Laravel Sail ist die offizielle Entwicklungsumgebung für das Laravel-Framework. Sail bietet eine einfache Befehlszeilenschnittstelle (CLI) zum einfachen Einrichten und Verwalten einer Laravel-Anwendungsentwicklungsumgebung mit Docker. Im Folgenden erklären wir die Hauptfunktionen und die Verwendung von Laravel Sail.

Vorteile der Verwendung von Laravel Sail

1. Erstellen Sie eine vom Betriebssystem unabhängige Entwicklungsumgebung
   • Sail verwendet Docker, um die Entwicklungsumgebung für Laravel-Anwendungen zu containerisieren. Dadurch können Sie eine Entwicklungsumgebung erstellen, die unabhängig vom Betriebssystem ist.
2. Einfache Einrichtung der Entwicklungsumgebung
   • Mit Sail können Sie mit nur wenigen Befehlen eine Laravel-Entwicklungsumgebung einrichten. Selbst komplexe Entwicklungsumgebungen mit MySQL, Redis, MailHog usw. können problemlos erstellt werden.
3. Einfache Verwaltung von Projekten mit unterschiedlichen Versionen
   • Zum Beispiel hängt die Version von Laravel von der Version von PHP ab, aber indem Sie die Umgebung für jedes Projekt in der Datei docker-compose.yml festlegen, können Sie problemlos die Version wechseln.

Wenn Sie ein Projekt mit Docker und Laravel Sail erstellen, sieht die Struktur wie im Diagramm oben aus.

Verwendung

Entwicklungsumgebung

• Mac
• PHP v8.3
• Laravel v11
• Docker

Voraussetzungen

Bevor Sie ein Laravel-Projekt erstellen, laden Sie Docker Desktop herunter und starten Sie es.
https://www.docker.com/products/docker-desktop/

1. Erstellen eines Laravel-Projekts

Führen Sie den folgenden Befehl aus, um ein neues Laravel-Projekt zu erstellen und Laravel Sail einzurichten.

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

Dadurch werden die Laravel-Projektdateien erstellt. Die Entwicklungsumgebung ist in der generierten Datei docker-compose.yml beschrieben.

Geben Sie Dienste mit der with-Abfrage an

Wenn Sie die PHP-Version angeben oder PostgreSQL anstelle von MySQL verwenden möchten, können Sie beim Generieren des Projekts with=,,... im Befehl angeben.

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

2. Segel starten

Gehen Sie in das Projektverzeichnis und starten Sie Sail.

./vendor/bin/sail up -d

Dieser Befehl startet die Docker-Container und führt die Laravel-Anwendung aus.

※Registrieren eines Alias

Die Eingabe von ./vendor/bin/sail kann umständlich sein. Speichern Sie es daher als Alias-Segel in der Konfigurationsdatei Ihrer Shell.

Überprüfen Sie den Pfad der von Ihnen verwendeten Shell mit dem folgenden Befehl

echo $SHELL

Beispiel: /bin/zsh

Bearbeiten der Shell-Konfigurationsdatei

• Für zsh

Die Shell-Konfigurationsdatei ist ~/.zshrc.
Um einen Alias ​​hinzuzufügen, führen Sie den folgenden Befehl aus

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

• Für Bash

Die Shell-Konfigurationsdatei ist ~/.bash_profile oder ~/.bashrc.
Um einen Alias ​​hinzuzufügen, führen Sie den folgenden Befehl aus:

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

Mit den oben genannten Einstellungen können Sie den Segelbefehl in verkürzter Form ausführen.

./vendor/bin/sail up -d

3. Segelbefehle verwenden

Mit Sail können Sie verschiedene Entwicklungsaufgaben ausführen. Hier sind einige Beispiele.

• Anwendung starten:

echo $SHELL

• Anwendung stoppen:

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

• Artisan-Befehle ausführen:

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

• Composer-Befehle ausführen:

sail up -d

• Npm-Befehle ausführen:

sail up -d

4. Änderung der Dienste

Auch nach der Erstellung des Projekts können Sie die Dienste ändern, indem Sie die Datei docker-compose.yml, die Docker-Konfigurationsdatei, ändern. Hier werden wir die PHP-Version und die verwendete Datenbank ändern.

Ändern der PHP-Version

Überprüfen Sie zunächst die aktuelle PHP-Version

sail down

Ändern Sie als Nächstes die in der Datei docker-compose.yml beschriebenen Entwicklungsumgebungsinformationen.

sail artisan migrate

Build-Kontext und Image auf 8.1 ändern.

sail composer install

Nachdem Sie docker-compose.yml geändert haben, stoppen Sie die Anwendung.

sail npm install

Als nächstes erstellen Sie die Docker-Container neu, um die Änderungen widerzuspiegeln.

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

Starten Sie die Anwendung neu.

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

Überprüfen Sie, ob sich die PHP-Version geändert hat.

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

Die PHP-Version wurde von PHP 8.3 auf PHP 8.1 geändert.

Ändern der verwendeten Datenbank

Ändern Sie ein mit MySQL erstelltes Projekt in PostgreSQL.

Führen Sie den Sail-Installationsbefehl aus

sail down

Wählen Sie pgsql

sail build --no-cache

Überprüfen Sie die Datei docker-compose.yml und bestätigen Sie, dass die pgsql-Einträge hinzugefügt wurden.

sail up -d

ext, öffnen Sie die .env-Datei im Projektverzeichnis und bestätigen Sie, dass DB_CONNECTION=pgsql und DB_HOST=pgsql festgelegt sind.
Wenn nicht, ändern Sie sie manuell.

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

Nachdem Sie die Änderungen in docker-compose.yml und .env bestätigt haben, stoppen Sie die Anwendung.

sail php artisan sail:install

Als nächstes erstellen Sie die Docker-Container neu, um die Änderungen widerzuspiegeln.

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

Starten Sie die Anwendung neu.

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

Führen Sie die Migrationsdateien aus.

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

Starten Sie eine Shell in Docker und überprüfen Sie pgsql

Zeigen Sie die Liste der aktuell ausgeführten Docker-Container an.

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

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

Überprüfen Sie den Containernamen der Anwendung und starten Sie die Bash der Anwendung in Docker.

./vendor/bin/sail up -d

Mit pgsql verbinden.

echo $SHELL

Sie werden zur Eingabe eines Passworts aufgefordert. Geben Sie daher das in der .env-Datei angegebene DB_PASSWORD ein.

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

Überprüfen Sie die Tabellen in pgsql

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

Auf diese Weise können Sie auch nach der Erstellung des Projekts von MySQL zu PostgreSQL wechseln.

Abschluss

In diesem Artikel erfahren Sie, wie Sie mit Laravel Sail eine Entwicklungsumgebung effizient einrichten und verwalten. Durch die Auswahl geeigneter Dienste und die Anpassung der Einstellungen entsprechend den Projektanforderungen können Sie eine flexiblere und leistungsfähigere Entwicklungsumgebung erreichen.

Das obige ist der detaillierte Inhalt von[Laravel vx Docker] Richten Sie mit Laravel Sail effizient eine Laravel-App-Entwicklungsumgebung ein. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!