最新资讯News

Laravel如何使用Laravel Sail进行本地开发_Laravel Sail容器化开发环境配置

作者：裘德小鎮的故事 | 点击: | 来源：裘德小鎮的故事

0601
2026

LaravelSail是官方提供的开箱即用Docker开发环境，支持快速搭建项目并统一团队开发配置。通过curl命令可新建集成Sail的项目，进入目录后运行./vendor/bin/sailup启动容器，访问http://localhost即可查看应用。常用命令包括后台启动（up-d）、执行Artisan命令、运行Composer依赖安装、进入PHP容器（shell）及停止服务（down）。环境配置由docker-compose.yml和.env文件控制，可自定义数据库端口（如FORWARD_D...

Laravel Sail是官方提供的开箱即用Docker开发环境，支持快速搭建项目并统一团队开发配置。通过curl命令可新建集成Sail的项目，进入目录后运行./vendor/bin/sail up启动容器，访问https://www./link/bb122c8fe6c764e8aae555e2186a6344即可查看应用。常用命令包括后台启动（up -d）、执行Artisan命令、运行Composer依赖安装、进入PHP容器（shell）及停止服务（down）。环境配置由docker-compose.yml和.env文件控制，可自定义数据库端口（如FORWARD_DB_PORT=3307）、添加Redis服务、挂载目录实现代码同步。数据库默认使用MySQL，连接信息在.env中定义，可通过GUI工具或sail mysql命令行连接，支持运行迁移与数据填充（migrate --seed）。修改配置后需重启容器生效。Sail简化了本地开发流程，避免环境不一致问题，适用于中小型项目快速启动。

Laravel Sail 是 Laravel 官方提供的轻量级 Docker 开发环境，开箱即用，无需手动配置 Nginx、PHP、MySQL 等服务。通过简单的命令即可启动完整的本地开发容器环境，特别适合快速搭建项目和团队统一开发环境。

启用 Laravel Sail

创建新的 Laravel 项目时，默认已集成 Sail（Laravel 8+）：

新建项目并启用 Sail：
curl -s "https://laravel.build/example-app" | bash
进入项目目录：
cd example-app
启动容器：
./vendor/bin/sail up

首次运行会自动构建镜像并启动容器，访问 https://www./link/bb122c8fe6c764e8aae555e2186a6344 即可看到 Laravel 欢迎页。

常用 Sail 命令

Sail 提供了简洁的 CLI 接口来管理容器中的服务：

后台运行容器：
./vendor/bin/sail up -d
执行 Artisan 命令：
./vendor/bin/sail artisan migrate
运行 Composer：
./vendor/bin/sail composer require laravel/sanctum
进入 PHP 容器终端：
./vendor/bin/sail shell 或 sail php
停止容器：
./vendor/bin/sail down

自定义 Sail 环境配置

Sail 的配置主要通过 docker-compose.yml 和 .env 文件控制。

修改数据库端口：
在 .env 中设置：
FORWARD_DB_PORT=3307
这样主机可通过 3307 访问容器 MySQL。
添加 Redis 支持：
修改 docker-compose.yml，在 services 下加入 redis 服务，并确保应用连接到 redis 主机名。
挂载额外目录：
检查 docker-compose.yml 中的 volumes 配置，确保本地代码实时同步到容器。