PHP版本控制如何应对突发故障

PHP版本切换必须用系统级工具（如update-alternatives或brew link），禁用手动改软链接，否则导致apt等系统工具异常；CLI切换不影响Web服务器，需单独配置Apache模块或php-fpm服务；php.ini路径和扩展ABI必须严格匹配对应版本。

PHP 版本切换必须用 update-alternatives（Linux）或 brew unlink/link（macOS）

直接改 /usr/bin/php 软链接或手动替换二进制文件，会导致系统工具（如 apt、dpkg）调用异常，尤其在 Debian/Ubuntu 上容易触发包管理器报错 php: command not found 或 Segmentation fault。官方推荐路径是通过系统级版本管理工具切换，确保所有关联符号链接和优先级一致。

• Debian/Ubuntu：运行 sudo update-alternatives --config php，选择对应版本编号；同时检查 phpize、php-config 是否同步切换（需分别执行 update-alternatives --config phpize 等）
• macOS + Homebrew：先 brew unlink php@8.1，再 brew link php@8.2；注意 brew link 可能因冲突失败，此时加 --force，但要确认无其他服务正依赖旧版本
• 切完立刻验证：php -v、which php、php --ini 三者输出必须指向同一安装路径，否则 extension_dir 加载会出错

Web 服务器里 PHP 版本不随 CLI 切换自动更新

Apache 的 libphp.so 或 Nginx 的 php-fpm 进程是独立加载的，CLI 切换对它们完全无效。突发故障若源于 PHP-FPM 崩溃或版本不匹配，不能只查 php -v。

• Apache：检查 a2query -m php 确认启用模块，再看 /etc/apache2/mods-enabled/php*.load 指向哪个版本；必要时重载模块：a2dismod php8.1 && a2enmod php8.2
• Nginx + php-fpm：重点查 ps aux | grep php-fpm 进程实际调用的二进制路径，再核对 systemctl status php8.2-fpm 状态；配置中 fastcgi_pass 必须匹配正确的 socket 或端口（如 127.0.0.1:9002 对应 8.2）
• 重启顺序不能错：先 systemctl restart php8.2-fpm（或对应服务），再 systemctl restart apache2 / nginx，否则可能卡在「502 Bad Gateway」

php.ini 加载路径混乱是 80% 的「版本看似切换成功却报错」根源

PHP 启动时按固定顺序查找 php.ini：编译时指定路径 → PHPRC 环境变量 → php --ini 显示的 Loaded Configuration File。突发故障常因旧 ini 文件残留导致 opcache、扩展、时区等配置未生效。

• 用 php --ini 查准位置，别信 /etc/php/8.1/cli/php.ini 就一定被加载；常见陷阱是 CLI 加载了 /etc/php/8.2/cli/php.ini，但 FPM 加载的是 /etc/php/8.2/fpm/php.ini，两者内容不同
• 修改后必须重启对应服务：改 CLI 配置只需重开终端；改 FPM 配置必须 systemctl reload php8.2-fpm（reload 比 restart 更安全，避免请求中断）
• 警惕 include_path 和 extension_dir：如果 extension_dir = "/usr/lib/php/20210902" 是 PHP 8.1 的模块目录，而当前是 8.2，就会报 Unable to load dynamic library 'redis.so'

紧急回滚不能只靠「换回旧版本」，得验证扩展兼容性

PHP 大版本升级（如 7.4 → 8.0）后回滚，不是简单切回 7.4 就能恢复——部分扩展（如 mongodb、grpc）的 so 文件与 PHP ABI 不兼容，强行加载会 Segfault。

• 回滚前先停服务，再用 php -m 记录当前已启用模块列表；然后 dpkg -l | grep php（Debian）或 brew list | grep php（macOS）确认旧版本包是否仍存在
• 卸载新版扩展：比如 sudo apt remove php8.2-mysql php8.2-curl，再装旧版对应包 php7.4-mysql；Homebrew 用户需 brew uninstall php@8.2 后 brew install php@7.4
• 最稳妥做法：用 php -d extension=redis.so -m 2>/dev/null | grep redis 逐个测试扩展能否加载，比直接启动服务更早暴露 ABI 错误

版本控制不是「换个命令就完事」，核心在于各组件（CLI、FPM、Apache/Nginx、扩展、ini）的路径与 ABI 必须严格对齐；任何一环脱节，都会让故障从「可预知」变成「不可解释」。