【LaravelvxDocker】利用LaravelSail高效搭建Laravel应用开发环境

【LaravelvxDocker】利用LaravelSail高效搭建Laravel应用开发环境
关于 laravel sail

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

使用 laravel sail 的好处

构建独立于操作系统的开发环境sail 使用 docker 来容器化 laravel 应用程序的开发环境。这使您可以构建独立于操作系统的开发环境。轻松设置开发环境使用 sail，只需几条命令即可搭建 laravel 开发环境。即使使用 mysql、redis、mailhog 等复杂的开发环境，也可以轻松构建。轻松管理不同版本的项目例如，laravel 的版本取决于 php 的版本，但通过在 docker-pose.yml 文件中设置每个项目的环境，可以轻松切换版本。

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

用法

开发环境

mac php v8.3 laravel v11 docker

先决条件

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

1. 创建 laravel 项目

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

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

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

使用 with 查询指定服务

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

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

. 起航

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

./vendor/bin/sail up -d

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

※注册别名

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

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

echo $shell

示例：/bin/zsh

编辑 shell 配置文件

对于 zsh

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

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

对于 bash

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

运行 artisan 命令：

sail artisan migrate

运行 poser 命令：

sail poser install

运行 npm 命令：

sail npm install

4. 改变服务

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

更改 php 版本

首先检查当前php版本

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

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

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

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

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

修改 docker-pose.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-pose.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: – sailhealthcheck: 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-pose.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 mandservicelaravel-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中的表

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

结论

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

以上就是【Laravel vx Docker】利用 Laravel Sail 高效搭建 Laravel 应用开发环境的详细内容，更多请关注范的资源库其它相关文章！

转载请注明：范的资源库 » 【LaravelvxDocker】利用LaravelSail高效搭建Laravel应用开发环境