CodeIgniter容器化部署教程

本文深入解析了CodeIgniter 4在Docker环境下的稳健部署实践，直击容器化过程中最易踩坑的四大痛点——MySQL连接失效（localhost误用）、时区错乱、日志静默丢失、缓存性能骤降，并给出可落地的解决方案：通过docker-compose显式注入环境变量、强制使用db服务名替代localhost、采用PHP-FPM+NGINX分离架构、精准挂载命名卷保障数据持久性与权限安全、严格校准Nginx根路径与PHP入口配置。这不是“跑起来就行”的速成指南，而是帮你避开生产事故、实现日志可追溯、数据库不丢数据、配置不崩塌的实战手册——每一步都经验证，每一处细节都关乎系统稳定性。

直接上手就能跑通，但关键不是“能跑”，而是配置不崩、日志可查、数据库不丢数据。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 ls -l /var/www/html/writable 看属主是不是 www-data。

理论要掌握，实操不能落！以上关于《CodeIgniter容器化部署教程》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！