是,本教程提供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。











