brew-php-switcher已停用，应使用Homebrew原生命令：brew install php@x.y安装多版本，通过brew unlink与brew link --force切换全局默认版本，并按项目用PATH前置法或bin/php脚本隔离PHP版本。
brew-php-switcher 这个工具在 2026 年已不再维护且无法正常工作——它依赖的旧版 Homebrew API 已被移除，安装后执行会报错 undefined method `formula_files' 或直接找不到命令。你不需要它，Homebrew 原生能力已足够干净、可靠地完成多版本 PHP 切换。
用 brew install php@x.y 直接安装多个独立版本
Homebrew 官方现在原生支持历史版本安装，无需额外 tap（如 exolnet/homebrew-deprecated 已过时）：
-
brew install php@8.0、brew install php@8.1、brew install php@8.2都可直接运行（截至 2026 年 4 月，php@8.3和php@8.4也已稳定） - 每个版本安装路径完全隔离：
/opt/homebrew/opt/php@8.1/bin/php（Apple Silicon）或/usr/local/opt/php@8.1/bin/php（Intel） - 不会覆盖系统自带 PHP，也不会互相干扰 —— 它们只是「待命的二进制文件」，不 link 就不生效
- 旧版本如
php@7.4或更早，Homebrew 默认不提供；若真需，应确认项目是否能迁移到 8.x，否则建议用phpbrew或容器方案，而非硬啃编译报错
用 brew unlink + brew link --force 切换全局默认版本
这是最轻量、无第三方依赖、且与所有 CLI 工具（Composer、Laravel Sail、WP-CLI）兼容的方式：
- 先断开当前链接：
brew unlink php（如果之前 link 过） - 再强制链接目标版本：
brew link --force php@8.2——--force是必须的，否则 Brew 拒绝覆盖已有php软链 - 验证是否生效：
which php应返回/opt/homebrew/bin/php，php -v显示对应版本 - 注意：此操作影响当前终端 session 及所有新打开的终端（因 shell 初始化时读取 PATH），但不影响已运行的后台进程（如正在跑的
php -S）
按项目固定 PHP 版本：PATH 前置法比 alias 更安全
把 alias php=/opt/homebrew/opt/php@8.1/bin/php 写进 ~/.zshrc 是危险的 —— 它会让所有项目、所有终端都强制走这个版本，极易误伤其他项目。
立即学习“PHP免费学习笔记（深入）”；
- 正确做法：在项目根目录下新建
.php-version文件，内容为8.1，然后在项目中执行：export PATH="/opt/homebrew/opt/php@8.1/bin:$PATH" - 更推荐封装成脚本：在项目
bin/下建一个可执行文件php，内容为：#!/bin/sh exec /opt/homebrew/opt/php@8.1/bin/php "$@"
，再chmod +x bin/php，最后export PATH="./bin:$PATH" - 这样做的好处：只对当前 shell 生效，不污染全局环境；IDE（如 PhpStorm）、Composer 的
platform.php设置、甚至composer install中调用的php都能正确识别 - 别忘了检查扩展：切换版本后，
pdo_mysql、opcache等扩展需重新启用 —— 修改对应版本的php.ini（路径如/opt/homebrew/etc/php/8.1/php.ini），而不是系统默认那个
切换后常见失效点：Web 服务、IDE、Composer 不同步
很多人切完 php -v 正确，但 Laravel artisan serve 或 Valet 仍报错，原因往往是其他组件没跟上：
- Valet 用户：必须用
valet use php@8.2（不是valet use 8.2），它会自动unlink/link并重启 Nginx + PHP-FPM；手动 link 后未运行该命令，Valet 仍用旧 FPM socket - IDE（如 PhpStorm）：设置 → PHP → Interpreter → 点「…」选对应
/opt/homebrew/opt/php@8.2/bin/php，否则调试器加载的是旧版本的扩展和配置 - Composer：运行
composer show php看 platform 版本；若 lock 文件锁死在 8.0，composer update --with-all-dependencies可能失败，需先改composer.json的"platform": {"php": "8.2"} - Web 服务器（Nginx/Apache）：它们调用的是 PHP-FPM，不是 CLI 的
php—— 切换 CLI 版本不会自动重启 FPM，必须手动brew services restart php@8.2
真正容易被忽略的是：PHP-FPM 配置文件里写的 php_admin_value[extension] 路径，和 CLI 的 extension_dir 不一致，会导致 Web 请求能跑、CLI 报 extension not found，或者反过来。每次切换版本，务必用 php -i | grep "extension_dir\|Loaded Configuration File" 核对两处是否指向同一目录。
