是，本教程提供CodeIgniter4 Docker化部署的完整指南，涵盖环境一致性配置、MySQL连接修正（host设为db）、PHP-FPM+NGINX分离部署、命名卷持久化、时区与日志权限校准等关键实践。
直接上手就能跑通，但关键不是“能跑”，而是配置不崩、日志可查、数据库不丢数据。CodeIgniter 本身轻量，但 Docker 化后容易在路径、时区、MySQL 连接和缓存这四点翻车。
docker-compose.yml 必须显式挂载 app/Config/Database.php 或用环境变量注入
CodeIgniter 默认从 app/Config/Database.php 读取 DB 配置，而容器内 PHP 进程无法动态感知宿主机的 .env（除非你手动加载）。硬编码 MySQL host 为 localhost 会失败——因为容器里 localhost 指自己，不是 db 服务。
- 正确做法：把数据库 host 改成
db（即docker-compose.yml中定义的服务名） - 更稳妥做法：用
getenv()读取环境变量，在Database.php里写成'hostname' => getenv('DB_HOST') ?: 'db' - 必须在
docker-compose.yml的app服务下配好environment块，例如：environment: - DB_HOST=db - DB_USERNAME=user - DB_PASSWORD=password - DB_DATABASE=codeigniter
Dockerfile 里别用 php:7.4-apache，优先选 php:8.1-fpm + Nginx 分离部署
Apache 模块式部署在容器里冗余高、调试难，且 CodeIgniter4 官方推荐 FPM + 反向代理组合。用 php:8.1-fpm 镜像体积小、启动快、日志分离清晰。
- 别在
Dockerfile里跑apache2-foreground，它会阻塞 CMD，导致健康检查失效 - PHP 扩展要装全：
pdo_mysql、mbstring、zip、opcache缺一不可；漏掉opcache会导致 CI4 自动加载变慢 3 倍以上 -
COPY . /var/www/html后，记得RUN chown -R www-data:www-data /var/www/html，否则 FPM 进程无权读写writable/
volumes 挂载方式决定开发体验和数据安全
开发阶段用绑定挂载（./:/var/www/html）方便改代码即生效，但生产环境必须禁用——它会让容器直接读写宿主机文件系统，绕过镜像不可变性原则，也导致 writable/cache 目录权限混乱。
- 开发时：挂载整个项目目录，但排除
vendor/和writable/，避免 Composer 冲突和权限错乱 - 生产时：只挂载
writable/目录为命名卷（ci-writable:），并在docker-compose.yml里声明：volumes: ci-writable: driver: local - MySQL 数据持久化必须用命名卷（如
dbdata:），不能只靠./mysql-data:/var/lib/mysql—— 宿主机路径权限不一致极易导致容器启动失败并报错mysqld: Can't create/write to file
CI4 的 public/index.php 入口路径和 Nginx 配置必须对齐
Docker 内 Nginx 默认 DocumentRoot 是 /var/www/html，但 CI4 要求入口是 /var/www/html/public。如果没调对，你会看到 “No input file specified.” 或 404，而不是 CodeIgniter 错误页。
- Nginx 配置中必须设
root /var/www/html/public;，不是/var/www/html - 必须启用
try_files $uri $uri/ /index.php?$query_string;，否则路由（如/users/list）全部 404 - PHP-FPM fastcgi_pass 要写成
fastcgi_pass app:9000;（对应 docker-compose 服务名），不能写127.0.0.1:9000
最常被跳过的其实是时区和日志路径：PHP 容器默认 UTC，CI4 日志写入 writable/logs/ 但没设好权限时会静默失败，查不到错误只能干瞪眼。动手前先 docker exec -it <app-container> ls -l /var/www/html/writable</app-container> 看属主是不是 www-data。
