本文详解如何利用 laravel 官方提供的 docker 快速启动脚本（laravel.build）一键构建本地开发环境，无需手动编写 dockerfile 或预先配置容器，5 分钟内即可运行 laravel 应用。
本文详解如何利用 laravel 官方提供的 docker 快速启动脚本（laravel.build）一键构建本地开发环境，无需手动编写 dockerfile 或预先配置容器，5 分钟内即可运行 laravel 应用。
Laravel 自 9.x 版本起深度整合 Docker 开发体验，官方推出了极简的自动化安装方案——laravel.build 脚本。该方案并非要求你先“手写 Dockerfile”或“启动空白容器”，而是通过一条命令，自动拉取预配置的、开箱即用的 Docker Compose 环境（含 Nginx、PHP 8.2+、MySQL、Redis、MailHog 等），并完成 Laravel 项目的初始化安装。
✅ 正确操作流程如下（以 macOS/Linux 为例）：
确保已安装 Docker Desktop（含 Docker Engine 和 Docker Compose）；
-
执行官方一键脚本（无需克隆仓库、无需编写任何配置）：
curl -s "https://laravel.build/example-app" | bash
⚠️ 注意：example-app 是项目目录名，可按需修改（如 my-project），脚本将自动创建该文件夹并生成完整 Docker 环境。
-
进入项目并启动服务：
cd example-app ./vendor/bin/sail up -d
Sail 是 Laravel 官方封装的轻量级 Docker CLI 工具，up -d 后所有服务（Web、DB、Cache 等）将在后台运行。
访问应用：浏览器打开 http://localhost 即可看到 Laravel 欢迎页。
该方案底层使用的是 Laravel 官方维护的 laravel/sail 镜像与标准化 docker-compose.yml，所有 PHP 扩展、Nginx 配置、数据库连接均已预设妥当。你无需关心容器是否“已运行”——脚本会为你创建完整、生产级对齐的本地开发栈。
? 小贴士：
- Windows 用户请使用 WSL2 + Docker Desktop，并确保在 WSL2 环境中执行脚本；
- 首次运行可能需要数分钟下载镜像，请保持网络畅通；
- 后续可通过 ./vendor/bin/sail artisan 直接运行 Artisan 命令（如 sail artisan migrate），无需进入容器；
- 如需自定义服务（如切换 PostgreSQL、添加 Selenium），可编辑项目根目录下的 docker-compose.yml 文件——但绝大多数新手场景完全无需修改。
告别手动配置环境的繁琐步骤，从 curl 到 localhost，Laravel + Docker 的协作，本应如此简洁而强大。
