ü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!