Laravel Docker环境搭建教程_Laravel Sail使用指南

Laravel Sail基于Docker提供开箱即用的开发环境，无需手动配置PHP、数据库等服务。1. 使用laravel new my-app --sail创建项目并自动启用Sail；2. 运行sail up启动容器，访问https://www.php.cn/link/bb122c8fe6c764e8aae555e2186a6344；3. 通过sail artisan、sail composer等命令在容器中执行操作；4. 数据库连接使用mysql作为DB_HOST；5. 邮件测试可通过MailHog在https://www.php.cn/link/bb122c8fe6c764e8aae555e2186a6344:8025查看；6. 可自定义docker-compose.yml和Dockerfile以调整配置。Sail简化了环境搭建，适合团队协作与跨平台开发。

想快速搭建 Laravel 开发环境又不想折腾配置？Laravel Sail 是你的理想选择。它基于 Docker，开箱即用，无需手动安装 PHP、Composer、Node.js 或数据库服务。本文将带你一步步使用 Laravel Sail 搭建本地开发环境。

什么是 Laravel Sail？

Laravel Sail 是 Laravel 官方提供的轻量级命令行接口，用于与 Laravel 的 Docker 开发环境交互。它底层使用 Docker Compose 管理容器，预配置了运行 Laravel 应用所需的服务，包括：

• PHP 8.x 运行环境
• MySQL / PostgreSQL / Redis / Mailhog
• Nginx Web 服务器
• Node.js 和 Vite / Laravel Mix 支持

Sail 让你在没有本地环境依赖的情况下快速启动项目，特别适合团队协作和跨平台开发。

开始前的准备

确保你的系统已安装以下工具：

• Docker Desktop（Windows、macOS）或 Docker Engine + Docker Compose（Linux）
• Git
• 终端工具（如 iTerm2、Windows Terminal 或系统自带终端）

推荐使用 macOS、Windows（WSL2）或 Linux 系统。Docker 性能在这些平台上表现良好。

创建新项目并启用 Sail

你可以通过 Composer 或 Laravel Installer 快速创建一个支持 Sail 的项目。

运行以下命令创建新项目：

composer create-project laravel/laravel my-app
cd my-app

登录后复制

项目创建完成后，Laravel 会自动检测是否安装了 Docker，并提示你初始化 Sail。你也可以手动运行：

php artisan sail:install

登录后复制

执行后会生成 docker-compose.yml 文件，并列出可用服务（MySQL、Redis、Meilisearch 等），按需选择即可。

如果你已全局安装 Laravel Installer：

laravel new my-app --sail

登录后复制

加上 --sail 参数会自动配置 Sail 环境，无需后续手动设置。

启动开发环境

进入项目目录后，使用以下命令启动容器：

sail up

登录后复制

首次运行会拉取镜像并构建容器，可能需要几分钟。完成后，访问 https://www.php.cn/link/bb122c8fe6c764e8aae555e2186a6344 即可看到 Laravel 欢迎页面。

标签： laravel docker mysql php linux word redis js node.js git nod