PHP GnuPG扩展在Nginx环境下无法添加PGP密钥求助

核心原因分析 #

PHP内置服务器（php -S）运行在当前用户环境中，继承了完整的PATH变量（包含GnuPG的路径）；而Nginx搭配的PHP-FPM是独立系统服务，默认环境变量被重置，且运行用户为www-data，容易出现GnuPG二进制文件找不到或密钥存储目录权限不足的问题。

解决步骤 #

1. 为PHP-FPM配置正确的PATH环境变量 #

编辑PHP-FPM的池配置文件（默认路径为/etc/php/8.1/fpm/pool.d/www.conf），添加或修改PATH环境变量，确保包含GnuPG的安装路径（Ubuntu上GnuPG通常在/usr/bin）：

env[PATH] = /usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin

修改后重启PHP-FPM服务：

sudo systemctl restart php8.1-fpm

2. 修复GNUPGHOME目录权限 #

/tmp目录虽全局可写，但GnuPG需要创建私有子目录存储密钥，使用专门目录更稳妥：

1. 创建专属密钥存储目录：

   sudo mkdir /var/www/gnupghome
   

2. 设置目录权限为FPM运行用户（默认www-data）所有：

   sudo chown www-data:www-data /var/www/gnupghome
   sudo chmod 700 /var/www/gnupghome
   

3. 修改脚本中的GNUPGHOME设置：

   putenv("GNUPGHOME=/var/www/gnupghome");
   

3. 验证扩展加载与环境变量 #

创建phpinfo.php文件，内容如下：

<?php phpinfo(); ?>

访问该文件后，搜索以下内容确认：

• gnupg模块已加载
• PATH环境变量包含/usr/bin（GnuPG所在路径）

4. 调试具体错误信息 #

在脚本中添加错误捕获代码，获取GnuPG的具体失败原因：

$rtv = gnupg_addencryptkey($res, "C25F29936D9046D73A77DCF8244F423AED8F1481");
var_dump($rtv);
if (!$rtv) {
    echo "GnuPG Error: " . gnupg_geterror($res) . "<br/>";
}

补充说明 #

• CLI环境下正常是因为继承了登录用户的PATH，而FPM服务的环境变量是独立配置的，必须显式指定。
• 700权限的目录确保只有www-data用户能访问密钥存储目录，符合PGP的安全要求。

内容的提问来源于stack exchange，提问作者mxrvin.thiele