PHP配置在Docker中不生效主因是被覆盖、路径错、加载顺序冲突或扩展未启用；需用php --ini和php_ini_loaded_file()确认实际加载路径，检查conf.d是否被整目录挂载导致扩展丢失，验证php -m中扩展是否存在且无重复加载，并用php -i或ini_get()实测配置值。
PHP 文件配置在 Docker 中不生效，多数不是写错了，而是被覆盖、路径不对、加载顺序冲突或扩展未启用。核心在于确认配置是否真正被 PHP 读取并应用。
确认 php.ini 实际生效路径
容器内运行以下命令，查看 PHP 加载的主配置文件位置：
-
php --ini—— 显示“Loaded Configuration File”行，例如/usr/local/etc/php/php.ini -
php -r "echo php_ini_loaded_file();"—— 直接输出被加载的 ini 文件全路径 - 若输出为
no value，说明没加载任何 php.ini，所有配置都按默认值运行
检查 conf.d 目录是否被 volume 覆盖
Docker Compose 或 run 命令中若挂载了整个 /usr/local/etc/php/conf.d/ 目录（如 -v ./conf.d:/usr/local/etc/php/conf.d），会清空官方镜像预置的扩展配置（如 docker-php-ext-openssl.ini），导致 openssl、mysqli 等扩展失效。
- ✅ 正确做法：只挂载单个配置文件，例如
-v ./php-custom.ini:/usr/local/etc/php/conf.d/custom.ini - ❌ 错误做法：挂载整个目录，尤其当本地
conf.d为空或不含必要扩展配置时 - 验证方式：进容器执行
ls -l /usr/local/etc/php/conf.d/，确认有*openssl*.ini等关键文件
确保扩展已启用且无重复加载
扩展未启用是配置“看似写了却无效”的最常见原因，尤其 OpenSSL、FFI、GD 等。
立即学习“PHP免费学习笔记（深入）”；
- 运行
php -m | grep -E "(openssl|mysqli|gd|ffi)"查看是否在已启用模块列表中 - 若缺失，检查对应
.ini文件是否存在，内容是否为extension=openssl（不能写成extension=openssl.so） - 若出现
PHP Warning: Module 'xxx' already loaded，说明该扩展被多次声明，删掉重复项 - Alpine 镜像需额外安装系统包：
apk add openssl-dev php82-opcache（版本号按实际调整）
验证配置项是否真被识别
不要只信 php.ini 里写了，要用 PHP 运行时确认：
-
php -i | grep "upload_max_filesize"—— 查看实际生效值 -
php -r "var_dump(ini_get('max_execution_time'));"—— 输出字符串值，注意类型 - 对布尔配置（如
display_errors = On），ini_get()返回字符串"1"或""，可用filter_var(ini_get('display_errors'), FILTER_VALIDATE_BOOLEAN)转换 - 如果
ini_get()返回空或默认值，说明该配置未被加载或拼写错误（如写成max_executiontime少了下划线）
