如何实现ThinkPHP应用的Docker容器化_Dockerfile编写与PHP扩展安装-ThinkPHP-PHP中文网

直接用 php:8.1-apache 镜像起步最省事，关键要对齐工作目录与入口路径、正确安装运行时依赖扩展（如 pdo_mysql）、区分构建时与运行时初始化操作，并安全传递环境变量。

如何实现thinkphp应用的docker容器化_dockerfile编写与php扩展安装

直接用 php:8.1-apache 镜像起步最省事，ThinkPHP 是纯 PHP 应用，不需要自己编译 Apache 或 Nginx。关键不是“能不能跑”，而是“会不会漏掉运行时依赖”。

常见错误现象：Class 'think\App' not found、require(): Failed opening required 'base.php'，基本都是工作目录或入口路径没对齐。

把项目代码复制到 /var/www/html（Apache 默认 DocumentRoot），别放错层级；ThinkPHP 的 public/ 必须是 Web 根目录，APP_PATH 要指向上级的 app/
用 COPY . /var/www/html/ 后，立刻 RUN chown -R www-data:www-data /var/www/html，否则 Apache 进程读不到缓存或日志目录
禁用 opcache.revalidate_freq=0 在开发阶段，不然改了配置不生效，误以为容器没重启

ThinkPHP 6+ 默认依赖 pdo_mysql、mbstring、curl、json、xml，这些在官方 php:8.1-apache 镜像里**不全预装**——尤其是 pdo_mysql，得自己装扩展和对应 client lib。

容易踩的坑：只装 php-mysql 包，但没装 default-libmysqlclient-dev，导致 docker build 卡在 configure 阶段。

Debian 系镜像用 apt-get install -y libpng-dev libjpeg-dev libfreetype6-dev 再 docker-php-ext-configure gd --with-freetype --with-jpeg，否则验证码、图片处理扩展编译失败
ext-redis 要先 pecl install redis，再 docker-php-ext-enable redis，顺序反了会提示 “extension not found”
别在 RUN docker-php-ext-install 后追加 && 拼长命令，中间出错整个 layer 失败，拆成多条更易调试

不是所有初始化都该塞进 Dockerfile。比如 php think optimize:route 可以构建时做，但 php think migrate:run 必须等数据库就绪后才跑——硬写进 CMD 会导致容器反复重启。

典型错误：把数据库迁移写在 ENTRYPOINT 里，结果 MySQL 容器还没起来，PHP 容器先报 SQLSTATE[HY000] [2002] Connection refused 然后退出。

ThinkPHP 本身不原生读取 ENV，靠 .env 文件或 config/app.php 里的硬编码。直接挂载 .env 到容器里最简单，但要注意权限和覆盖风险。

容易忽略的点：APP_DEBUG=true 在生产镜像里没关，结果暴露完整异常堆栈；或者 DB_PASSWORD 明文写进 Dockerfile，导致镜像泄露敏感信息。

用 docker run -e APP_DEBUG=false -e DB_HOST=mysql 传参，再在 config/database.php 中用 $_ENV['DB_HOST'] ?? '127.0.0.1' 读取
挂载 .env 时加 :ro（只读），防止运行中被 PHP 进程意外修改
别用 VOLUME 声明 runtime/ 目录，否则每次启动都清空缓存，路由、模板编译全失效

真正麻烦的从来不是写几行 Dockerfile，而是搞清楚哪些操作该在构建时做、哪些必须运行时做、哪些压根不该放进容器——尤其当团队里有人习惯本地 php think 命令直接跑迁移时，容器里那一套生命周期就很容易被绕过去。