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 缓存加速依赖安装）

使用方法和配置说明

基础使用命令

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

参数说明

参数	作用说明
`--rm`	容器退出后自动删除，避免残留临时文件
`-v $PWD:/var/www`	将当前目录（主机）挂载到容器内 `/var/www`（应用运行根目录）
`-v ~/.composer:/root/.composer`	共享本地 Composer 缓存目录，容器可直接使用本地已下载的依赖包缓存
`-p <主机端口>:80`	端口映射：将主机端口 `<主机端口>` 映射到容器内 Nginx 的 80 端口（如 `8080:80` 则应用通过 `http://localhost:8080` 访问）
`-u ${UID}`	使用本地用户 UID 运行容器，确保容器内文件权限与本地一致
`-it`	启用交互式终端模式，支持命令行输入（如确认操作、输入参数等）
`b4commerce/desenvolvimento:7.3`	镜像名称（Laravel 应用专用，PHP 7.3 版本）

XDebug 配置

步骤 1：在 PHPStorm 中创建 PHP Server

打开 PHPStorm 配置：
File -> Settings -> Languages & Frameworks -> PHP -> Servers
点击 + 添加新服务器，配置如下：
- Name：自定义服务器名称（如 docker-laravel）
- Host：容器访问 URL（如 localhost）
- Port：主机映射端口（如步骤 1 中配置的 <主机端口>）
- 勾选 Use path mappings
- 在 Project Files 中，将本地项目根目录映射到容器内 /var/www
说明：路径映射用于 XDebug 关联本地文件与容器内文件位置，确保断点调试正常。

步骤 2：配置 PHP Remote Debug

打开调试配置：点击 PHPStorm 工具栏 Add Configuration（或 Run -> Edit Configurations）
点击 + 并选择 PHP Remote Debug，配置如下：
- Name：自定义调试配置名称（如 XDebug-Docker）
- 勾选 Filter debug connection by IDE key
- Server：选择步骤 1 中创建的服务器
- IDE key (session id)：固定填写 docker（镜像内置 XDebug 已配置此 IDE key）