Intel架构Mac安装FrankenPHP v1.4必须下载darwin-amd64包、绕过Gatekeeper拦截、验证PHP扩展真实启用、校验$_SERVER关键字段一致性，否则服务启动即500或静默退出。
Intel架构Mac安装FrankenPHP v1.4时，必须确认二进制包为darwin-amd64架构、绕过Gatekeeper拦截、验证PHP扩展实际启用状态，并检查$_SERVER关键字段是否与Laravel/Symfony等框架的运行假设一致，否则服务启动后立即报500或静默退出。
下载正确CPU架构的二进制包
访问 FrankenPHP v1.4.0 GitHub Release 页面，手动下载 frankenphp-darwin-amd64.tar.gz —— Apple Silicon（M1/M2/M3）用户下错包会触发 exec format error，Intel Mac 下错 arm64 包同样报错，且错误不可恢复。
禁止使用 curl + install.sh 脚本一键安装：该脚本默认拉取 amd64 版本，但未做 CPU 架构校验，在部分 Homebrew 环境或 CI 中可能意外 fallback 到通用包或旧镜像源，导致下载到非 amd64 文件。
验证方式：解压后执行 file frankenphp，输出必须含 Mach-O 64-bit executable x86_64；若出现 arm64 或 data 字样，说明文件损坏或架构错误。
立即学习“PHP免费学习笔记（深入）”；
绕过macOS Gatekeeper强制拦截
FrankenPHP v1.4 官方二进制未通过 Apple 公证（notarized），macOS 10.15+ 会在内核层直接拒绝加载，表现为 Operation not permitted，此时 chmod +x 完全无效。
方法一：右键“打开”（推荐首次验证）
在 Finder 中右键点击 frankenphp → 选择“打开” → 弹窗点“仍要打开”。系统仅对该文件豁免一次，后续 ./frankenphp 可正常执行。
方法二：命令行清除隔离标记（适合脚本化部署）xattr -d com.apple.quarantine frankenphp。注意：此命令仅对 Safari/Chrome 下载的文件生效；若用 curl -O 获取，需先执行 open -a Finder . 触发 quarantine 标记再清除。
方法三：禁用 Gatekeeper（仅限离线开发机）sudo spctl --master-disable，然后前往「系统设置→隐私与安全性→安全性」勾选“任何来源”。生产环境严禁启用此项，它会全局削弱系统防护能力。
确认PHP扩展真实启用状态
FrankenPHP v1.4 内置 PHP 8.3 运行时，但默认只启用 json、mbstring、xml 等基础扩展；pdo_mysql、redis、intl 等 Laravel/Symfony 必需扩展需手动开启，否则访问首页即报 Class 'PDO' not found 或 composer install 失败。
第一步：确认当前生效的 php.ini 路径
执行 frankenphp php-cli -i | grep 'Loaded Configuration File'，输出类似 /usr/local/etc/php/8.3/franken/php.ini —— 这才是 FrankenPHP 实际读取的配置文件，不是系统级 /etc/php/*/cli/php.ini。
第二步：编辑该 php.ini，取消对应扩展前的分号注释
例如启用 MySQL 支持：将 ;extension=pdo_mysql 改为 extension=pdo_mysql；启用 Redis 需用兼容包：extension=redis（必须搭配 php8.3-franken-redis.so，不能直接复制系统 redis.so）。
第三步：验证扩展是否真正加载
运行 frankenphp php-cli -r "print_r(get_loaded_extensions());"，检查输出中是否包含 pdo_mysql、redis、intl 等字符串。若缺失，说明 php.ini 路径改错、拼写错误（如 pdo_mysql.so ≠ pdo_mysql），或扩展文件根本不存在于 extension_dir 目录下。
校验$_SERVER关键字段行为一致性
FrankenPHP 不经 FastCGI，而是由 Caddy 直接构造 $_SERVER，v1.4 对 REQUEST_URI、SCRIPT_NAME、HTTPS 的默认赋值逻辑与 Nginx+PHP-FPM 存在差异，Laravel 的 url('/') 或 Symfony 的 generateUrl() 可能生成 http:// 协议链接或错误 host，造成重定向死循环。
在项目 public/index.php 顶部插入调试代码：var_dump(array_intersect_key($_SERVER, array_flip(['REQUEST_URI', 'HTTPS', 'HTTP_X_FORWARDED_PROTO', 'SCRIPT_NAME', 'SERVER_PORT']))); exit;
对比 Nginx+PHP-FPM 环境下的输出：v1.4 默认将 SCRIPT_NAME 设为 /index.php（旧版常为空），HTTPS 默认为 off（即使反向代理传了 X-Forwarded-Proto: https，也需在 Caddyfile 中显式配置 header_up X-Forwarded-Proto {http.request.header.X-Forwarded-Proto}）。
Laravel 用户必须额外验证：
启动 tinker：frankenphp php-cli artisan tinker，执行 url('/') 和 request()->fullUrl()，确认协议、host、端口全部正确；若返回 http://localhost:8080/ 而非预期的 https://app.test/，需在 .frankenphp.router.php 中手动覆盖：
$_SERVER['HTTPS'] = 'on';<br>$_SERVER['HTTP_X_FORWARDED_PROTO'] = 'https';
