统信UOS怎么安装和配置PHP-FPM

在统信UOS上跑PHP脚本，想让Web服务器正常执行，光装个php-cli可不够——你得把PHP-FPM服务装好、配好。否则访问.php文件要么直接下载源码，要么给你个502错误。这一步跳不过去，也别想着“装个cli就能凑合用”。

下面直接讲实操，从安装到配置再到验证，每一步都是稳定上线必须踩实的点。

安装PHP核心与FPM服务

统信UOS基于Debian体系，官方源里已经预制了PHP 8.2等稳定版本，直接apt装就行，不用换源也不用自己编译，省心很多。

先把软件包索引更新一下，顺带升级基础组件：

sudo apt update && sudo apt upgrade -y

然后安装PHP解释器、PHP-FPM进程管理器，外加开发常用的扩展：

sudo apt install -y php-fpm php-cli php-mysql php-curl php-gd php-mbstring php-xml php-zip php-bcmath php-opcache

装完后先确认一下PHP版本和关键模块有没有加载成功：

php -v && php -m | grep -E "(fpm|mysql|curl|gd)"

这里有个小细节需要留意：查一下PHP-FPM的实际服务名。运行下面这条命令，记下输出的完整名字（比如php8.2-fpm），后面所有systemctl操作都要用这个全名：

ls /lib/systemd/system/php*-fpm.service

配置PHP-FPM监听为TCP模式

默认情况下PHP-FPM用的是Unix socket，路径类似/run/php/php*.sock。但权限问题经常搞出幺蛾子，Nginx连上去动不动就报502。换成127.0.0.1:9000这种TCP模式更稳妥，也方便用curl直连调试，排查问题少绕很多弯。

改法很简单，编辑主池配置文件：

sudo cp /etc/php/*/fpm/pool.d/www.conf /etc/php/*/fpm/pool.d/www.conf.bak
sudo nano /etc/php/*/fpm/pool.d/www.conf

关键动作：把原来的listen = /run/php/php*.sock这一行删掉，改成listen = 127.0.0.1:9000。

同时，把user = www-data和group = www-data改成你当前登录的用户名（比如uosuser）。不然Nginx以非root身份连接9000端口时会被拒绝，折腾半天还不知道问题在哪。

改完保存退出，重载服务使配置生效：

sudo systemctl reload php*-fpm

注意把*替换成你刚才查到的实际版本号，比如8.2。

启用并验证PHP-FPM服务

第一步，先设置开机自启，然后立刻启动：

sudo systemctl enable php*-fpm
sudo systemctl start php*-fpm

检查一下服务状态，返回active才算站稳：

sudo systemctl is-active php*-fpm

第二步，在Web根目录下创建一个验证文件：

echo "" | sudo tee /var/www/html/info.php

记得把文件属主改成PHP-FPM运行用户：

sudo chown uosuser:uosuser /var/www/html/info.php

第三步（强烈建议做），测试端口响应是否正常。先安装FastCGI测试工具：

sudo apt install libcgi-fast-perl

然后执行本地探针请求：

SCRIPT_FILENAME=/var/www/html/info.php REQUEST_METHOD=GET cgi-fcgi -bind -connect 127.0.0.1:9000 | head -20

如果返回的HTML片段里包含PHP Version和Configuration File这些字样，说明PHP-FPM已经能正常响应请求了。到这一步，环境就算彻底就绪，后续配置Nginx或者别的Web服务器只管往127.0.0.1:9000转发就行。