Laravel Sail是官方提供的开箱即用Docker开发环境,支持快速搭建项目并统一团队开发配置。通过curl命令可新建集成Sail的项目,进入目录后运行./vendor/bin/sail up启动容器,访问https://www.php.cn/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.php.cn/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 配置,确保本地代码实时同步到容器。
修改后需重启容器使配置生效:sail down 后再 sail up -d。
数据库连接与开发调试
Sail 默认使用 MySQL,连接信息在 .env 文件中:
可使用 TablePlus、Sequel Pro 或命令行连接容器数据库:
./vendor/bin/sail mysql
运行迁移和填充数据:
./vendor/bin/sail artisan migrate --seed
基本上就这些。Sail 让 Laravel 本地开发变得简单一致,省去环境差异带来的问题,适合大多数中小型项目快速上手。










