需先执行 brew tap dunglas/tap 添加官方 tap，再运行 brew update && brew upgrade frankenphp 升级；若 brew info frankenphp 显示未安装或无 formula，则当前非 Homebrew 安装，不适用此流程。
将 macOS 上已安装的 FrankenPHP 从 v1.2.0 升级到最新稳定版，需明确：FrankenPHP 并未收录于 Homebrew 官方主仓库（homebrew-core），而是通过其官方维护的自定义 tap 发布，直接运行 brew upgrade frankenphp 会报错“no available version”或提示未安装——因为默认 brew 不知道该软件的存在。
确认当前 FrankenPHP 安装来源
在终端中执行：
brew info frankenphp
若输出含 Not installed 或提示 “No available formula”，说明你当前并非通过 Homebrew 安装的 FrankenPHP，后续升级不适用本流程；若显示类似 From: https://github.com/dunglas/homebrew-tap/blob/.../frankenphp.rb，则确认来自官方 tap，可继续。
添加并更新 FrankenPHP 的官方 tap
FrankenPHP 的 Homebrew 支持由作者 Dunglas 维护在独立仓库中。必须先引入该 tap 才能识别和升级：
立即学习“PHP免费学习笔记（深入）”；
brew tap dunglas/tap
这一步不可跳过，否则 brew 根本找不到 FrankenPHP 的版本定义文件。未执行此命令就尝试 upgrade，终端只会返回 “Error: No such keg: /opt/homebrew/Cellar/frankenphp”。
执行升级操作
完成 tap 添加后，运行以下命令一次性完成索引刷新与升级：
brew update && brew upgrade frankenphp
【注意：必须先 brew update，否则可能仍卡在 v1.2.0】 因为 tap 的新版本信息只在 update 时拉取，跳过会导致 upgrade 无感知变化。
升级完成后，验证版本：
frankenphp --version
输出应为类似 FrankenPHP v1.3.1 (commit abc123) 的新版号。
