如何配置Ubuntu系统安装并启用PHP8.2-FPM服务？

本文共计900个文字，预计阅读时间需要4分钟。

要在Ubuntu 22.04上安装PHP 8.2-FPM，您需要手动指定包名并启用第三方PPA源。以下是一步一步的指导：

为什么 apt install php8.2-fpm 失败？缺 PPA 源

Ubuntu 官方仓库不提供 PHP 8.2，ondrej/php PPA 是事实标准。没加源就直接 apt install php8.2-fpm，会报 E: Unable to locate package php8.2-fpm。

• 先执行：sudo add-apt-repository ppa:ondrej/php（按回车确认）
• 再更新：sudo apt update
• 此时才能装：sudo apt install php8.2-fpm php8.2-cli php8.2-mysql php8.2-mbstring php8.2-xml php8.2-curl php8.2-gd php8.2-zip
• 别装 libapache2-mod-php8.2——它和 php8.2-fpm 冲突，Nginx 用户必须避开

php-fpm 命令找不到？不是 PATH 问题，是根本没装对包

which php-fpm 返回空，或 systemctl status php8.2-fpm 报 Unit php8.2-fpm.service not found，说明你只装了 CLI 版本（比如只运行了 apt install php8.2-cli），FPM SAPI 根本没进系统。

• 检查是否真装了 FPM：dpkg -l | grep php8.2-fpm —— 没输出就是漏装
• FPM 二进制在 Ubuntu 上叫 php-fpm8.2，不是 php-fpm；服务名是 php8.2-fpm，不是 php-fpm
• 装完立刻验证：sudo systemctl is-active php8.2-fpm 应返回 active
• 若 inactive，先试配置语法：sudo php-fpm8.2 -t，比 start 更早暴露 www.conf 里的拼写错误

启动失败：No such file or directory for /run/php/php8.2-fpm.sock

这个错误不是配置写错了，是 /run/php/ 目录不存在或权限不对。systemd 临时文件系统不会自动创建子目录。

立即学习“PHP免费学习笔记（深入）”；

• 手动建目录：sudo mkdir -p /run/php
• 设属主：sudo chown www-data:www-data /run/php（Apache/Nginx 默认用 www-data 用户跑 PHP）
• 确认 /etc/php/8.2/fpm/pool.d/www.conf 中 listen = /run/php/php8.2-fpm.sock 路径与 Nginx 的 fastcgi_pass 完全一致
• 改完 reload：sudo systemctl reload php8.2-fpm（不是 restart，reload 才重读 socket 配置）

Nginx 连不上：502 Bad Gateway 或 phpinfo() 不显示扩展

502 几乎全是 fastcgi_pass 和 listen 不匹配；phpinfo() 缺扩展则大概率是扩展没启用，而非没安装。

• Nginx 配置里必须用 fastcgi_pass unix:/run/php/php8.2-fpm.sock（注意路径和 sock 文件名），不能写成 /var/run/php/... —— Ubuntu 默认是 /run/php/
• 扩展如 mbstring 装了包（php8.2-mbstring）后，还需启用：sudo phpenmod mbstring，再 sudo systemctl reload php8.2-fpm
• php -m | grep mbstring 看是否在列表里；php --ini 确认加载的 php.ini 路径，避免改错文件
• 别把 upload_max_filesize 写进 www.conf——它只认 php_admin_value[upload_max_filesize] 形式，否则无效

最常被跳过的一步：装完 php8.2-fpm 后，不检查 /run/php/ 目录是否存在、不运行 phpenmod 启用扩展、也不验证 fastcgi_pass 路径是否和 listen 完全一致——这三个点卡住 90% 的人。