最省事路径是用Ondřej Surý的PPA（Ubuntu/Debian）或LNMP一键包（CentOS）安装PHP 8.2，避免源码编译导致的版本冲突、扩展缺失和权限错误；Ubuntu需加PPA、清理旧PHP、安装php8.2-fpm等核心包并设为默认，Nginx配置须严格匹配PHP-FPM监听地址，上传大文件需同步调大Nginx与PHP的body_size及超时参数。
直接在腾讯云 CVM 或轻量服务器上装 PHP 8.2，别自己编译源码——90% 的坑都出在版本冲突、扩展缺失或权限错配上。用 Ondřej Surý 的 PPA（Ubuntu/Debian）或 LNMP 一键包（CentOS）是最快最稳的路径。
Ubuntu/Debian 上装 PHP 8.2 并设为默认
腾讯云 Ubuntu 实例（如 22.04/24.04）默认仓库不带 PHP 8.2，必须加第三方源。Ondřej 的 PPA 是事实标准，稳定、更新快、扩展全。
- 先清理旧 PHP：
sudo apt purge php* -y（避免php8.1和php8.2模块混装导致502 Bad Gateway） - 加源并更新：
sudo add-apt-repository ppa:ondrej/php→sudo apt update - 装核心 + 常用扩展：
sudo apt install php8.2 php8.2-fpm php8.2-cli php8.2-mysql php8.2-curl php8.2-mbstring php8.2-xml php8.2-zip php8.2-gd - 设为默认：
sudo update-alternatives --set php /usr/bin/php8.2（别改/usr/local/bin/php软链，那是 LNMP 包用的） - 确认生效：
php -v输出应含8.2.x，php-fpm -v同理
Nginx 配置 PHP 8.2 时 502 Bad Gateway 怎么快速定位
不是 PHP 没装好，而是 Nginx 找不到 PHP-FPM 进程或 socket 权限不对。LNMP 默认用 unix:/tmp/php-cgi.sock，但 Ubuntu + apt 装的 php8.2-fpm 默认监听 127.0.0.1:9000，不一致就炸。
- 查 PHP-FPM 是否运行：
sudo systemctl status php8.2-fpm，若 inactive 就sudo systemctl start php8.2-fpm - 查监听地址：
sudo grep "listen =" /etc/php/8.2/fpm/pool.d/www.conf，常见值是127.0.0.1:9000或/run/php/php8.2-fpm.sock - Nginx 配置里
fastcgi_pass必须严格匹配：若 PHP-FPM 监听127.0.0.1:9000，Nginx 就写fastcgi_pass 127.0.0.1:9000；若监听 socket，就写fastcgi_pass unix:/run/php/php8.2-fpm.sock - socket 权限问题：若用 unix socket，确保
listen.owner = www-data且listen.group = www-data，Nginx worker 用户也得是www-data
哪些扩展在 PHP 8.2 下要手动处理
不是所有扩展都开箱即用。Ubuntu 官方源和 Ondřej PPA 覆盖大部分，但仍有几个高频踩坑点：
把一个已有 git 仓库装配成"TAPD 故事 → feature 分支 → PR → CNB AI 代码评审 → 合入 main → TAPD 故事自动回写 commit"的闭环工程挽具（harness）。适用于腾讯云 CNB（cnb.cool）+ TAPD 组合的团队。触发场景：(1) 用户要求把 git 仓库接入 CNB 和/或 TAPD；(2) 要求 commit/PR 自动关联 TAPD 故事；(3) 要求启用 CNB AI 代码评审（cnbcool/ai-review）；(
立即学习“PHP免费学习笔记（深入）”；
-
yaml：Ubuntu 22.04/24.04 的php-yaml包默认没进主源，需手动装：sudo apt install php8.2-yaml（PPA 已提供） -
redis：php8.2-redis存在，但如果你用的是 PECL 自编译版或 Windows.dll，PHP 8.2 的 ABI 变了，旧redis.so会报undefined symbol: zend_string_release_ex -
mcrypt：PHP 7.2 起已移除，PHP 8.2 彻底不可用，必须改用sodium或openssl -
ext/mysql（mysql_connect()）：PHP 7.0 废弃、8.0+ 彻底删除，老项目必须重写为mysqli或PDO
上传大文件失败？HTTPS 下 client_max_body_size 和 post_max_size 必须对齐
腾讯云 CVM 本身不限制上传大小，但 Nginx + PHP 的两层限制常不同步，尤其开 HTTPS 后更容易静默失败（页面空白、无错误日志）。
- Nginx 层：在
server块加client_max_body_size 100m（别只放http块，子配置可能覆盖） - PHP 层：改
/etc/php/8.2/fpm/php.ini中三处：upload_max_filesize = 100M、post_max_size = 100M、max_execution_time = 300 - 关键动作：改完必须
sudo systemctl reload php8.2-fpm（不是restart），再sudo nginx -t && sudo systemctl reload nginx - 验证：上传一个 50MB 文件，看是否返回 413、502 或超时；查
/var/log/nginx/error.log和/var/log/php8.2-fpm.log里的拒绝记录
最易被忽略的是 PHP-FPM 的 security.limit_extensions —— 默认只允许 .php，如果项目用了 .phtml 或自定义后缀，上传的文件会被拒，错误日志里只有 Access denied 四个字，不提后缀限制。
