切换PHP版本需同步更新Web服务器模块或php-fpm进程、CLI路径及扩展，Apache需匹配架构与编译器并重启服务，Nginx需调整fastcgi_pass和php-fpm配置，Homebrew和Docker提供多版本共存机制，扩展必须按版本重装。
Windows 或 macOS 上用 XAMPP、MAMP、Docker、Homebrew 或手动编译搭建的 PHP 本地环境，切换版本不是改个配置就能生效——多数情况下需要明确终止旧进程、启用新二进制、并确保 Web 服务器（如 Apache/Nginx）和 CLI 使用的是同一套 PHP。
Apache + mod_php 场景下切换 PHP 版本
这是 XAMPP、WampServer 等集成包的默认模式。PHP 被编译为 Apache 模块（libphp.so 或 php8.dll），必须匹配 Apache 的架构（32/64 位）和编译器（VC15/VC17）。直接替换 php.ini 或修改 PATH 无效。
- 确认当前加载的模块路径：
httpd.conf中查找LoadModule php_module行，它指向具体phpX.dll或libphp.so - 下载对应 Apache 版本、架构、VC 版本的 PHP 二进制包（如
php-8.2.12-Win32-vs16-x64.zip），解压后替换php/目录，并更新httpd.conf中的LoadModule和PHPIniDir - 重启 Apache：仅 reload 不够，必须
httpd -k stop再httpd -k start，否则旧模块仍驻留内存 - 验证：访问
phpinfo()页面，检查Loaded Configuration File和PHP Extension Build是否匹配新版本
PHP-FPM + Nginx 场景下切换 PHP 版本
Nginx 不内置 PHP 解析，依赖外部 php-fpm 进程。切换本质是换掉 php-fpm 服务及其配置引用的二进制。
- 停止当前
php-fpm：查进程ps aux | grep php-fpm，用kill -QUIT或systemctl stop php-fpm（取决于启动方式） - 修改
php-fpm.conf中的pid、error_log路径，避免与旧版本冲突；关键项是include = /usr/local/etc/php/8.1/php-fpm.d/*.conf—— 改成目标版本路径 - 启动新版本
php-fpm：显式指定配置文件，例如/usr/local/bin/php-fpm82 -y /usr/local/etc/php/8.2/php-fpm.conf - Nginx 配置中确认
fastcgi_pass指向正确的 socket 或端口（如127.0.0.1:9002），不同版本建议用不同端口避免冲突
CLI 和 Web 一致性的校验方法
很多人只改了 CLI 的 PATH，但 Web 仍跑旧版，或反之。必须两端独立验证：
立即学习“PHP免费学习笔记（深入）”；
- CLI：运行
which php+php -v+php -i | grep "Configuration File" - Web：建一个
info.php，内容为<?php phpinfo(); ?>
，浏览器访问，重点看三处：PHP Version、Loaded Configuration File、Registered PHP Streams（含https表示 OpenSSL 已加载，常因版本错配失效） - 若不一致，常见原因是：Apache 用的是模块路径，而
PATH指向另一个 PHP；或 Nginx 的fastcgi_param SCRIPT_FILENAME路径没随版本更新，导致脚本解析失败
Homebrew（macOS）和 Docker 的快捷切换逻辑
Homebrew 和 Docker 是少数真正支持「多版本共存+按需启用」的方案，但机制完全不同。
- Homebrew：
brew install php@8.1 php@8.2 php@8.3后，用brew unlink php再brew link php@8.2切换 CLI；Apache 需手动改httpd.conf加载对应libphp.so（路径如/opt/homebrew/opt/php@8.2/lib/httpd/modules/libphp.so） - Docker：不切换宿主机 PHP，而是改
Dockerfile的FROM php:8.2-apache或docker-compose.yml中的image: php:8.3-cli；每次docker-compose up --build启动全新容器，天然隔离 - 注意：
brew services start php@8.2启动的是 FPM，不是 Apache 模块；Docker 容器内php -v和宿主机无关，别在容器外查版本
最易被忽略的是扩展兼容性：PHP 8.2 编译的 redis.so 无法在 PHP 8.3 下加载，错误信息是 undefined symbol: zend_new_interned_string。切换版本后，务必重新 pecl install 或从对应版本的 ext/ 目录编译扩展。
