
laravel 官方提供了一键式 docker 开发环境搭建方案,无需手动编写 dockerfile 或预先配置容器,只需一条命令即可生成并启动包含 nginx、php、mysql、redis 等全套服务的 laravel 项目。
laravel 官方提供了一键式 docker 开发环境搭建方案,无需手动编写 dockerfile 或预先配置容器,只需一条命令即可生成并启动包含 nginx、php、mysql、redis 等全套服务的 laravel 项目。
Laravel 自 v9 起深度集成 Docker 支持,推出了专为开发者设计的轻量级安装脚本 —— laravel.build。该方案并非要求你先“手写 Dockerfile”或“启动空容器”,而是通过一个托管在 GitHub 的 Shell 脚本,自动完成以下全流程:
- 创建项目目录结构;
- 拉取预构建的、针对 Laravel 优化的多服务 Docker Compose 环境(基于 Ubuntu + PHP 8.x + Nginx + MySQL 8 + Redis + MailHog);
- 启动所有容器并自动执行 composer create-project laravel/laravel;
- 配置好 .env、权限与域名映射(默认 http://example-app.test);
- 开箱即用——浏览器访问即见 Laravel 欢迎页。
✅ 快速开始(macOS/Linux 推荐,Windows 可通过 WSL2 使用):
# 执行官方一键安装脚本(将创建名为 example-app 的项目) curl -s "https://laravel.build/example-app" | bash # 进入项目并启动容器 cd example-app ./vendor/bin/sail up -d
⚠️ 注意事项:
- 首次运行会自动安装 Sail(Laravel 官方 Docker CLI 工具),后续可通过 ./vendor/bin/sail artisan、./vendor/bin/sail php 等命令操作容器内服务;
- 若需自定义服务(如切换 PostgreSQL、添加 Meilisearch),可编辑项目根目录下的 docker-compose.yml;
- 域名 example-app.test 需配合 Laravel Homestead 的 valet 或手动配置 hosts(推荐使用 sudo nano /etc/hosts 添加 127.0.0.1 example-app.test);
- 不依赖全局 PHP/Composer/MySQL 安装,真正实现“仅 Docker 即可启动 Laravel”。
? 总结:你不需要先“知道要用什么工具”再配置 Docker——Laravel 已为你预设了最佳实践组合。laravel.build 是面向初学者的友好入口,也是生产就绪型开发环境的起点。从 curl 到 artisan serve,全程不到 2 分钟,真正实现“Docker 为 Laravel 服务”,而非相反。


















