直接用 php:8.1-apache 镜像起步最省事，关键要对齐工作目录与入口路径、正确安装运行时依赖扩展（如 pdo_mysql）、区分构建时与运行时初始化操作，并安全传递环境变量。
ThinkPHP 项目 Dockerfile 基础结构怎么写
直接用 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在开发阶段，不然改了配置不生效，误以为容器没重启
PHP 扩展安装必须手动加吗
ThinkPHP 6+ 默认依赖 pdo_mysql、mbstring、curl、json、xml，这些在官方 php:8.1-apache 镜像里**不全预装**——尤其是 pdo_mysql，得自己装扩展和对应 client lib。
容易踩的坑：只装 php-mysql 包，但没装 default-libmysqlclient-dev，导致 docker build 卡在 configure 阶段。
立即学习“PHP免费学习笔记（深入）”；
- 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 失败，拆成多条更易调试
如何让容器启动后自动执行 ThinkPHP 初始化
不是所有初始化都该塞进 Dockerfile。比如 php think optimize:route 可以构建时做，但 php think migrate:run 必须等数据库就绪后才跑——硬写进 CMD 会导致容器反复重启。
典型错误：把数据库迁移写在 ENTRYPOINT 里，结果 MySQL 容器还没起来，PHP 容器先报 SQLSTATE[HY000] [2002] Connection refused 然后退出。
- 用
wait-for-it.sh或dockerize工具做依赖等待，轻量且可控 - 把应用级初始化逻辑（如生成 runtime 目录、清空缓存）写成 shell 脚本，挂载进容器，在
ENTRYPOINT中调用 -
php think optimize:schema这类命令建议只在 CI 构建阶段执行，避免每次容器启动都重刷，影响启动速度
环境变量和配置怎么安全传给 ThinkPHP
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 命令直接跑迁移时，容器里那一套生命周期就很容易被绕过去。
