PHP安装后php-fpm命令找不到，常见原因是仅安装了CLI版本而未安装FPM SAPI：Ubuntu/Debian需apt install php-fpm，CentOS/RHEL需启用对应仓库后dnf/yum install php-fpm。
PHP安装后为什么php -v能用但php-fpm命令找不到
常见原因是系统默认只装了 CLI 版本，没装 FPM SAPI。Ubuntu/Debian 下apt install php只装核心和 CLI；CentOS/RHEL 8+ 默认用dnf module enable php:remi-8.2后再dnf install php-fpm，否则php-fpm二进制根本不存在。
实操建议：
- 先确认发行版和仓库源：Ubuntu 22.04 推荐
apt install php-fpm；CentOS 7 用yum install php-fpm（EPEL 启用前提下）；Rocky/AlmaLinux 9 推荐启用 Remi 源：dnf install epel-release && dnf install https://rpms.remirepo.net/enterprise/remi-release-9.rpm -
which php-fpm返回空？立刻检查是否漏装包，别急着改 PATH - FPM 服务名在不同系统不同：
systemctl status php-fpm（多数）或systemctl status php8.2-fpm（Ubuntu 多版本共存时）
php.ini和www.conf到底该改哪个
php.ini控制 PHP 解析器全局行为（如memory_limit、date.timezone），所有 SAPI（CLI/FPM/CGI）都读它；www.conf（通常在/etc/php/*/fpm/pool.d/www.conf）只管 FPM 进程池的运行参数（如listen地址、pm.max_children、用户权限）。两者不替代，要分清作用域。
容易踩的坑：
立即学习“PHP免费学习笔记（深入）”；
- 把
upload_max_filesize写进www.conf——无效，必须放php.ini或 pool 的php_admin_value[upload_max_filesize]里 - 改完
www.conf忘了重载服务：systemctl reload php*-fpm，不是 restart - 多 pool 场景下，
www.conf被复制为api.conf后，listen = /run/php/php8.2-fpm.sock路径冲突，得手动改 socket 文件名或端口
模块加载失败：php -m看不到mysqli或curl
PHP 模块分两类：编译进内核的（如json）和动态扩展（.so文件）。Ubuntu/Debian 中apt install php-mysql才装mysqli，php-curl对应curl扩展，名字不等于函数名。
排查步骤：
- 查扩展是否已安装：
ls /usr/lib/php/*/mysqli.so（路径因版本而异） - 确认
php.ini里有extension=mysqli（注意不是extension=mysqli.so，新版推荐省略.so） - 如果用
phpenmod（Debian 系），执行phpenmod mysqli再systemctl reload php*-fpm - 扩展依赖系统库：比如
gd需要libjpeg-dev等，php -i | grep gd报“not found”先apt install libjpeg-dev libpng-dev libwebp-dev再重装php-gd
Nginx 连接 PHP-FPM 时出现502 Bad Gateway
90% 是listen配置与 Nginx fastcgi_pass不匹配，或权限问题。FPM 默认监听127.0.0.1:9000或/run/php/php*-fpm.sock，Nginx 必须严格对应。
关键检查点：
- 看
www.conf里的listen = /run/php/php8.2-fpm.sock，然后确认 socket 文件存在且 Nginx 用户（通常是www-data或nginx）有读写权限：ls -l /run/php/ - 若用 TCP 方式，
listen = 127.0.0.1:9000后，netstat -tlnp | grep :9000确认端口被 php-fpm 占用，且防火墙没拦（ufw status） - Nginx 配置中
fastcgi_pass必须完全一致：fastcgi_pass unix:/run/php/php8.2-fpm.sock;末尾分号不能丢，路径不能错一个字符 -
listen.owner和listen.group必须和 Nginx worker 进程用户一致，否则即使 socket 存在也连不上
socket 路径、用户组、SELinux 上下文（RHEL 系）这三处任何一个不严丝合缝，502就稳稳等着你。
