PHP-FPM 的 php_value 指令不支持直接展开 ${VAR} 环境变量语法（尤其字符串值），需通过 Docker 的 env_dir 或 php-fpm.d/*.conf 动态生成方式实现，且必须确保容器内环境变量真实存在并被正确继承。
php-fpm 的 `php_value` 指令不支持直接展开 `${var}` 环境变量语法（尤其字符串值），需通过 docker 的 `env_dir` 或 `php-fpm.d/*.conf` 动态生成方式实现，且必须确保容器内环境变量真实存在并被正确继承。
PHP-FPM 原生配置文件（如 www.conf）并不解析 Shell 风格的环境变量替换语法（如 ${PHP_ERROR_REPORTING}）——该语法仅在某些容器运行时（如 docker run --env-file）或特定构建工具中生效，而 PHP-FPM 自身的配置解析器完全忽略它。这也是为何 php_flag（布尔型）看似“能用”：当环境变量未定义或为空时，php_flag[display_errors] = ${PHP_DISPLAY_ERRORS} 实际被当作无效指令静默跳过，而 FPM 会回退到默认值（如 On），造成“似乎生效”的错觉；但 php_value[error_reporting] 因语法错误被整体忽略，导致 error_reporting 保持默认（通常为 E_ALL & ~E_NOTICE & ~E_STRICT & ~E_DEPRECATED），从而掩盖了实际配置失效的问题。
✅ 正确做法是 避免在静态 .conf 文件中硬写 ${VAR}，改用以下任一可靠方案：
方案 1：使用 env_dir（推荐，PHP 7.3+ 原生支持）
在 php-fpm.conf 中启用环境目录：
; php-fpm.conf env_dir = /etc/php-fpm-env
然后将环境变量写入 /etc/php-fpm-env/ 下的纯文本文件（文件名即变量名，内容为值）：
# 构建时或启动时执行 echo "1" > /etc/php-fpm-env/PHP_DISPLAY_ERRORS echo "E_ALL" > /etc/php-fpm-env/PHP_ERROR_REPORTING echo "1" > /etc/php-fpm-env/PHP_LOG_ERRORS
再在 pool 配置（如 www.conf）中使用 php_admin_value 引用：
; www.conf
php_admin_flag[display_errors] = ${PHP_DISPLAY_ERRORS}
php_admin_value[error_reporting] = ${PHP_ERROR_REPORTING}
php_admin_flag[log_errors] = ${PHP_LOG_ERRORS}
✅ php_admin_value + env_dir 是 PHP 官方支持的动态环境注入机制，安全、可靠、无需重启 FPM。
方案 2：启动时生成配置（Docker 场景最佳实践）
利用 entrypoint.sh 在容器启动前渲染配置：
#!/bin/sh
# entrypoint.sh
set -e
sed -i "s|{{PHP_DISPLAY_ERRORS}}|${PHP_DISPLAY_ERRORS:-0}|g" /etc/php/7.3/fpm/pool.d/www.conf
sed -i "s|{{PHP_ERROR_REPORTING}}|${PHP_ERROR_REPORTING:-E_ALL}|g" /etc/php/7.3/fpm/pool.d/www.conf
sed -i "s|{{PHP_LOG_ERRORS}}|${PHP_LOG_ERRORS:-1}|g" /etc/php/7.3/fpm/pool.d/www.conf
exec "$@"
对应 www.conf 使用占位符：
php_flag[display_errors] = {{PHP_DISPLAY_ERRORS}}
php_value[error_reporting] = {{PHP_ERROR_REPORTING}}
php_flag[log_errors] = {{PHP_LOG_ERRORS}}
⚠️ 关键验证步骤（务必执行）
- 进入运行中容器确认环境变量真实存在：
docker exec -ti your-php-container env | grep "^PHP_" # ✅ 输出应为：PHP_DISPLAY_ERRORS=1、PHP_ERROR_REPORTING=E_ALL 等
- 检查 FPM 是否加载了更新后的配置：
docker exec -ti your-php-container php-fpm -t # 测试配置语法 docker exec -ti your-php-container php-fpm -m | grep "Loaded Configuration File"
- 运行时验证值是否生效：
docker exec -ti your-php-container php -i | grep -E "(display_errors|error_reporting|log_errors)"
? 总结：PHP-FPM 不是 Shell，不支持 $VAR 或 ${VAR} 扩展；php_value 对字符串敏感，错误会导致整行失效；优先采用 env_dir（简洁）或 entrypoint 渲染（灵活可控），并始终通过 env | grep 和 php -i 双重验证，而非依赖表象判断。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
