Ubuntu/Debian官方源截至2026年4月仍未收录PHP 8.4，必须添加ondrej/php PPA源后安装php8.4及相关扩展，并通过update-alternatives切换版本；若用Nginx需严格校验php-fpm的socket权限与监听配置，否则易报502错误。
php -v 报错或版本不对，基本是没装对、路径没配好，或者系统源里压根没有 PHP 8.4 —— Ubuntu/Debian 官方源至今（2026年4月）仍未收录 PHP 8.4，Rocky/Kylin 等发行版也需手动加第三方源或源码编译。直接 apt install php 肯定装不到 8.4，别试。
Ubuntu/Debian 上装 PHP 8.4 只能靠 ondrej/php 源
系统默认 apt 源最高只到 PHP 8.3（24.04）或 8.1（22.04），要上 8.4 必须加第三方 PPA：
- 先装基础工具：
sudo apt install software-properties-common - 加源：
sudo add-apt-repository ppa:ondrej/php - 更新并安装：
sudo apt update && sudo apt install php8.4 php8.4-cli php8.4-fpm php8.4-mysql php8.4-mbstring php8.4-curl php8.4-gd php8.4-zip - 切版本（如果已有其他 PHP）：
sudo update-alternatives --set php /usr/bin/php8.4
⚠️ 注意：ondrej/php 源虽稳定，但和系统 Apache/Nginx 的 libapache2-mod-php 或 php-fpm 配置可能有路径冲突；若用 Nginx，务必检查 /etc/php/8.4/fpm/pool.d/www.conf 中的 listen 和权限设置，否则 502 错误高发。
源码编译 PHP 8.4：依赖和 configure 参数不能漏
编译失败八成卡在依赖缺失或参数不匹配。PHP 8.4 强制要求 oniguruma（正则引擎）、libzip、freetype、webp 等，缺一个就报 configure error。
- Debian/Ubuntu：
sudo apt install build-essential autoconf automake libtool pkg-config libxml2-dev libsqlite3-dev libcurl4-openssl-dev libssl-dev libjpeg-dev libpng-dev libfreetype6-dev libwebp-dev libzip-dev libonig-dev - Rocky/Kylin：
sudo dnf groupinstall "Development Tools" && sudo dnf install libxml2-devel openssl-devel curl-devel libjpeg-devel libpng-devel freetype-devel libwebp-devel libzip-devel oniguruma-devel - 关键 configure 参数必须带：
--enable-fpm --with-fpm-user=www-data --with-fpm-group=www-data --enable-mbstring --with-curl --with-openssl --with-zlib --with-mysqli --with-pdo-mysql --enable-gd --with-jpeg --with-webp --with-freetype --with-zip --with-bz2 - 别漏
--with-config-file-path=/usr/local/php/etc，否则php.ini找不到位置，扩展全失效
编译后记得复制默认配置：cp /usr/local/php/etc/php-fpm.conf.default /usr/local/php/etc/php-fpm.conf，再改 www.conf 里的用户、监听方式（推荐 listen = /run/php/php8.4-fpm.sock）。
立即学习“PHP免费学习笔记（深入）”；
PHP-FPM 启不来？重点查 listen.owner 和 socket 权限
systemctl status php8.4-fpm 显示 active 但 Nginx 返回 502，问题几乎全出在 Unix socket 权限上。
- 确认 FPM 进程用户和 socket 所属一致：
grep -E "user =|group =|listen.owner|listen.group" /etc/php/8.4/fpm/pool.d/www.conf - 常见组合：
user = www-data、group = www-data、listen.owner = www-data、listen.group = www-data - socket 文件路径必须可写：
ls -l /run/php/，若不存在或权限不对，手动创建：sudo mkdir -p /run/php && sudo chown www-data:www-data /run/php - Nginx 配置中
fastcgi_pass必须与 FPM 的listen完全一致，比如fastcgi_pass unix:/run/php/php8.4-fpm.sock;
别信“改完配置 reload 就行”——FPM socket 是启动时创建的，systemctl restart php8.4-fpm 才生效，reload 不重建 socket。
扩展装了但 phpinfo() 不显示？优先看 mods-available 和 enmod
Ubuntu/Debian 下用 apt 安装的扩展（如 php8.4-mysql）会自动写进 /etc/php/8.4/mods-available/，但不会自动启用。
- 检查是否已生成配置：
ls /etc/php/8.4/mods-available/ | grep mysqli - 启用它：
sudo phpenmod -v 8.4 mysqli（CLI/FPM 都要分别启用） - 源码安装的扩展得手动加
extension=xxx.so到php.ini，且路径必须绝对准确，比如：extension=/usr/local/php/lib/php/extensions/no-debug-non-zts-20240924/swoole.so -
php -m | grep mysqli和php -i | grep "Loaded Configuration File"是最直接的验证手段
最易忽略的一点：PHP-FPM 和 CLI 用的是两套配置文件，php -v 正常不代表 php-fpm 加载了相同扩展——必须分别验证。
