laravel Sail是Laravel官方提供的基于docker的开发环境,通过一条命令即可快速启动包含nginx、mysql、redis等服务的容器化开发环境,无需本地安装php、composer、node.js等依赖。使用curl -s https://laravel.build/example-app | bash创建项目,进入目录后运行./vendor/bin/sail up启动服务,访问http://localhost即可查看应用。Sail提供sail artisan、sail composer、sail npm等命令在容器内执行操作,确保环境一致性。可通过修改docker-compose.yml文件自定义服务配置,如启用Redis、调整端口映射等,结合sail down和sail up重新生效。Sail显著降低环境配置复杂度,提升团队协作效率,适合新手和标准化项目开发。

Laravel Sail 是 Laravel 官方提供的一种轻量级、基于 Docker 的本地开发环境。它让你无需在本地安装 PHP、Composer、Node.js、数据库等开发依赖,只需安装 Docker,就能快速启动一个完整的 Laravel 开发容器环境。Sail 特别适合希望快速上手、避免环境配置麻烦的开发者。
什么是 Laravel Sail
Laravel Sail 将常用的开发服务(如 Nginx、MySQL、Redis、Mailhog 等)封装在 Docker 容器中,通过 docker-compose.yml 文件定义服务配置。你可以在命令行使用 sail 命令(本质是 Artisan 命令的封装)来启动、停止和管理这些容器。
Sail 的核心优势在于“开箱即用”:项目初始化后,运行一条命令即可拥有标准化的开发环境,避免“在我机器上能跑”的问题。
如何使用 Sail 快速启动项目
开始使用 Sail 非常简单,前提是你已安装 Docker Desktop 或 Docker Engine。
- 创建新 Laravel 项目并启用 Sail:
curl -s https://laravel.build/example-app | bash - 进入项目目录并启动容器:
cd example-app && ./vendor/bin/sail up - 访问 http://localhost 即可看到 Laravel 欢迎页面
此时,你的应用运行在 Nginx 容器中,数据库连接可使用默认配置(DB_HOST=mysql),所有服务由 Docker 自动管理。
Sail 常用命令一览
Sail 提供了简洁的 CLI 接口来执行常见操作:
- sail up:启动容器(加 -d 参数后台运行)
- sail stop:停止容器
- sail artisan:运行 Artisan 命令,例如 sail artisan migrate
- sail composer:在容器内执行 Composer 命令
- sail npm:运行 Node 相关命令,如 sail npm run dev
- sail shell:进入应用容器的 Bash 环境
这些命令替代了本地全局安装工具的需求,所有操作都在一致的容器环境中完成。
自定义 Sail 环境
你可以根据项目需要修改 docker-compose.yml 文件来添加或调整服务。例如:
- 启用 Redis:在 services 中取消 redis 的注释
- 修改 MySQL 端口:更改 ports 映射避免冲突
- 挂载额外目录:确保本地代码实时同步到容器
修改后运行 sail down 再 sail up 重建容器即可生效。
基本上就这些。Laravel Sail 降低了新手入门门槛,也提升了团队协作时环境的一致性。不复杂但容易忽略。
以上就是Laravel Sail是什么_基于Docker的Laravel本地开发环境Sail入门的详细内容,更多请关注php中文网其它相关文章!