本文介绍 laravel 官方推荐的基于 docker 的零配置本地开发方案，通过一行命令即可拉起包含 nginx、php、mysql、redis 等完整栈的容器化环境，并自动安装 laravel 项目，无需手动编写 dockerfile 或管理容器依赖。
本文介绍 laravel 官方推荐的基于 docker 的零配置本地开发方案，通过一行命令即可拉起包含 nginx、php、mysql、redis 等完整栈的容器化环境，并自动安装 laravel 项目，无需手动编写 dockerfile 或管理容器依赖。
Laravel 自 9.x 版本起正式推出 Laravel Sail —— 一个为 Laravel 应用量身定制的轻量级 Docker 开发环境封装工具。它并非要求你从零构建镜像或手写复杂 docker-compose.yml，而是提供开箱即用的一键式体验：运行一条命令，即可启动预配置好的多容器开发环境（含 PHP 8.2+、Nginx、MySQL 8、Redis、MailHog、Meilisearch 等），并自动完成 Laravel 项目的初始化。
✅ 快速开始（以 macOS/Linux 为例）：
只需执行以下命令（确保已安装 Docker Desktop 和 Docker CLI）：
curl -s "https://laravel.build/example-app" | bash cd example-app ./vendor/bin/sail up -d
该脚本会自动：
- 创建项目目录 example-app；
- 下载 Laravel 源码并安装 Composer 依赖；
- 生成预优化的 docker-compose.yml（位于 docker/ 目录下，可按需定制）；
- 启动所有服务容器（默认后台运行）。
启动成功后，访问 https://www.php.cn/link/bb122c8fe6c764e8aae555e2186a6344 即可看到 Laravel 欢迎页。数据库连接、环境变量、文件权限等均已预设妥当，.env 文件中 DB_CONNECTION=mysql、REDIS_HOST=redis 等配置开箱可用。
⚠️ 注意事项：
- Windows 用户需使用 WSL2 + Docker Desktop，并确保 wsl --update 已执行；
- 首次运行会拉取 laravelsail/php82-composer 等官方基础镜像（约 300–500MB），建议保持网络畅通；
- sail 命令本质是 docker-compose 的便捷封装，所有操作均可通过 ./vendor/bin/sail [command] 执行，例如：
./vendor/bin/sail artisan migrate:fresh # 运行迁移 ./vendor/bin/sail phpunit # 运行测试 ./vendor/bin/sail shell # 进入 PHP 容器终端
? 小结：你无需“先选工具再装 Laravel”，Laravel Sail 反其道而行之——它把整套推荐技术栈打包成可执行契约。你所要做的，只是信任官方约定，用脚本交付环境，专注写代码本身。后续如需深度定制（如切换 PostgreSQL、添加 Selenium），可编辑 docker-compose.yml 或参考 Laravel 文档的 Sail 进阶章节。
