课堂版本矩阵
| 组件 | 验证范围 |
|---|---|
| Windows 与 WSL | Windows 下的 WSL2 Ubuntu 运行 Docker |
| 容器 | 已验证 Engine 29.1.3、Compose 2.40.3 |
| PHP | 8.4.28、Composer 2.11.2。源码范围 PHP 8.2–8.4,其他组合需复跑 |
| 数据库 | MySQL 8.0.46 默认严格模式,5.7 与 8.4 完整安装待验证 |
| Web 与缓存 | Nginx 1.28.2、Redis 8.2.11。文件缓存和 Redis 缓存均有普通网页安装证据 |
| 源码 | 白泽教学基线 8ccf4130c7bdc56087a2b20c6f070756a22416c8。官方上游见第 2 课 |
操作清单
PowerShell 执行
wsl -l -v,确认 Ubuntu 的 VERSION 为 2。进入 Ubuntu 执行docker version和docker compose version,核对服务端。教学仓库有权限时,在仓库根执行
git rev-parse HEAD与git show HEAD:docker/compose.dev.yml。官方副本按第 2 课确认版本及上游依赖。从独立教学副本根目录执行以下命令。脚本会在副本内生成本地合成凭据。复制 Compose 文件后,先把副本内的 Nginx 回环映射由 8011 改为本机未占用的端口,数据库和 Redis 留在 Compose 私网。原有项目与数据卷继续使用自己的目录和项目名。
bash scripts/dev-init.sh cp docker/compose.dev.yml docker/compose.course.yml export CRMEB_DEV_CHECKOUT="$(pwd -P)" docker compose --project-name crmeb-course --env-file docker/.env.dev -f docker/compose.course.yml config --services服务清单应为 mysql、redis、phpfpm、nginx。确认副本路径、配置文件和回环端口后继续。
使用相同的项目名、环境文件和 Compose 文件执行
up -d --build,然后执行ps查看健康状态。使用独立空库和合成管理员走普通网页安装。原样复用仓库默认开发项目时,使用bash scripts/dev-compose.sh入口,其固定的默认项目与端口应当可用。验证管理员登录、H5 首页、分类和商品 API。记录版本、实际端口、HTTP 与业务状态。课堂基线记录 124 张基础表、45 组默认数据、22 个默认安装项。
换版本或镜像后重新跑安装。生产上线另验渠道配置、HTTPS、备份恢复与回退。