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免费学习笔记（深入）”；
- 回滚前先停服务，再用
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 必须严格对齐；任何一环脱节，都会让故障从「可预知」变成「不可解释」。
