frankenphp v1.4 在 macos 报 command not found，主因是 path 未包含二进制路径或存在同名脚本覆盖；需用 which、file 验证路径与类型，通过 export path 或移至 homebrew bin 永久修复，并右键打开或 xattr 清除隔离标记以绕过 gatekeeper。
FrankenPHP v1.4 在 macOS 终端输入 frankenphp 提示 command not found，不是因为没下载二进制，而是系统根本找不到可执行文件路径——它可能被放在 Downloads 文件夹里吃灰，也可能被 PATH 忽略，还可能被同名脚本悄悄覆盖。
确认二进制是否真在系统里
先查有没有这个命令：运行 which frankenphp。如果返回空行，说明 shell 完全不认识它；如果返回类似 /Users/xxx/Downloads/frankenphp 的路径，说明文件存在但不在 PATH 中。
接着验证那个路径是不是真正的 FrankenPHP 二进制：运行 file $(which frankenphp)。输出必须含 【Mach-O 64-bit executable】 字样；若显示 shell script 或 text executable，说明你 PATH 里混入了一个同名的 shell 脚本，得立刻删掉或重命名。
PATH 没包含安装路径是最常见原因
方法一：临时加路径（适合快速验证）
假设二进制在 ~/Downloads/frankenphp，直接运行：export PATH="$HOME/Downloads:$PATH"，再试 frankenphp -v。
方法二：永久加入 PATH（推荐长期使用）
先确认 Homebrew 安装位置：brew --prefix，通常为 /opt/homebrew（Apple Silicon）或 /usr/local（Intel）。把二进制移到那里：sudo mv ~/Downloads/frankenphp /opt/homebrew/bin/，然后重新打开终端或运行 source ~/.zshrc。
注意：不要用 chmod +x 后就往 /usr/bin 硬塞——macOS SIP 会阻止写入系统目录，且 Gatekeeper 仍会拦截未公证二进制。
绕过 Gatekeeper 才能真正执行
即使 PATH 正确、文件可执行，macOS 仍会因未公证报 Operation not permitted。此时 which 和 file 都正常，但一运行就失败。
第一步：在 Finder 中找到 frankenphp 文件 → 右键 → 选择“打开” → 弹窗点“仍要打开”。这一步只为该文件单独豁免一次，后续终端里 ./frankenphp 或 frankenphp 都能跑通。
第二步（可选）：彻底清除 quarantine 标记，避免每次重启都重复右键。
终端进入二进制所在目录，运行：xattr -d com.apple.quarantine frankenphp。这命令只对 Safari/Chrome 下载的文件有效；若用 curl 下载，需先 open -a Finder . 触发标记再清除。
第三步（仅开发机）：禁用 Gatekeeper 全局策略：sudo spctl --master-disable，然后去「系统设置→隐私与安全性→安全性」勾选“任何来源”。【此操作会削弱整机防护，生产环境严禁使用】
检查是否被其他 frankenphp 占位
运行 type -a frankenphp，若输出多行，例如：
frankenphp is /opt/homebrew/bin/frankenphpfrankenphp is /usr/local/bin/frankenphpfrankenphp is /Users/me/bin/frankenphp
说明有多个同名命令，shell 默认调用第一个。用 ls -l $(which frankenphp) 看它实际指向哪个文件，再比对 file 输出确认是否为 v1.4 的 Mach-O 二进制。
如果发现是旧版本或错误路径，用 unalias frankenphp 2>/dev/null; unset -f frankenphp 2>/dev/null 清除别名和函数干扰，再重新配置 PATH。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
