必须通过apt安装php、php-cli、php-fpm三包才能解决“command not found”及nginx 502错误；需先sudo apt update更新源，再按需安装扩展并启用php*-fpm服务。
在统信UOS系统上部署网站或运行PHP脚本时，若执行php --version报“command not found”，或Nginx返回502错误且日志提示“connect to 127.0.0.1:9000 failed”，说明PHP核心环境包尚未安装——此时不能直接下载二进制或手动编译，必须通过apt精准安装运行时、FPM管理器及关键扩展三类基础包。
确认系统状态并更新软件源
打开终端，先检查是否已预装PHP：执行php --version与php-fpm -v；若均报错，说明需全新安装。接着执行sudo apt update同步最新软件列表——这一步不可跳过，【若源未更新，后续apt install可能因缓存过期而安装旧版PHP或缺失扩展】。
如提示“Failed to fetch”，需手动配置国内源：备份原文件后，用nano编辑/etc/apt/sources.list，填入统信官方镜像地址（如https://professional-packages.chinauos.com/desktop-professional eagle main），再运行sudo apt update。
安装PHP核心运行时与FPM服务
执行以下命令一次性安装PHP解释器、命令行工具及FastCGI进程管理器：
sudo apt install -y php php-cli php-fpm
该命令会自动拉取当前UOS版本匹配的默认PHP（通常为8.2或8.3），并启用systemd服务。安装完成后，立即验证：php -v应输出版本号，php-fpm -v应显示FPM模块信息。若只装了php而漏掉php-fpm，Nginx将无法与PHP通信，必然出现502错误。
按需安装常用PHP扩展
方法一：一键安装开发常用扩展
sudo apt install -y php-mysql php-curl php-gd php-mbstring php-xml php-zip php-bcmath php-opcache php-soap php-intl
这些扩展覆盖数据库连接、HTTP请求、图像处理、多字节字符串、XML解析、压缩、高精度计算、OP缓存、Web服务和国际化等核心能力。其中php-mysql是连接MySQL/MariaDB的必备项，漏装会导致PDO或mysqli扩展不可用。
方法二：按错误日志精准补装
若运行项目时报“Class 'PDO' not found”或“curl_init(): undefined function”，则只需单独安装对应包：sudo apt install php-mysql → sudo apt install php-curl。这种方式避免冗余安装，节省磁盘空间。
启用并验证PHP-FPM服务
第一步：启用开机自启并启动服务
sudo systemctl enable php*-fpm（将*替换为实际版本号，如8.2）→ sudo systemctl start php*-fpm
第二步：检查服务状态
sudo systemctl status php*-fpm，观察输出中是否含“active (running)”及“Started The PHP FastCGI Process Manager”。若显示failed，常见原因是端口被占用或用户权限配置错误。
第三步：确认监听地址
默认配置下，PHP-FPM监听Unix socket（/run/php/php*-fpm.sock），但部分Nginx配置要求TCP监听。如需切换，请编辑/etc/php/*/fpm/pool.d/www.conf，将listen = /run/php/php*-fpm.sock改为listen = 127.0.0.1:9000，再执行sudo systemctl reload php*-fpm。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
