怎么使用Laravel Sail搭建容器化开发环境

Laravel Sail是Laravel官方推出的基于Docker的轻量级开发环境解决方案，它将Nginx、PHP、MySQL、Redis等常用服务封装为Docker容器，开发者不需要在本地手动安装这些依赖，就能快速启动统一的开发环境，避免不同机器之间的环境差异问题。

使用前的准备条件

在使用Laravel Sail之前，需要确保本地已经安装了Docker Desktop，并且Docker服务处于正常运行状态。如果是Windows系统，需要开启WSL2支持；如果是macOS系统，直接安装对应版本的Docker Desktop即可。另外需要保证本地没有占用80、3306等常用端口的服务，避免容器启动时端口冲突。

初始化Laravel项目并启用Sail

如果还没有现有的Laravel项目，可以通过官方提供的安装命令直接创建带Sail的新项目。打开终端执行以下命令：

# 创建新的Laravel项目并自动配置Sail
curl -s "https://ipipp.com/installer" | bash

# 进入项目目录
cd example-app

如果已经有现成的Laravel项目，可以进入项目根目录，通过Composer安装Sail依赖：

# 安装Laravel Sail
composer require laravel/sail --dev

# 发布Sail的配置文件
php artisan sail:install

执行php artisan sail:install时，终端会提示选择需要启用的服务，比如MySQL、Redis、Meilisearch等，根据自己的项目需求选择即可，选中的服务会自动写入docker-compose.yml配置文件中。

启动和停止Sail环境

完成配置后，就可以通过Sail的命令管理容器环境了。首先启动所有容器：

# 启动所有容器，后台运行
./vendor/bin/sail up -d

容器启动后，默认会在80端口启动Nginx服务，此时访问http://localhost就能看到Laravel的默认欢迎页面。如果需要停止所有容器，执行以下命令：

# 停止所有容器
./vendor/bin/sail down

常用Sail操作命令

Sail封装了很多常用的开发命令，不需要进入容器内部就能执行操作，常用的命令如下：

• 执行Artisan命令：./vendor/bin/sail artisan 命令名，比如执行迁移./vendor/bin/sail artisan migrate
• 执行Composer命令：./vendor/bin/sail composer 命令名，比如安装依赖./vendor/bin/sail composer install
• 执行NPM/Yarn命令：./vendor/bin/sail npm 命令名或者./vendor/bin/sail yarn 命令名，比如编译前端资源./vendor/bin/sail npm run dev
• 进入容器终端：./vendor/bin/sail shell，可以直接进入PHP容器的bash终端操作
• 查看容器日志：./vendor/bin/sail logs，可以查看所有容器的运行日志，添加服务名可以查看指定服务的日志，比如./vendor/bin/sail logs mysql

自定义Sail配置

如果需要调整容器的配置，比如修改PHP版本、添加自定义服务、修改端口映射等，可以直接编辑项目根目录下的docker-compose.yml文件。比如要修改MySQL的映射端口为3307，可以修改对应的ports配置：

# docker-compose.yml中MySQL服务的端口配置示例
services:
    mysql:
        image: 'mysql/mysql-server:8.0'
        ports:
            - '3307:3306'  # 将本地3307端口映射到容器3306端口
        environment:
            MYSQL_ROOT_PASSWORD: '${DB_PASSWORD}'
            MYSQL_DATABASE: '${DB_DATABASE}'
            MYSQL_USER: '${DB_USERNAME}'
            MYSQL_PASSWORD: '${DB_PASSWORD}'
        volumes:
            - 'sail-mysql:/var/lib/mysql'
        networks:
            - sail
        healthcheck:
            test: ["CMD", "mysqladmin", "ping", "-p${DB_PASSWORD}"]
            retries: 3
            timeout: 5s

修改完配置后，需要重新构建并启动容器让配置生效：

# 重新构建并启动容器
./vendor/bin/sail up -d --build

常见问题处理

如果启动容器时出现端口冲突的错误，可以检查本地是否有其他服务占用了对应端口，或者修改docker-compose.yml中的端口映射。如果拉取Docker镜像速度慢，可以配置Docker的镜像加速器，提升镜像拉取速度。如果容器启动后访问页面出现500错误，可以查看容器日志定位具体的问题，通常都是环境配置或者依赖安装的问题。

Laravel_SailDocker容器化开发Laravel环境搭建修改时间：2026-06-09 16:33:35