Linux下PHP环境搭建与FPM配置教程

本文深入解析了Linux环境下PHP-FPM配置的常见痛点与实战要点，从“php-fpm命令找不到”这一高频问题切入，厘清CLI与FPM SAPI的本质区别，并针对Ubuntu/Debian、CentOS/RHEL及Rocky/AlmaLinux等主流发行版提供精准的安装策略；进一步拆解php.ini与www.conf的职责边界，警示upload_max_filesize误配、多pool socket冲突等典型陷阱；同时系统梳理模块加载失败的根因（如php-mysql包缺失、extension语法错误、系统依赖缺失），并直击Nginx+PHP-FPM联调中最令人抓狂的502 Bad Gateway问题——聚焦listen配置、socket权限、用户组匹配及SELinux上下文三重严丝合缝要求，堪称一份避坑指南级的运维实操手册。

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、用户权限）。两者不替代，要分清作用域。

容易踩的坑：

• 把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就稳稳等着你。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。