宝塔环境下 PHP-FPM 配置环境变量笔记

吃不胖没烦恼2025-12-02 9:07

（针对php-fpm.d无www.conf、仅主配置文件生效的场景）

一、核心背景

宝塔集成环境中，PHP-FPM 的池配置（如环境变量）** 直接写在主配置文件php-fpm.conf** 中，而非单独的www.conf（php-fpm.d目录仅存www.conf.default为示例文件）。

二、操作步骤

1. 定位 PHP-FPM 主配置文件

路径格式：/www/server/php/[PHP版本]/etc/php-fpm.conf示例（PHP8.2）：

复制代码

/www/server/php/82/etc/php-fpm.conf

2. 编辑主配置文件添加环境变量

复制代码

# 打开主配置文件（替换为你的PHP版本）
sudo vi /www/server/php/82/etc/php-fpm.conf

在文件中找到[www]池配置块，添加环境变量：

复制代码

[www]
; 原有配置（如用户、监听地址）
user = www
group = www
listen = /tmp/php-cgi-82.sock

; 新增环境变量（替换为实际值）
env[ALIBABA_CLOUD_ACCESS_KEY_ID] = "你的AccessKey ID"
env[ALIBABA_CLOUD_ACCESS_KEY_SECRET] = "你的AccessKey Secret"

3. 重启 PHP-FPM 生效

复制代码

# 对应PHP版本（示例为PHP8.2）
systemctl restart php-fpm-82

三、验证配置是否生效

在网站根目录创建phpinfo.php：
访问该文件，搜索环境变量名（如ALIBABA_CLOUD_ACCESS_KEY_ID），出现则说明配置生效。

四、补充说明

若需添加多个环境变量，在[www]块内继续追加env[变量名] = "值"即可；
宝塔中不同 PHP 版本的配置文件路径仅需替换版本号（如82→74对应 PHP7.4）。