FrankenPHP v1.4 在 macOS 上编译需预装 Xcode 命令行工具（CLT），通过 xcode-select --install 安装并执行 sudo xcodebuild -license accept 接受许可，再验证 clang、pkg-config（≥0.29）、git 版本是否合规。
FrankenPHP v1.4 需要本地具备 clang、make、git 和 pkg-config 等底层构建工具才能编译扩展或运行 PHP 原生模块，而 macOS 默认不预装这些组件——必须通过 Xcode 命令行工具（CLT）提供完整支持。
确认当前系统是否已就绪
打开终端，执行：
xcode-select -p
若输出 【/Library/Developer/CommandLineTools】，说明 CLT 已安装且路径正确；
若提示 error: invalid active developer path 或无任何输出，则必须安装；
若输出指向 /Applications/Xcode.app/Contents/Developer，但你并未安装完整 Xcode，此路径无效，需重置。
用终端一键触发官方安装（首选）
这一步直接调用苹果签名的安装包，无需登录、不依赖网络策略，适配当前 macOS Sequoia 15.4 系统。
立即学习“PHP免费学习笔记（深入）”；
在终端中输入：
xcode-select --install
系统弹出窗口显示“无法找到软件包”，点击「安装」；
阅读许可协议后点「同意」；
安装过程无进度条，终端光标会暂停响应约 2–4 分钟，请勿关闭窗口或强制退出——中断会导致头文件缺失，FrankenPHP 后续编译时会报 fatal error: 'stdio.h' file not found。
验证并激活许可
安装完成后，立即执行：
xcode-select -p
确认输出为 【/Library/Developer/CommandLineTools】；
再运行：
sudo xcodebuild -license accept
这步不可跳过：FrankenPHP 的构建脚本（如 make build）在调用 xcrun 时会严格检查许可证状态，未接受则直接终止，报错信息为 Agreeing to the Xcode/iOS license requires admin privileges。
手动下载安装包（仅当自动失败时启用）
适用于企业网络屏蔽弹窗、MDM 管控禁用安装器、或系统反复提示“正在搜索软件包”超过 5 分钟的情况。
方法一：访问 Apple Developer Downloads 页面
用 Apple ID 登录 https://developer.apple.com/download/all/；
搜索 Command Line Tools for Xcode 15.4（必须与 macOS Sequoia 15.4 严格匹配）；
下载后双击 Command_Line_Tools_for_Xcode_15.4.dmg → 运行其中的 .pkg 安装器。
方法二：终端快速校验安装结果
依次执行：
clang --version → 应输出 Apple clang version 15.0.0；
pkg-config --version → FrankenPHP v1.4 构建阶段强依赖此项，低于 0.29 会失败；
git --version → 若为 2.39+，可安全运行 frankenphp install 命令。
