Linux解决PHP环境依赖四步骤搭建方案-php教程-PHP中文网

结论：php环境在linux上跑不起来，90%不是php本身的问题，而是web服务器、php-fpm、扩展模块、php.ini四者没对齐；顺序错、路径错、用户权限错，任一环节断掉，phpinfo()就打不开。

linux解决php环境依赖四步骤搭建方案

直接说结论：PHP环境在Linux上跑不起来，90%不是PHP本身的问题，而是Web服务器、PHP-FPM、扩展模块、php.ini四者没对齐。顺序错、路径错、用户权限错，任何一个环节断掉，phpinfo()就打不开。

确认PHP是否真装上了，别被`php -v`骗了

很多新手执行php -v看到版本号就以为OK，但其实这只是CLI（命令行）模式的PHP，和Web服务器用的不是同一个二进制或配置。Web请求走的是PHP-FPM或mod_php，它们可能根本没装、没启、甚至版本不一致。

查Web用的PHP路径：php-fpm -v（如果报command not found，说明PHP-FPM压根没装）
查当前生效的php.ini：php --ini | grep "Loaded Configuration File"，注意这个路径和php-fpm --ini返回的很可能不同
Ubuntu/Debian下，php包默认不带php-fpm，必须显式装php8.1-fpm（版本号要匹配）
CentOS/RHEL系若用Remi仓库，php-fpm服务名是php-fpm，但配置文件在/etc/php-fpm.d/www.conf，别去/etc/php/下瞎找

PHP-FPM监听方式必须和Nginx配置严格一致

Nginx转发PHP请求靠fastcgi_pass，它必须精确指向PHP-FPM正在监听的地址。Unix socket和TCP端口不能混用，路径拼错一个字符就502。

Computer Use Linux

顶级 Linux 计算机使用技能，配套独立自举运行时，无需本地 Claude 安装、私有原生模块等。

下载

先看PHP-FPM实际监听哪：sudo ss -tulpn | grep :9000 或 sudo ss -tulpn | grep php
常见错误：Nginx写fastcgi_pass 127.0.0.1:9000，但PHP-FPM配置里是listen = /run/php/php8.1-fpm.sock（Unix socket）
权限陷阱：socket文件属主是www-data:www-data（Debian系）或nginx:nginx（RHEL系），Nginx worker进程必须属于同一组，否则连不上
改完www.conf后，必须sudo systemctl restart php-fpm，光reload不行

扩展没加载 ≠ 没装，`php -m`和`php-fpm -m`要分开看

php -m只显示CLI模式加载的模块；php-fpm -m才是Web请求实际用的。很多扩展（比如opcache、mysqlnd）默认只启用在FPM SAPI里。

装扩展时注意后缀：Ubuntu/Debian下是php8.1-mysql，不是php-mysql；CentOS下是php-mysqlnd，不是php-mysql
某些扩展（如imagick）依赖系统库，apt install php-imagick后还得sudo apt install libmagickwand-dev，否则php-fpm -m里看不到
display_errors = On在php.ini里设了，但FPM池配置www.conf里有php_admin_flag[display_errors] = off，会强制覆盖——这种覆盖优先级更高

php.ini修改后，重启服务顺序不能乱

改完php.ini不等于生效。CLI、Apache、Nginx+PHP-FPM三者加载配置的时机和路径完全不同，改错地方白忙活。

CLI模式读/etc/php/*/cli/php.ini，FPM模式读/etc/php/*/fpm/php.ini，Apache mod_php读/etc/php/*/apache2/php.ini
改的是FPM的php.ini，却只systemctl restart nginx，PHP-FPM进程根本没重读配置
正确顺序：sudo systemctl restart php-fpm && sudo systemctl reload nginx（reload比restart更轻量，不中断连接）
上传限制类参数（upload_max_filesize、post_max_size）必须同时在php.ini和www.conf里检查，后者可通过php_admin_value[upload_max_filesize]覆盖前者

最常被忽略的一点：所有配置路径、用户组名、socket文件权限，都得按发行版规范来。Ubuntu认www-data，CentOS认nginx或apache，硬套文档里的命令不改用户名，十次有九次卡在502。动手前先ls -l /run/php/和ps aux | grep php-fpm看一眼真实状态，比盲目重启强得多。