frankenphp是用go编写的嵌入php解释器的web服务器，非传统php扩展，windows上通过下载预编译二进制（frankenphp.exe）并配置php nts x64路径即可运行，不支持phpize/make源码编译。
FrankenPHP 不是传统 PHP 扩展，也不是通过 phpize + make 编译安装的 C 扩展。它是一个**用 Go 编写的、嵌入 PHP 解释器的 Web 服务器**——本质是二进制可执行文件（frankenphp.exe），**无需编译源码，也不依赖 Visual Studio 或 MSVC 工具链**。
你在 Windows 11 上要“安装” FrankenPHP，实际就是下载预编译二进制、配置好 PHP 运行时路径、启动服务。下面直说关键点。
为什么不能像扩展一样 phpize/make？
FrankenPHP 的核心是 Go 程序调用 PHP 的 SAPI（libphp.a 或 DLL），但官方**不提供 Windows 下的 PHP 静态库或构建脚本**，也未公开支持在 Windows 上从源码构建。所有 Windows 官方发布版均为 Go 交叉编译好的独立 .exe，已内嵌适配的 PHP 运行时（如 PHP 8.2/8.3 NTS x64）。你试图运行 make 或 cmake 会立刻失败，因为缺少 php_config、头文件路径、链接目标等——这不是配置问题，而是项目本身不支持 Windows 源码构建。
正确安装步骤：下载 + 关联 PHP + 启动
你需要做三件事，且顺序不能错：
- 从 GitHub Releases 页面 下载最新
frankenphp-windows-amd64.zip（确认是amd64，不是386） - 解压后，确保你的 PHP 安装是 NTS（Non-Thread Safe）x64 版本（CLI 模式用，
php -v输出含NTS；phpinfo()中Thread Safety显示disabled） - 把 PHP 的
ext目录路径写进frankenphp.yaml（或用--php-ext-dir参数），否则扩展加载失败（如mysqli,pdo_mysql会报 “unable to load dynamic library”） - 运行前检查：PHP 的
php.ini必须在 PHP 安装根目录（frankenphp.exe默认只读该位置），且extension_dir路径必须为绝对路径（如extension_dir = "C:/php/ext"），相对路径会被忽略
常见启动失败原因与对应修复
直接双击或命令行运行 frankenphp.exe 报错？先看错误类型：
-
failed to load PHP extension: ... mysqli.dll: The specified module could not be found.→ 缺少php-mysql依赖 DLL（如libmysql.dll或ssleay32.dll），把它们复制到frankenphp.exe同目录，或加到系统PATH -
PHP Startup: Unable to load dynamic library 'xxx' (tried: ...)→php.ini中extension=行启用的 DLL 文件名拼写错误，或该 DLL 不匹配当前 PHP 版本（如 PHP 8.3 用了 8.2 的redis.dll） - 浏览器打开
http://localhost:8080显示空白或 500 → 检查frankenphp.yaml中document_root是否指向含index.php的真实目录，且该目录有读取权限（Windows 下尤其注意 NTFS 权限） - 启动后立即退出，无日志 → 用管理员权限打开 PowerShell，运行
.\frankenphp.exe --help，若提示 “not a valid Win32 application”，说明你下了 x86 版本，而系统是 x64；反之亦然
和 XAMPP/WAMP 的关键区别：不要混用 Apache
FrankenPHP 自带 HTTP 服务器（基于 net/http），不需要、也不兼容 Apache 或 Nginx。如果你已启动 XAMPP 的 Apache，它会占掉 80 端口，导致 frankenphp.exe 启动失败（listen tcp :80: bind: address already in use）。解决方法只有两个：
— 改 frankenphp.yaml 的 server.port（如设为 8080）；
— 或彻底关闭 Apache 服务（XAMPP Control Panel → Apache → Stop）。别试图让 Apache 反向代理 FrankenPHP —— 官方明确不推荐，且容易触发 SAPI 冲突。
FrankenPHP 在 Windows 上的“安装”本质是配置驱动的二进制部署，真正容易卡住的地方从来不是下载，而是 PHP 运行时环境的细节匹配：NTS/x64 必须对齐、php.ini 路径必须硬编码为绝对路径、扩展依赖 DLL 必须显式放置——这些在 Linux 上由包管理器隐式处理，但在 Windows 上全得你手动钉死。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
