最轻量可控的PHP版本切换方式是用brew unlink + brew link --force，需先断开旧链接再强制链接目标版本（如php@8.2），并单独重启PHP-FPM服务以确保CLI与Web环境一致。
直接用 brew link --force 切换是最轻量、最可控的方式，不需要额外工具或全局 alias，也不会污染 shell 配置——但必须配合 brew unlink 清理旧链接，否则会出错。
确认已安装的 PHP 版本有哪些
Homebrew 不会自动列出带 @ 符号的版本，得手动筛：
-
brew list | grep php@—— 输出类似php@8.1、php@8.2、php@8.3 - 如果没看到想用的版本（比如缺
php@8.0），先运行brew install php@8.0；注意：5.6 及更老版本 Homebrew 已彻底移除，无法安装 - 每个版本实际装在独立路径，如 Apple Silicon 上是
/opt/homebrew/opt/php@8.2/bin/php，Intel 是/usr/local/opt/php@8.2/bin/php
用 brew unlink + brew link --force 切换 CLI 版本
这是最干净的切换方式，只影响当前终端 session 的 php 命令，不改 PATH、不写配置文件：
- 先断开所有已链接的 PHP：
brew unlink php（注意不是php@8.x） - 再强制链接目标版本：
brew link --force php@8.2（--force必须加，否则报 “Linking is not permitted”） - 验证：
which php应返回/opt/homebrew/bin/php，php -v显示对应版本 - ⚠️ 常见错误：
bash: /usr/local/bin/php: No such file or directory—— 说明 unlink 后没 link 新版本，或 link 失败但没报错
切换后 CLI 和 Web 服务（PHP-FPM/Apache）不是一回事
你改了 php -v 的输出，并不代表网页里 phpinfo() 也跟着变：
立即学习“PHP免费学习笔记（深入）”；
- CLI 模式走的是
brew link设置的php命令 - PHP-FPM 是独立服务，需单独重启：
brew services restart php@8.2（不能用php@8.1的服务去跑php@8.2的代码） - Apache 如果用的是系统自带模块（
libphp.so），它根本不认 Homebrew 的 PHP —— 这种组合基本不可靠，建议统一用 Nginx + PHP-FPM - 查当前生效的配置：
php --ini看Loaded Configuration File路径，确保你在改的是这个php.ini
别让扩展和配置跨版本复用
PHP 扩展（如 pdo_mysql、xdebug）是编译绑定到具体 PHP 版本的，混用必报错：
-
PHP Warning: PHP Startup: Unable to load dynamic library 'pdo_mysql'—— 典型就是用了php@8.1的php.ini，却加载了php@8.2编译的 so 文件 - 每个版本的扩展路径不同：
/opt/homebrew/lib/php/pecl/20220829/（8.2） vs/opt/homebrew/lib/php/pecl/20210902/（8.1） - 切版本后必须重装扩展：
pecl install xdebug（它会自动匹配当前php版本） - 别图省事复制整个
ext目录或共用一个php.ini—— 路径、INI 指令支持度、默认值都可能不同
真正容易被忽略的点是：PHP-FPM 配置里的 php_admin_value[extension] 或 php_ini 路径，一旦写死就绕过 brew link 的切换逻辑。每次切版本，最好顺手检查 php-fpm.d/www.conf 和 php --ini 是否一致。
