【Laravel vx Docker】利用 Laravel Sail 高效搭建 Laravel 应用开发环境

百变鹏仔 2天前 #PHP

文章标签高效

关于 laravel sail

laravel sail 是 laravel 框架的官方开发环境。 sail 提供了一个轻量级的命令行界面 (cli)，可以使用 docker 轻松设置和管理 laravel 应用程序开发环境。下面，我们讲解一下 laravel sail 的主要特性和使用方法。

使用 laravel sail 的好处

构建独立于操作系统的开发环境
轻松设置开发环境
轻松管理不同版本的项目

当您使用 docker 和 laravel sail 创建项目时，结构将如上图所示。

用法

开发环境

先决条件

在创建 laravel 项目之前，请下载并启动 docker desktop。
https://www.docker.com/products/docker-desktop/

1. 创建 laravel 项目

运行以下命令创建一个新的 laravel 项目并设置 laravel sail。

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

这将创建 laravel 项目文件。生成的 docker-compose.yml 文件中描述了开发环境。

使用 with 查询指定服务

如果要指定php版本或者使用postgresql而不是mysql，可以在生成项目时的命令中指定with=,,...

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

2. 起航

移动到项目目录并启动 sail。

./vendor/bin/sail up -d

此命令启动 docker 容器并运行 laravel 应用程序。

※注册别名

输入 ./vendor/bin/sail 很麻烦，因此请将其保存为 shell 配置文件中的别名 sail。

使用以下命令检查您正在使用的 shell 的路径

echo $shell

示例：/bin/zsh

编辑 shell 配置文件

shell 配置文件是 ~/.zshrc。
要添加别名，请运行以下命令

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

shell 配置文件是 ~/.bash_profile 或 ~/.bashrc。
要添加别名，请运行以下命令：

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

通过上述设置，您可以以缩写形式运行 sail 命令。

sail up -d

3. 使用 sail 命令

您可以使用sail执行各种开发任务。以下是一些示例。

sail up -d

sail down

sail artisan migrate

sail composer install

sail npm install

4. 改变服务

即使在创建项目后，您也可以通过修改 docker-compose.yml 文件（即 docker 配置文件）来更改服务。在这里，我们将更改 php 版本和使用的数据库。

更改 php 版本

首先检查当前php版本

sail php -vphp 8.3.12 (cli) (built: sep 27 2024 03:53:05) (nts)

接下来修改docker-compose.yml文件中描述的开发环境信息。

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

将构建上下文和镜像更改为 8.1 .

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

修改 docker-compose.yml 后，停止应用。

sail down

接下来，重建 docker 容器以反映更改。

sail build --no-cache

重新启动应用程序。

sail up -d

检查php版本是否有变化。

sail php -vphp 8.1.30 (cli) (built: sep 27 2024 04:07:29) (nts)

php 版本已从 php 8.3 更改为 php 8.1。

更改使用的数据库

将使用 mysql 创建的项目更改为 postgresql。

运行 sail 安装命令

sail php artisan sail:install

选择 pgsql

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

检查 docker-compose.yml 文件并确认 pgsql 条目已添加。

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

ext，打开项目目录下的.env文件，确认设置了db_connection=pgsql和db_host=pgsql。
如果没有，请手动更改它们。

db_connection=pgsqldb_host=pgsqldb_port=5432db_database=laraveldb_username=saildb_password=******

确认 docker-compose.yml 和 .env 中的更改后，停止应用程序。

sail down

接下来，重建 docker 容器以反映更改。

sail build --no-cache

重新启动应用程序。

sail up -d

运行迁移文件。

sail artisan migrateinfo  preparing database.creating migration table ................................ 6.00ms doneinfo  running migrations.0001_01_01_000000_create_users_table .................... 5.74ms done0001_01_01_000001_create_cache_table .................... 1.45ms done0001_01_01_000002_create_jobs_table ..................... 3.44ms done

在 docker 中启动 shell 并检查 pgsql

显示当前正在运行的 docker 容器的列表。

sail ps

name                                image                          command                  servicelaravel-sail-setup-laravel.test-1   sail-8.3/app                   "start-container"        laravel.testlaravel-sail-setup-mailpit-1        axllent/mailpit:latest         "/mailpit"               mailpit

检查应用程序的容器名称并在 docker 内启动应用程序的 bash。

docker exec -it laravel-sail-setup-laravel.test-1 bash

连接到 pgsql。

psql -u sail -h pgsql laravel

系统将提示您输入密码，因此请输入 .env 文件中指定的 db_password。

password for user sail:******

检查pgsql中的表

laravel=# dt               List of relations Schema |         Name          | Type  | Owner--------+-----------------------+-------+------- public | cache                 | table | sail public | cache_locks           | table | sail public | failed_jobs           | table | sail public | job_batches           | table | sail public | jobs                  | table | sail public | migrations            | table | sail public | password_reset_tokens | table | sail public | sessions              | table | sail public | users                 | table | sail(9 rows)

这样，即使创建了项目，也可以从 mysql 更改为 postgresql。

结论

通过本文，您将了解如何使用 laravel sail 高效地设置和管理开发环境。通过根据项目的需求选择合适的服务并自定义设置，您可以实现更灵活、更强大的开发环境。

文章推荐

【Laravel vx Docker】利用 Laravel Sail 高效搭建 Laravel 应用开发环境

关于 laravel sail

使用 laravel sail 的好处

用法

1. 创建 laravel 项目

使用 with 查询指定服务

2. 起航

※注册别名

3. 使用 sail 命令

4. 改变服务

更改 php 版本

更改使用的数据库

结论

PHP 函数中如何使用递归来求最小公倍数？

PHP 函数中使用引用的高级技巧和用法

PHP 函数中引用传递与函数调用栈的关系

PHP 函数中引用传递的深浅拷贝问题

PHP 函数中如何使用递归来实现深度优先搜索？