在macos上使用homebrew安装并切换php版本，核心做法是安装多个版本的formula并通过`brew link`命令控制当前生效的版本。执行`brew install php@8.1`和`brew install php@8.2`后，系统会保留所有已安装的版本，默认情况下最新安装的版本会自动链接到全局路径。若要手动切换，需先使用`brew unlink php@8.x`断开当前版本，再使用`brew link --overwrite php@8.y`链接目标版本，这样就能确保命令行调用的`php`指向你指定的版本。
如何并行安装多个PHP版本
Homebrew允许同时存在多个PHP版本，它们各自安装在独立的Cellar目录中，互不干扰。通过指定具体的版本号进行安装，可以构建一个本地开发环境，方便在不同项目间切换。例如，旧项目可能需要PHP 8.1，而新项目需要PHP 8.2，两者可以同时存在于你的Mac上。
brew update brew install php@8.1 brew install php@8.2
运行上述命令后，Homebrew会将`php@8.1`和`php@8.2`分别下载到`/opt/homebrew/Cellar/`（Apple Silicon）或`/usr/local/Cellar/`（Intel）目录下。此时，如果你直接运行`php -v`，通常会显示最后安装的那个版本，因为Homebrew默认将最新安装的版本链接到`/opt/homebrew/bin`等全局路径。这种并行安装机制避免了卸载旧版本带来的配置丢失风险。
立即学习“PHP免费学习笔记（深入）”；
如何手动切换当前生效的PHP版本
切换版本的关键在于管理符号链接。Homebrew通过`link`命令将特定版本的二进制文件映射到系统PATH中。要切换版本，必须先解除当前版本的链接，再链接新版本，并使用`--overwrite`参数处理可能存在的冲突文件。
# 假设当前链接的是 php@8.1，想切换到 php@8.2 brew unlink php@8.1 brew link --overwrite php@8.2 # 验证切换结果 php -v
执行`brew unlink php@8.1`后，全局路径下的`php`命令将失效或指向其他残留版本。紧接着执行`brew link --overwrite php@8.2`，Homebrew会在`/opt/homebrew/bin`下创建新的符号链接指向`php@8.2`的二进制文件。`--overwrite`选项非常重要，因为它允许覆盖之前可能存在的同名文件，确保切换干净利落。验证时，`php -v`应输出8.2的版本号。如果希望某个版本始终优先，也可以考虑修改Shell配置文件中的PATH顺序，但使用`brew link`是更标准且不易出错的方式。
切换后Composer依赖为何报错
在切换PHP版本后，许多开发者会发现之前通过Composer安装的依赖包无法正常运行，或者出现“Command not found”错误。这是因为Composer的全局二进制文件（如`vendor/bin/phpunit`）是在特定PHP版本下生成的，它们硬编码了当时使用的PHP解释器路径或扩展状态。当底层PHP版本切换后，这些预编译的二进制文件或缓存的配置不再兼容新版本的API或扩展结构。
# 在切换PHP版本后，清理并重新安装依赖 cd /path/to/your/project rm -rf vendor/ composer install # 如果使用的是全局Composer，也建议更新 composer self-update
解决这一问题的最直接方法是重新生成项目的依赖环境。删除`vendor`目录可以清除所有基于旧PHP版本编译的库文件和二进制脚本。运行`composer install`会让Composer根据当前激活的`php`版本重新下载并适配依赖。此外，如果项目中使用了特定的PHP扩展（如`intl`、`mbstring`），切换版本时需确保新版本的PHP Formula已经包含了这些扩展，通常Homebrew的PHP Formula默认启用了常用扩展，但可以通过`brew info php@8.2`查看具体启用的模块列表。若发现缺少关键扩展，可能需要重新安装该版本的PHP Formula以触发完整的扩展编译过程。
