快速了解在 Windows 11 上切换 PHP 版本的核心原理
核心原理
要点：在 Windows 11 的命令解析中，系统会先搜索 PATH 环境变量中的目录，php.exe 的优先级取决于 PATH 中的位置。通过把不同版本的 php.exe 放在独立目录，并灵活调整 PATH，可以实现同一台机器上多版本共存的能力。
本节聚焦于理解通过修改 PATH 和使用包装脚本来实现“快速切换 PHP 版本”的核心物理机制，这对于后续的实际操作打下基础。
为什么需要多版本管理
兼容性：不同项目可能依赖不同的 PHP 版本，尤其是 PHP 7.x 与 PHP 8.x 的行为差异会直接影响脚本执行结果。
开发效率：把版本控制和切换逻辑本地化，可以在不同项目之间快速调整开发环境，避免全局升级带来的破坏性变更。
准备工作：在 Windows 11 上安装多版本 PHP
下载与解压
来源：从官方 Windows 二进制包下载页面获取所需版本的 ZIP 包，例如 PHP 7.4、8.0、8.1。
解压位置：将每个版本解压到独立目录，如 C:\php\php-7.4.33 与 C:\php\php-8.1.0，确保目录结构干净且互不覆盖。
目录结构与命名约定
命名规范：版本号要清晰，避免使用同名覆盖，方便后续通过脚本引用对应路径。
对 CLI 与 Web 服务器各自的 php.exe、php.ini、扩展目录要保持一致的映射，避免在不同项目中产生混淆。
创建可切换的环境变量方案
使用批处理脚本切换 PATH
核心思路：通过一个 switch-php.bat 脚本把选定版本的目录路径放到 PATH 的前端，使该版本的 php.exe 在命令行中成为首选解释器。
持续性与即时性：当前会话中的 PATH 修改能即时生效，但若要永久生效需结合 setx 将 PATH 保存到用户变量中。
维护版本信息与路径
维护清单：在同一个目录下维护一个版本-路径映射表，便于新增、删除版本以及排错时快速定位路径。
通过统一的映射，后续扩展就能以版本号作为入口进行切换，而不是逐个记忆物理路径。
实操：一步步切换到目标 PHP 版本
步骤1：准备工作
准备：确认下载的各版本目录结构完整，包含可执行文件 php.exe、必要的扩展目录以及配置文件 php.ini（如有自定义配置需求）。
注意：确保系统 PATH 中没有冲突的其他 php.exe 位置，避免优先级错位导致切换无效。
步骤2：执行切换脚本
脚本设计：通过一个 switch-php.bat 来实现版本切换。以下代码示例展示了基本思路，便于你直接应用。
@echo off
REM switch-php.bat
setlocalset "PHP7=C:\php\php-7.4.33"
set "PHP8=C:\php\php-8.1.0"set "TARGET=%~1"if "%TARGET%"=="7.4" (set "PATH=%PHP7%;%PATH%"set "PHP_HOME=%PHP7%"
) else if "%TARGET%"=="8.1" (set "PATH=%PHP8%;%PATH%"set "PHP_HOME=%PHP8%"
) else (echo Usage: switch-php.bat 7.4^|8.1goto :eof
)echo Switched to PHP version %TARGET% at %PHP_HOME%
echo Current PATH: %PATH%
goto :eof
执行方式：在命令行中运行 switch-php.bat 7.4 或 switch-php.bat 8.1，PATH 会在当前会话中被调整。
步骤3：验证
快速验证：执行 php -v，应显示所切换版本的详细信息。
验证与排错
验证命令
快速定位：打开新的命令提示符，执行 where php 查看当前使用的 php.exe 的实际路径；随后执行 php -v 确认版本信息。
如果输出的仍然是旧版本，可能是 PATH 的前置位置仍未被新版本覆盖，需要再一次在当前会话中手动调整 PATH，或重启命令行窗口。
常见问题与解决
问题1：切换后仍显示旧版本。
解决：确保切换脚本修改的是 PATH 的前部内容，或在当前命令行中执行 set PATH=C:\php\php-8.1.0;%PATH% 立即生效。
日常使用与进阶技巧
区分 CLI 与 Web 服务器使用的 PHP
CLI 与 Web：CLI 通过 php.exe 运行，Web 服务器（如 IIS/Apache）可能使用各自的解释器或 CGI/模块，需要在服务器端同样对版本进行管理，以确保网页端和命令行端行为一致。
为 Web 端切换版本时，确保服务器配置指向正确的 php-cgi.exe 或相应模块路径，以及相应的 php.ini 设置和扩展目录。
自动化与版本管理扩展
自动化：将切换脚本与项目工作流挂钩，例如在进入某个项目目录时自动执行切换命令，或把切换作为 IDE 启动脚本的一部分。
更高级的用法是将版本切换纳入持续集成/开发工具链，在本地即能按项目需求运行对应 PHP 版本的命令。
