如何在 Docker 中快速启动 Laravel 开发环境-php教程-PHP中文网

如何在 Docker 中快速启动 Laravel 开发环境

本文介绍 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 等配置开箱可用。

Docker Encyclopedia

Docker 文档优先工作流：针对 Docker 特定问题、故障排除、命令规划、镜像/构建、容器/运行时操作及 Compose 等

下载

⚠️ 注意事项：

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 进阶章节。