Mengenai Laravel Sail

Laravel Sail ialah persekitaran pembangunan rasmi untuk rangka kerja Laravel. Sail menyediakan antara muka baris perintah (CLI) yang ringan untuk menyediakan dan mengurus persekitaran pembangunan aplikasi Laravel dengan mudah menggunakan Docker. Di bawah, kami menerangkan ciri utama dan penggunaan Laravel Sail.

Faedah Menggunakan Layar Laravel

1. Bina persekitaran pembangunan bebas daripada OS
   • Sail menggunakan Docker untuk menyimpan persekitaran pembangunan untuk aplikasi Laravel. Ini membolehkan anda membina persekitaran pembangunan yang bebas daripada OS.
2. Persediaan mudah bagi persekitaran pembangunan
   • Dengan Sail, anda boleh menyediakan persekitaran pembangunan Laravel dengan hanya beberapa arahan. Malah persekitaran pembangunan yang kompleks menggunakan MySQL, Redis, MailHog, dsb., boleh dibina dengan mudah.
3. Pengurusan projek yang mudah dengan versi berbeza
   • Sebagai contoh, versi Laravel bergantung pada versi PHP, tetapi dengan menetapkan persekitaran untuk setiap projek dalam fail docker-compose.yml, anda boleh menukar versi dengan mudah.

Apabila anda membuat projek menggunakan Docker dengan Laravel Sail, struktur akan kelihatan seperti rajah di atas.

Penggunaan

Persekitaran Pembangunan

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

Prasyarat

Sebelum mencipta projek Laravel, muat turun dan mulakan Desktop Docker.
https://www.docker.com/products/docker-desktop/

1. Mencipta Projek Laravel

Jalankan arahan berikut untuk mencipta projek Laravel baharu dan sediakan Laravel Sail.

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

Ini akan mencipta fail projek Laravel. Persekitaran pembangunan diterangkan dalam fail docker-compose.yml yang dihasilkan.

Nyatakan perkhidmatan dengan pertanyaan dengan

Jika anda ingin menentukan versi PHP atau menggunakan PostgreSQL dan bukannya MySQL, anda boleh menentukan dengan=,,... dalam arahan semasa menjana projek.

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

2. Memulakan Belayar

Alih ke direktori projek dan mulakan Belayar.

./vendor/bin/sail up -d

Arahan ini memulakan bekas Docker dan menjalankan aplikasi Laravel.

※Mendaftar alias

Menyusahkan menaip ./vendor/bin/sail, jadi simpan ia sebagai layar alias dalam fail konfigurasi shell anda.

Semak laluan shell yang anda gunakan dengan arahan berikut

echo $SHELL

Contoh: /bin/zsh

Mengedit fail konfigurasi Shell

• Untuk zsh

Fail konfigurasi Shell ialah ~/.zshrc.
Untuk menambah alias, jalankan arahan berikut

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

• Untuk bash

Fail konfigurasi shell ialah ~/.bash_profile atau ~/.bashrc.
Untuk menambah alias, jalankan arahan berikut:

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

Dengan tetapan di atas, anda boleh menjalankan arahan layar dalam bentuk yang dipendekkan.

./vendor/bin/sail up -d

3. Menggunakan Arahan Layar

Anda boleh menggunakan Sail untuk melaksanakan pelbagai tugas pembangunan. Berikut ialah beberapa contoh.

• Memulakan aplikasi:

echo $SHELL

• Menghentikan aplikasi:

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

• Menjalankan arahan Artisan:

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

• Menjalankan arahan Komposer:

sail up -d

• Menjalankan arahan npm:

sail up -d

4. Menukar Perkhidmatan

Walaupun selepas mencipta projek, anda boleh menukar perkhidmatan dengan mengubah suai fail docker-compose.yml, iaitu fail konfigurasi Docker. Di sini, kami akan menukar versi PHP dan pangkalan data yang digunakan.

Menukar versi PHP

Pertama, semak versi PHP semasa

sail down

Seterusnya, ubah suai maklumat persekitaran pembangunan yang diterangkan dalam fail docker-compose.yml.

sail artisan migrate

Tukar konteks binaan dan imej kepada 8.1 .

sail composer install

Selepas mengubah suai docker-compose.yml, hentikan aplikasi.

sail npm install

Seterusnya, bina semula bekas Docker untuk mencerminkan perubahan.

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

Mulakan semula aplikasi.

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

Semak sama ada versi PHP telah berubah.

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

Versi PHP telah ditukar daripada PHP 8.3 kepada PHP 8.1.

Menukar pangkalan data yang digunakan

Tukar projek yang dibuat dengan MySQL kepada PostgreSQL.

Jalankan arahan pemasangan Sail

sail down

Pilih pgsql

sail build --no-cache

Semak fail docker-compose.yml dan sahkan bahawa entri pgsql telah ditambahkan.

sail up -d

ext, buka fail .env dalam direktori projek dan sahkan bahawa DB_CONNECTION=pgsql dan DB_HOST=pgsql ditetapkan.
Jika tidak, tukar secara manual.

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

Selepas mengesahkan perubahan dalam docker-compose.yml dan .env, hentikan aplikasi.

sail php artisan sail:install

Seterusnya, bina semula bekas Docker untuk mencerminkan perubahan.

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

Mulakan semula aplikasi.

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

Jalankan fail migrasi.

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

Mulakan shell dalam Docker dan semak pgsql

Paparkan senarai bekas Docker yang sedang dijalankan.

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

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

Semak nama bekas aplikasi dan mulakan bash aplikasi di dalam Docker.

./vendor/bin/sail up -d

Sambung ke pgsql.

echo $SHELL

Anda akan digesa untuk mendapatkan kata laluan, jadi masukkan DB_PASSWORD yang dinyatakan dalam fail .env.

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

Semak jadual dalam pgsql

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

Dengan cara ini, anda boleh menukar daripada MySQL kepada PostgreSQL walaupun selepas mencipta projek.

Kesimpulan

Melalui artikel ini, anda akan memahami cara menyediakan dan mengurus persekitaran pembangunan dengan cekap menggunakan Laravel Sail. Dengan memilih perkhidmatan yang sesuai dan menyesuaikan tetapan mengikut keperluan projek, anda boleh mencapai persekitaran pembangunan yang lebih fleksibel dan berkuasa.

Atas ialah kandungan terperinci [Laravel vx Docker] Sediakan Persekitaran Pembangun Apl Laravel dengan Cekap dengan Laravel Sail. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!