Docker中PHP版本由镜像标签决定，需显式指定如php:8.1-cli；扩展须用docker-php-ext-install安装；配置宜用conf.d下覆盖文件；时区、SAPI类型、OpenSSL等环境须全链路对齐。
PHP 版本在 Docker 里不是“装一次就完事”
你本地跑 php -v 是 8.2，但容器里跑出来是 7.4？不是环境没配好，而是镜像根本没选对。Docker 的 PHP 版本完全取决于你拉的镜像标签，php:latest 目前指向 8.3，但很多项目还卡在 8.0 或 7.4 —— 它不会自动适配你的 composer.json 或 .php-version。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 永远显式指定镜像 tag：
php:8.1-cli、php:8.0-apache，别用latest或alpine（后者默认不带pdo_mysql等扩展） - 多版本共存时，用不同
Dockerfile分离：一个项目用FROM php:7.4-fpm，另一个直接切到php:8.2-fpm，别试图在同一个容器里“切换版本” - 注意基础镜像差异：
php:8.2-cli-bullseye和php:8.2-cli-alpine3.18的包管理器、SSL 证书路径、甚至date.timezone默认值都可能不同
docker-compose.yml 里怎么安全传 PHP 配置
直接挂载 /usr/local/etc/php/php.ini 到宿主机？风险很大：容器启动时若宿主机文件不存在，PHP 进程会静默失败；更糟的是，你改了 ini 文件但忘了重启容器，以为生效了其实没 reload。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 用
php-ini-overrides.ini方式：在docker-compose.yml的volumes里只挂载覆盖文件，比如./php/conf.d/99-custom.ini:/usr/local/etc/php/conf.d/99-custom.ini - 避免覆盖整个
php.ini：Docker 官方镜像默认加载/usr/local/etc/php/conf.d/*.ini，按字母序合并，99-开头确保最后生效 - 关键配置必须验证：启动后进容器执行
php -i | grep 'memory_limit\|date.timezone'，别只信配置文件名
PHP 扩展缺失导致 composer install 失败怎么办
composer install 报错 The requested PHP extension mbstring is missing？不是 Composer 问题，是容器里压根没装这个扩展。Docker 镜像默认只带最精简扩展集，pdo、mbstring、xml 这些常用项得自己加。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在
Dockerfile里用docker-php-ext-install显式启用：RUN docker-php-ext-install mbstring pdo pdo_mysql - 别用
apt-get install php-mbstring：Debian/Alpine 基础镜像里没有这些包，官方 PHP 镜像是从源码编译的，必须走docker-php-ext-*工具链 - 某些扩展需要额外依赖：比如
gd要先apt-get install libfreetype6-dev libjpeg62-turbo-dev libpng-dev，否则编译直接报错
本地开发和 CI 环境 PHP 版本不一致的坑
你本地用 php:8.1-apache 跑通了，CI 却用 php:8.1-cli + 自己搭 Nginx，结果 $_SERVER['REQUEST_URI'] 行为不一致，路由全崩——不是代码问题，是 SAPI 类型（Apache vs CLI vs FPM）和 Web 服务器耦合导致的。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- CI 镜像尽量复用开发镜像：用同一份
Dockerfile构建，只是CMD换成composer install && vendor/bin/phpunit - 避免在
.env或phpinfo()里硬编码版本号：用PHP_MAJOR_VERSION、PHP_MINOR_VERSION这类环境变量做条件判断 - 最易忽略的一点：时区。Docker 默认 UTC，但很多测试依赖
date('Y-m-d')输出，务必在Dockerfile加ENV TZ=Asia/Shanghai并RUN ln -sf /usr/share/zoneinfo/$TZ /etc/localtime
版本控制真正难的不是换镜像，是确认所有环境（本地、CI、预发）的 SAPI、扩展、时区、甚至 OpenSSL 版本都对齐。少一个环节，就可能在上线前最后一刻崩掉。
