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 的libphpWindows 上的官方 PHP 构建使用 Visual StudioMSVC编译以保证性能和稳定性但 Go 的 CGO 在 Windows 上长期不支持 Visual Studio而是只支持 MinGWGCC这就留下了一个巨大的兼容性鸿沟两边根本无法直接链接在一起解决路径围绕这个问题项目曾尝试过几种方案但最终都没有走通。方案一让 Windows 版 PHP 支持 GCC第一种思路是给 PHP 打补丁让 Windows 版 PHP 支持 GCC 编译。但 PHP 维护者并不希望为此引入额外复杂度这一点并不难理解。另一方面项目本身也希望直接使用官方二进制以保证稳定性并避免生态分裂。因此依赖 Visual StudioMSVC之外的其他编译器并不可行。毕竟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 了