FrankenPHP v1.4 在M2 Mac上运行失败主因是架构不匹配、Gatekeeper拦截或依赖缺失；必须使用arm64二进制，右键“打开”或清除quarantine标记绕过拦截，并验证file输出为Mach-O arm64及otool -L无not found。
在M2芯片Mac上运行FrankenPHP v1.4，核心问题不是“兼容性好不好”，而是**架构匹配是否正确、系统安全策略是否绕过、依赖是否完整**——v1.4本身完全支持Apple Silicon，但下错包或卡在Gatekeeper拦截，就会表现为“打不开”“Operation not permitted”或“exec format error”。
确认你下载的是 arm64 架构二进制
FrankenPHP v1.4 官方已不再提供通用（fat）二进制包，【M2芯片必须用 frankenphp-darwin-arm64.tar.gz】。Intel版（darwin-amd64）或Linux版（linux-arm64）在M2上直接执行会报 exec format error 或 Bad CPU type in executable。
验证方法：解压后终端执行 file frankenphp，输出中必须含 arm64；若出现 x86_64 或 ELF，说明包选错了。
常见踩坑：从旧文档链接下载了已被下架的通用包，或误用 Homebrew 默认源拉取的非 arm64 版本（尤其当 Homebrew 路径是 /usr/local 而非 /opt/homebrew 时）。
立即学习“PHP免费学习笔记（深入）”；
绕过 macOS Gatekeeper 拦截
FrankenPHP v1.4 的预编译二进制未经过 Apple 公证（notarized），macOS 13+ 会直接拒绝执行，【chmod +x 完全无效】——这不是权限问题，是内核级拦截。
方法一：右键“打开”（推荐首次验证）
Finder 中右键点击 frankenphp → 选择“打开” → 弹窗点“仍要打开”。系统仅对该文件豁免一次，之后 ./frankenphp 或双击均可运行。
方法二：命令行清除隔离标记（适合脚本化部署）xattr -d com.apple.quarantine frankenphp。注意：此命令只对 Safari / Chrome 下载的文件有效；若用 curl 或 wget 获取，需先执行 open -a Finder . 触发 quarantine 标记再清除。
检查两个隐藏失败前提
第一步：确认没被同名脚本覆盖
运行 which frankenphp，再执行 file $(which frankenphp)。输出必须是 Mach-O 64-bit executable arm64；若显示 shell script，说明 PATH 中存在冲突脚本，删掉或重命名即可。
第二步：验证动态库依赖是否就位
FrankenPHP v1.4 若启用了 QUIC 支持，会依赖 libbpf.dylib。用 otool -L frankenphp 查看，若某行末尾标有 not found，运行 brew install libbpf 补齐。
