要彻底卸载Homebrew安装的FrankenPHP v1.4，需用brew uninstall frankenphp（非--cask），它会删除主程序及显式依赖，但保留配置文件和手动安装的PHP；随后清理缓存、配置及残留软链接。
要彻底卸载通过Homebrew安装的FrankenPHP v1.4，必须明确它属于formula（命令行工具）而非cask（GUI应用），因此不能用brew uninstall --cask，否则命令会静默失败且残留文件。
确认FrankenPHP是否由Homebrew安装
在终端中执行：brew list | grep frankenphp。如果返回frankenphp，说明已通过Homebrew安装；若无输出，则可能为手动编译或通过其他方式部署，本文后续步骤不适用。
卸载FrankenPHP主程序及关联依赖
执行命令：brew uninstall frankenphp。该操作会自动移除frankenphp formula本身及其直接依赖（如php@8.3等被frankenphp显式声明的依赖），但不会删除你手动安装的、未被其formula声明的PHP版本或其他扩展。
这一步完成后，【/opt/homebrew/bin/frankenphp 和 /opt/homebrew/Cellar/frankenphp/1.4.x 目录将被完全删除】，但配置文件（如frankenphp.yaml）和项目工作目录不受影响，需手动清理。
立即学习“PHP免费学习笔记（深入）”；
清除残留配置与缓存
第一步：检查并删除自定义配置文件。常见位置包括当前用户家目录下的~/.frankenphp.yaml或项目根目录中的frankenphp.yaml，请根据实际使用情况决定是否保留或删除。
第二步：清理Homebrew下载缓存中frankenphp的bottle包：brew cleanup frankenphp。该命令会立即释放磁盘空间，避免旧版本安装包堆积。
第三步：验证是否残留可执行文件。运行which frankenphp，若返回空行，说明卸载完成；若仍输出路径（例如/usr/local/bin/frankenphp），说明存在非Homebrew管理的软链接，需手动执行rm -f $(which frankenphp)删除。
