FrankenPHP在macOS上执行失败主因是Gatekeeper拦截未公证二进制，chmod +x无效；需右键“打开”临时豁免、xattr清除quarantine标记或sudo spctl --master-disable禁用Gatekeeper。
FrankenPHP独立二进制在macOS上直接执行失败，不是因为没加执行权限，而是系统拒绝加载未公证（notarized）的可执行文件——chmod +x完全无效。
为什么双击或 ./frankenphp 会报 Operation not permitted
macOS 10.15+ 默认启用 Gatekeeper 策略：任何非 App Store、非 Apple Developer ID 签名且未提交 Apple 公证的二进制，内核会在 execve() 阶段直接拦截，错误表现为 Operation not permitted 或静默退出。FrankenPHP 官方发布的预编译二进制（尤其是 GitHub Releases 下载的）默认未公证，因此必然触发该限制。
- 这不是文件权限问题：
ls -l frankenphp显示-r-xr-xr-x也无用 - 也不是 PATH 或别名问题：用
file $(which frankenphp)可确认是否真为 Mach-O 二进制 - Homebrew 安装通常不报错，是因为它走的是本地源码编译（
brew install frankenphp），生成的二进制属于“本机构建”，绕过公证检查
三种实操可行的绕过方式（按推荐顺序）
临时验证用右键“打开”，长期开发建议清除 quarantine 标记，仅测试机可关 Gatekeeper：
-
右键“打开”（最安全，推荐首次试运行）：在 Finder 中右键点击
frankenphp→ 选择“打开” → 弹窗点“仍要打开”。系统会为该文件单独豁免一次，后续双击或./frankenphp均可执行 -
命令行清除下载标记（适合 CI/脚本化）：
xattr -d com.apple.quarantine frankenphp。仅对 Safari / Chrome 下载的文件有效；若从 curl/wget 获取，需先用open -a Finder .触发 quarantine 再清除 -
禁用 Gatekeeper（仅限可信开发机）：
sudo spctl --master-disable，然后在“系统设置→隐私与安全性→安全性”中勾选“任何来源”。注意：这会削弱整机防护，生产环境严禁使用
运行前必须确认的两个隐藏前提
即使绕过 Gatekeeper，以下两点不满足仍会导致 Permission denied 或立即退出：
立即学习“PHP免费学习笔记（深入）”；
-
确保没被同名 shell 脚本覆盖：运行
which frankenphp，再执行file $(which frankenphp)。输出应含Mach-O 64-bit executable x86_64或arm64；若显示shell script，说明当前 PATH 里有冲突脚本，需删掉或重命名 -
检查系统级动态库依赖是否就位：macOS 不支持
ldd，改用otool -L frankenphp。重点关注是否有not found条目，比如libbpf.dylib缺失（常见于启用了 QUIC 的构建版本）。若缺失，需安装对应库：brew install libbpf，或用--no-quic参数重建二进制
Caddyfile 和 php.ini 怎么生效
FrankenPHP 二进制本身不打包 Caddyfile 或 php.ini，它们是运行时加载的：
-
Caddyfile必须放在当前工作目录（./Caddyfile），或通过-config /path/to/Caddyfile显式指定；Laravel/Symfony 用户注意 root 路径必须设为public/，且php_server指令需启用 -
php.ini是硬编码进二进制的（路径如/usr/local/lib/php.ini），无法用-c参数替换。若需调内存或开扩展，只能在构建阶段传--php-ini，或改用自定义构建流程
真正卡住人的从来不是“怎么跑起来”，而是以为 chmod +x 就完事，结果卡在 Gatekeeper 和动态库这两个看不见的环节。macOS 上每一步都得确认 file 输出类型、otool -L 依赖、以及是否真被系统放行——三者缺一不可。
