FrankenPHP 原生支持 Windows 了
FrankenPHP 是什么
FrankenPHP 是一个基于 Caddy 和 PHP 构建的现代 PHP 应用服务器,目标是简化 PHP 应用的运行与部署。它既可以作为传统 PHP 应用的运行环境,也提供了 Worker Mode、Hot Reloading 等更偏现代化的能力,因此这两年在 PHP 社区里关注度一直不低。
FrankenPHP 现已正式提供官方 Windows 支持,并立即可用。
自项目发布以来,Windows 原生支持一直是 FrankenPHP 社区呼声最高的需求之一。现在,这项能力已经正式落地。也就是说,FrankenPHP 已经可以在 Windows 上原生运行,并实现 100% 兼容,包括 Worker Mode、Hot Reloading 等核心特性。
性能表现
这次支持并不只是“能用”,性能表现也相当可观。社区已经给出了一些早期基准测试结果。
有用户在同一台 Windows Server 2022 机器上,将 FrankenPHP 与一个已经过优化的 Nginx/PHP-FPM 环境进行了对比。结果很直接:仅仅切换服务器运行时,就获得了 3.6 倍性能提升,增幅超过 260%。
此外,@henderkes 提供的一组更完整的基准测试,也进一步验证了 FrankenPHP 在 Windows 原生环境下、不同工作负载中的性能收益。
不过需要说明的是,原生 Windows 支持虽然已经足够快,在开发环境以及很多生产负载下也足够方便,但如果目标是追求更高的极限吞吐量,那么通过 WSL 运行 FrankenPHP 仍然更有优势,因为 Linux 在底层 I/O 和网络架构上依旧更强。如果生产环境允许,优先选择 Linux 仍然是更稳妥的方案。
难点:两个编译器体系的冲突
为什么这件事花了这么久?
实际上,此前已经有开发者尝试把 FrankenPHP 移植到 Windows。但除了常见的跨平台问题,例如文件路径和文件系统差异,更麻烦的是一个底层且结构性的兼容问题。
问题的核心可以概括为下面几点:
- FrankenPHP 是一个 Go 库,它通过 CGO 调用 PHP 的
libphp - Windows 上的官方 PHP 构建使用 Visual Studio(MSVC)编译,以保证性能和稳定性
- 但 Go 的 CGO 在 Windows 上长期不支持 Visual Studio,而是只支持 MinGW(GCC)
- 这就留下了一个巨大的兼容性鸿沟:两边根本无法直接链接在一起
解决路径
围绕这个问题,项目曾尝试过几种方案,但最终都没有走通。
方案一:让 Windows 版 PHP 支持 GCC
第一种思路,是给 PHP 打补丁,让 Windows 版 PHP 支持 GCC 编译。但 PHP 维护者并不希望为此引入额外复杂度,这一点并不难理解。另一方面,项目本身也希望直接使用官方二进制,以保证稳定性并避免生态分裂。
因此,依赖 Visual Studio(MSVC)之外的其他编译器并不可行。毕竟,MSVC 是 PHP 官方唯一支持的 Windows 编译器。
方案二:“Frankenstein” 构建方案(llvm-mingw)
第二种思路是折中方案:使用 llvm-mingw 编译 FrankenPHP,再把它链接到官方 Visual Studio 编译的 PHP。
这个方案最终失败,原因是 标准库不匹配。
当你把 MinGW 编译出来的二进制(使用 msvcrt.dll 或自己的运行时)与 MSVC 编译出来的二进制(使用 ucrt / vcruntime)混在一起时,就会遇到严重问题。比如一侧分配内存(malloc),另一侧去释放;或者尝试跨边界传递文件描述符,程序都会直接崩溃。
本质上,它们说的是两种不同方言的 “C”。
突破点:Go 1.26 与 clang
最终,项目找到了更合理的路径:为 CGO 增加对 Visual Studio 提供的 Clang/LLVM 前端的支持。
可以简单理解为,Visual Studio 自带一套 Clang,它可以作为 MSVC 编译器(cl.exe)的替代实现来工作。它接受 CGO 更适配的 GCC 风格参数,同时底层又使用微软的 STL 和运行时库。
也就是说,它结合了两边的优点。
在调研现有方案、准备给 Go 提交补丁的过程中,项目方还发现 Google 其实已经提交过一份非常关键、但几乎没有公开说明的实现,处理的正是这个问题。
这份补丁最终进入了 Go 1.26。
借助 Go 新增的这项能力,再配合 lld-link 链接器,我们终于能够使用与 PHP 本身相同的工具链来编译 FrankenPHP。
测试结果
最终的成果,是拿到了一个 原生 Windows 二进制,并且它直接链接到 PHP 官方提供的稳定版本二进制。
更关键的是,因为链接的是官方 PHP 构建,所以所有 Windows 上受支持的原生 PHP 扩展,在 FrankenPHP 中都能直接工作,无需额外适配。
在处理完 Windows 特有的一些细节后,FrankenPHP 代码库也完成了相应更新。目前可以确认:全部测试均已通过。
- ✅ 原生 Windows 二进制
- ✅ 完整扩展支持
- ✅ Worker Mode
- ✅ Hot Reloading
致谢与赞助
这项复杂工作之所以能够完成,要感谢 Intelligence X 和 Les-Tilleuls.coop 的慷慨赞助。
开源项目的可持续性并不容易。如果团队或公司依赖 FrankenPHP、Caddy 或 API Platform,可以考虑通过 GitHub 提供赞助。类似支持,往往也是这类底层技术问题能够持续推进的重要前提。
现在就可以使用
这项支持已经合并到 Pull Request #2119,最新版 Windows 二进制也已经可以从发布页直接下载。
原文最后也特别感谢了参与调研和实现的开发者,尤其是 @TenHian 在早期探索阶段的工作,以及 @henderkes 在最终实现中投入的大量精力。
如果日常主要在 Windows 上开发 PHP,现在已经可以直接试用 FrankenPHP。 FrankenPHP 原生支持 Windows 了