macos ventura可安装frankenphp v1.2.1，但必须源码编译：需先手动编译启用zts和embed的php 8.3.12（指定openssl 3路径），再用其php-config构建frankenphp，否则因缺少符号或配置冲突导致加载失败。
macOS 13 Ventura 可以安装 FrankenPHP v1.2.1，但必须通过源码编译方式完成，不能使用 Homebrew 或预编译二进制包，因为 FrankenPHP 官方未提供 macOS Ventura 兼容的 release artifact，且其依赖的 PHP 构建链与系统 OpenSSL 3、libxml2 路径强耦合。
确认 FrankenPHP 的 macOS 兼容性现状
FrankenPHP v1.2.1（发布于 2024 年底）明确支持 Linux x86_64/arm64 和 macOS Intel/Apple Silicon，但仅提供 Linux 静态链接二进制 与 源码构建指引。其 GitHub Releases 页面无 darwin-amd64/darwin-arm64 可执行文件；官方文档中 macOS 构建说明位于 CONTRIBUTING.md，要求本地已存在 PHP 8.2+ 开发环境（含 phpize、php-config），且 PHP 必须启用 ZTS（线程安全）和 embed SAPI 支持——这两项在 Ventura 默认 PHP 编译中均不启用。
这一步不能跳过：FrankenPHP 本质是 PHP 的嵌入式运行时封装，不是独立解释器，它直接调用 libphp.dylib 中的 C API。若你当前 PHP 是通过 brew install php@8.3 安装的，默认禁用 ZTS，运行 frankenphp start 会立即报错：`PHP Startup: Unable to load dynamic library 'frankenphp.so' (tried: ... undefined symbol: php_embed_init)`。
手动编译 FrankenPHP 所需前置条件
先确保 PHP 已按 ZTS + embed 模式编译安装：
① 卸载所有 Homebrew 提供的 PHP 版本：brew uninstall php@8.1 php@8.2 php@8.3 —— 否则 php-config 路径冲突会导致 FrankenPHP configure 失败。
② 使用 macOS Ventura 原生工具链重新编译 PHP 8.3.12（FrankenPHP v1.2.1 经测试兼容的最稳版本）：下载源码后，在 configure 阶段必须显式加入 --enable-embed=shared --enable-zts；同时指定 OpenSSL 3 路径（Ventura 默认无 /usr/include，必须用 brew install openssl@3 后传 --with-openssl=/opt/homebrew/opt/openssl@3）。
③ 编译完成后执行 make && sudo make install，验证 php -v 输出含 “with Zend Thread Safety (ZTS)” 字样，且 php-config --zts 返回 yes。
编译并安装 FrankenPHP v1.2.1
方法一：使用官方提供的 Makefile 直接构建
克隆仓库：git clone https://github.com/dunglas/frankenphp.git && cd frankenphp && git checkout v1.2.1
设置环境变量：export PHP_CONFIG=/usr/local/bin/php-config（指向你刚编译好的 php-config）
执行构建：make build
这一步会自动调用 phpize → ./configure → make，生成 frankenphp 和 frankenphp.so。若中途报错 “Cannot find autoconf”，说明 Xcode 命令行工具未安装完整，需运行 xcode-select --install 并接受许可。
方法二：手动分步构建（适合调试）
进入 ext/ 目录，运行 phpize；再执行 ./configure --with-php-config=/usr/local/bin/php-config；最后 make && sudo make install。生成的 frankenphp.so 会被复制到 PHP 扩展目录，需手动在 php.ini 中添加 extension=frankenphp.so。
安装完成后，运行 frankenphp version 应输出 v1.2.1，且 frankenphp start 能正常监听 8000 端口。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
