如何从Apache vhost.conf传递GDFONTPATH环境变量给PHP？

一、仅通过配置实现GDFONTPATH生效的理想方案 #

根据你的部署模式，选择对应的配置方式：

1. PHP-FPM部署模式（Debian 12默认推荐） #

如果你的Apache通过mod_proxy_fcgi配合PHP-FPM运行PHP：

• 找到对应站点的PHP-FPM pool配置文件（比如/etc/php/8.2/fpm/pool.d/example.com.conf，若使用默认全局pool则编辑/etc/php/8.2/fpm/pool.d/www.conf）
• 在配置文件中添加环境变量定义：

  env[GDFONTPATH] = /srv/www/example.com/private/fonts
  

• 重启PHP-FPM服务使配置生效：

  sudo systemctl restart php8.2-fpm
  

这种方式会在PHP-FPM进程启动时将变量写入进程的本地环境变量表，libgd可以直接读取到。

2. mod_php部署模式（传统模块方式） #

如果使用mod_php将PHP作为Apache模块运行：

• 编辑Apache的环境变量配置文件/etc/apache2/envvars，添加：

  export GDFONTPATH="/srv/www/example.com/private/fonts"
  

• 重启Apache服务：

  sudo systemctl restart apache2
  

此时Apache进程启动时会加载该环境变量，运行在Apache进程内的PHP及libgd都能读取到。

二、普通环境变量与“本地”环境变量的区别 #

• Apache SetEnv设置的普通环境变量：属于请求上下文的传递变量，仅存在于PHP的$_SERVER数组和getenv('变量名')（不带第二个参数或第二个参数为false）的返回值中。它是Apache在处理请求时传递给PHP的，并非操作系统进程级别的环境变量，所以底层的libgd无法识别。
• “本地”环境变量：指操作系统进程自身维护的环境变量集合。可以通过putenv()动态写入，也可以在进程启动前通过系统配置（如PHP-FPM的env配置、Apache启动脚本的export）加载。这类变量直接存储在进程的环境变量表中，libgd等底层C库会直接读取这个表，因此能识别这类变量。

你的临时方案（读取路径后传入完整字体文件名）是可行的，但上述配置方式可以实现纯配置层面的解决，无需修改代码。

内容的提问来源于stack exchange，提问作者Peter Ryan