Laravel如何使用Laravel Sail进行本地开发_Laravel Sail容器化开发环境配置

14次阅读

laravel Sail是官方提供的开箱即用docker开发环境,支持快速搭建项目并统一团队开发配置。通过curl命令可新建集成Sail的项目,进入目录后运行./vendor/bin/sail up启动容器,访问https://www.php.cn/link/bb122c8fe6c764e8aae555e2186a6344即可查看应用。常用命令包括后台启动(up -d)、执行Artisan命令、运行composer依赖安装、进入PHP容器(shell)及停止服务(down)。环境配置由docker-compose.yml和.env文件控制,可自定义数据库端口(如FORWARD_DB_PORT=3307)、添加redis服务、挂载目录实现代码同步。数据库默认使用mysql,连接信息在.env中定义,可通过GUI工具或sail mysql命令行连接,支持运行迁移与数据填充(migrate –seed)。修改配置后需重启容器生效。Sail简化了本地开发流程,避免环境不一致问题,适用于中小型项目快速启动。

Laravel如何使用Laravel Sail进行本地开发_Laravel Sail容器化开发环境配置

Laravel Sail 是 Laravel 官方提供的轻量级 Docker 开发环境,开箱即用,无需手动配置 nginx、PHP、MySQL 等服务。通过简单的命令即可启动完整的本地开发容器环境,特别适合快速搭建项目和团队统一开发环境。

启用 Laravel Sail

创建新的 Laravel 项目时,默认已集成 Sail(Laravel 8+):

  • 新建项目并启用 Sail:
    curl -s "https://laravel.build/example-app" | bash
  • 进入项目目录:
    cd example-app
  • 启动容器:
    ./vendor/bin/sail up

首次运行会自动构建镜像并启动容器,访问 https://www.php.cn/link/bb122c8fe6c764e8aae555e2186a6344 即可看到 Laravel 欢迎页。

常用 Sail 命令

Sail 提供了简洁的 CLI 接口来管理容器中的服务:

  • 后台运行容器:
    ./vendor/bin/sail up -d
  • 执行 Artisan 命令:
    ./vendor/bin/sail artisan migrate
  • 运行 Composer:
    ./vendor/bin/sail composer require laravel/sanctum
  • 进入 PHP 容器终端:
    ./vendor/bin/sail shellsail php
  • 停止容器:
    ./vendor/bin/sail down

自定义 Sail 环境配置

Sail 的配置主要通过 docker-compose.yml.env 文件控制。

  • 修改数据库端口:
    .env 中设置:
    FORWARD_DB_PORT=3307
    这样主机可通过 3307 访问容器 MySQL。
  • 添加 Redis 支持:
    修改 docker-compose.yml,在 services 下加入 redis 服务,并确保应用连接到 redis 主机名。
  • 挂载额外目录:
    检查 docker-compose.yml 中的 volumes 配置,确保本地代码实时同步到容器。

修改后需重启容器使配置生效:sail down 后再 sail up -d

数据库连接与开发调试

Sail 默认使用 MySQL,连接信息在 .env 文件中:

  • 数据库主机: mysql
  • 用户名: root
  • 密码: password
  • 数据库名: laravel

可使用 TablePlus、Sequel Pro 或命令行连接容器数据库:

./vendor/bin/sail mysql

运行迁移和填充数据:

./vendor/bin/sail artisan migrate --seed 基本上就这些。Sail 让 Laravel 本地开发变得简单一致,省去环境差异带来的问题,适合大多数中小型项目快速上手。

text=ZqhQzanResources