Laravel 基础开发镜像 (b4commerce/desenvolvimento:7.3)

镜像概述和主要用途

本镜像为 B4Commerce 提供的 Laravel 应用开发专用 Docker 镜像，基于生产环境容器配置构建，确保开发环境与生产环境一致性。集成 PHP 7.3、Nginx 及必要开发工具，适用于 Laravel 应用的本地开发、调试及依赖管理。

核心功能和特性

• 环境一致性：与生产环境容器配置完全一致，避免"开发正常生产异常"问题
• 预装开发工具：包含 git、AWS CLI、XDebug 等常用开发/调试工具
• Composer 缓存共享：支持本地 Composer 缓存目录挂载，减少依赖重复下载
• 权限兼容：支持通过本地用户 UID 运行容器，避免文件权限差异导致的读写问题
• Web 服务集成：内置 Nginx 作为 Web 服务器，默认监听 80 端口
• 交互式终端：支持 -it 参数启用交互式模式，便于命令行交互操作

使用场景和适用范围

• Laravel 应用的本地开发环境搭建
• 需要与生产环境保持配置一致的开发/测试场景
• 使用 XDebug 进行代码调试（配合 PHPStorm 等 IDE）
• 依赖管理优化（利用本地 Composer 缓存加速依赖安装）

使用方法和配置说明

基础使用命令

docker run --rm \
  -v $PWD:/var/www \
  -v ~/.composer:/root/.composer \
  -p <主机端口>:80 \
  -u ${UID} \
  -it \
  b4commerce/desenvolvimento:7.3

参数说明

XDebug 配置

步骤 1：在 PHPStorm 中创建 PHP Server

1. 打开 PHPStorm 配置：
   File -> Settings -> Languages & Frameworks -> PHP -> Servers

2. 点击 + 添加新服务器，配置如下：

   • Name：自定义服务器名称（如 docker-laravel）

   • Host：容器访问 URL（如 localhost）

   • Port：主机映射端口（如步骤 1 中配置的 <主机端口>）

   • 勾选 Use path mappings

   • 在 Project Files 中，将本地项目根目录映射到容器内 /var/www

   说明：路径映射用于 XDebug 关联本地文件与容器内文件位置，确保断点调试正常。

步骤 2：配置 PHP Remote Debug

1. 打开调试配置：点击 PHPStorm 工具栏 Add Configuration（或 Run -> Edit Configurations）

2. 点击 + 并选择 PHP Remote Debug，配置如下：

   • Name：自定义调试配置名称（如 XDebug-Docker）
   • 勾选 Filter debug connection by IDE key
   • Server：选择步骤 1 中创建的服务器
   • IDE key (session id)：固定填写 docker（镜像内置 XDebug 已配置此 IDE key）

步骤 3：激活调试

点击 PHPStorm 工具栏中的 Start Listening for PHP Debug Connections（小电话图标），启用调试监听。

步骤 4：使用调试

配置完成后，在代码中设置断点，通过浏览器或命令行触发请求，PHPStorm 将自动捕获调试会话并暂停在断点处。