FrankenPHP在macOS Sonoma安装失败主因是Gatekeeper拦截未公证二进制（chmod +x无效）及which frankenphp返回shell脚本而非真实Mach-O文件；需右键“打开”豁免、xattr清除quarantine或sudo spctl --master-disable启用“任何来源”，并确认file $(which frankenphp)输出为Mach-O且otool -L无not found依赖。
macOS 14 Sonoma 安装 FrankenPHP v1.3 时，最常卡在“双击无反应”或终端报 Operation not permitted——这不是权限没加，而是 Gatekeeper 拦截了未公证的二进制，chmod +x 完全无效；同时系统自带 PHP 8.1+ 与 FrankenPHP 的共存路径容易冲突，导致 which frankenphp 找到的是 shell 脚本而非真实 Mach-O 可执行文件。
确认系统环境是否满足前提
先打开终端，逐条执行：
运行 sw_vers 确认系统确实是 macOS 14（Sonoma）；如果不是，后续所有操作都可能失败。
执行 which php，输出必须是 /usr/bin/php 或 Homebrew 的 /opt/homebrew/bin/php，不能是其他路径下的脚本。若输出为空，先运行 export PATH="/usr/bin:$PATH" 临时修复 PATH。
立即学习“PHP免费学习笔记（深入）”；
【关键检查】 运行 file $(which frankenphp) ——如果返回 shell script，说明你本地已有同名脚本（比如从旧教程复制的启动脚本），它会覆盖真正的 FrankenPHP 二进制，必须删掉或重命名该脚本，否则后续所有命令都会静默失败。
下载与绕过 Gatekeeper 的三种方式
方法一：右键“打开”（推荐首次验证）
在 Finder 中找到下载好的 frankenphp 文件 → 右键 → 选择“打开” → 弹窗点“仍要打开”。系统仅对该文件豁免一次，之后 ./frankenphp 和双击均可执行。
方法二：命令行清除隔离属性（适合重复部署）
进入下载目录，执行：xattr -d com.apple.quarantine frankenphp。注意：此命令只对 Safari/Chrome 下载的文件有效；若用 curl 下载，需先执行 open -a Finder . 触发 quarantine 标记，再清除。
方法三：禁用 Gatekeeper（仅限可信开发机）
执行 sudo spctl --master-disable，然后前往「系统设置→隐私与安全性→安全性」，勾选“任何来源”。⚠️ 此操作会削弱整机防护，生产环境严禁使用。
验证二进制可用性与依赖
第一步：确保可执行并识别架构
执行 chmod +x frankenphp && ./frankenphp version。若成功输出 v1.3.x，则说明 Gatekeeper 已绕过且二进制完整。
第二步：检查动态库依赖（Sonoma 常见坑）
运行 otool -L frankenphp，重点看输出中是否有 not found 条目。FrankenPHP v1.3 启用 QUIC 时默认链接 libbpf.dylib，若缺失，执行 brew install libbpf 补齐。跳过这步可能导致服务启动后立即退出，无任何错误提示。
第三步：确认没被系统 PHP 干扰
FrankenPHP v1.3 自带 PHP 8.5 运行时，但如果你在项目里写了 #!/usr/bin/env php 类型的 shebang 脚本，它仍会调用系统 PHP。如需强制走 FrankenPHP 内置 PHP，请改用 ./frankenphp eval "echo 'ok';" 测试执行链。
启动 Laravel 项目的关键配置
进入你的 Laravel 项目根目录（含 public/ 子目录），执行以下操作：
① 创建最小 Caddyfile：
用文本编辑器新建文件 Caddyfile，内容为：
{ frankenphp }localhost { root * public/ php_server}
② 确保 public/index.php 存在且可读（执行 ls -l public/index.php，权限至少为 -rw-r--r--）。
③ 运行 ./frankenphp（不带任何子命令）。此时它会自动加载 Caddyfile，启用 HTTPS、HTTP/2 和 HTTP/3。首次访问 https://localhost 时浏览器会提示证书不安全，手动接受即可。
【关键注意】 不要用 frankenphp php-server --document-root public/ 启动——这个子命令不启用 HTTPS/HTTP/3，也不读取 Caddyfile，只是纯 PHP 执行层，和传统 php-fpm 类似，完全浪费了 FrankenPHP 的核心优势。
