如何在PHP文件中读取Kubernetes yaml配置的系统环境变量

优先确认运行模式差异 #

你已确认容器内环境变量生效，首先判断PHP的运行场景：

• 在容器内执行CLI命令 php env.php 查看输出：如果输出有正常的变量值，说明问题出在网页请求对应的PHP运行层（多为PHP-FPM模式）
• 如果CLI模式也读取不到，检查PHP.ini的variables_order配置，需确保配置值包含E（启用$_ENV超全局变量）和S（将环境变量写入$_SERVER），默认配置通常为variables_order = "GPCS"，缺少E会导致$_ENV为空。

PHP-FPM模式的专属配置修改 #

PHP-FPM默认开启clear_env配置，会清空所有继承自系统的环境变量，这是90%以上此类问题的根因，按以下步骤修改：

1. 找到PHP-FPM的进程池配置文件（通常为/etc/php/[版本]/fpm/pool.d/www.conf）
2. 修改两个配置项：

; 关闭自动清理环境变量的逻辑
clear_env = Off
; 显式声明需要暴露给PHP的环境变量，可按需添加所有需要的变量
env[MYSQL_HOST] = $MYSQL_HOST
env[MYSQL_DATABASE] = $MYSQL_DATABASE
env[MYSQL_USER] = $MYSQL_USER
env[MYSQL_PASSWORD] = $MYSQL_PASSWORD

3. 重启PHP-FPM进程后重试。

如果使用supervisord托管PHP-FPM进程，还需要在supervisord对应服务的配置段中显式传递环境变量：

[program:php-fpm]
command = /usr/sbin/php-fpm8.2 -F
user = www-data
environment = MYSQL_HOST="%(ENV_MYSQL_HOST)s",MYSQL_DATABASE="%(ENV_MYSQL_DATABASE)s",MYSQL_USER="%(ENV_MYSQL_USER)s",MYSQL_PASSWORD="%(ENV_MYSQL_PASSWORD)s"

替换环境变量读取方式 #

除了getenv外，可优先使用PHP超全局变量读取，兼容性更强：

<?php
// 兼容多种配置场景的读取逻辑
$db_host = $_ENV['MYSQL_HOST'] ?? $_SERVER['MYSQL_HOST'] ?? getenv('MYSQL_HOST');
$db_name = $_ENV['MYSQL_DATABASE'] ?? $_SERVER['MYSQL_DATABASE'] ?? getenv('MYSQL_DATABASE');
$db_user = $_ENV['MYSQL_USER'] ?? $_SERVER['MYSQL_USER'] ?? getenv('MYSQL_USER');
$db_pwd  = $_ENV['MYSQL_PASSWORD'] ?? $_SERVER['MYSQL_PASSWORD'] ?? getenv('MYSQL_PASSWORD');

echo "db_host: {$db_host}<br>";
echo "db_name: {$db_name}<br>";
echo "db_user: {$db_user}<br>";
echo "db_pwd: {$db_pwd}<br>";
?>

如果使用Apache+mod_php模式，还需要在Apache虚拟主机配置中添加PassEnv指令传入所需变量：

PassEnv MYSQL_HOST
PassEnv MYSQL_DATABASE
PassEnv MYSQL_USER
PassEnv MYSQL_PASSWORD

内容的提问来源于stack exchange，提问作者Bhargav Lalaji