当前位置: 首页 > news >正文

FrankenPHP 原生支持 Windows 了

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 了

http://www.jsqmd.com/news/445390/

相关文章:

  • 基于微服务的网络课程教学平台的设计与实现
  • 2026年口碑好的卫状硅胶包胶厂家推荐:奶瓶硅胶包胶/硅胶包胶制品/汽车用品硅胶包胶厂家热卖产品推荐(近期) - 行业平台推荐
  • Poppler for Windows:PDF处理的一站式解决方案
  • 2026年正规的太仓做网站公司推荐:太仓网站推广/太仓外贸网站企业服务推荐企业 - 行业平台推荐
  • 2026年推荐太仓网站设计公司推荐:太仓官网建设/太仓外贸网站口碑推荐服务平台 - 行业平台推荐
  • 别再被忽悠了!搞懂这100个硬核黑话,秒变自动驾驶老司机
  • IDE评估周期管理器:JetBrains工具试用期优化方案 | 开发者全平台效率工具
  • 2026年靠谱的日用品硅胶包胶厂家推荐:汽车用品硅胶包胶/母婴用品硅胶包胶厂家实力参考 - 行业平台推荐
  • 开发工具系列---【Antigravity Skills 如何全局安装与项目配置】
  • 数据安全与效率的双重颠覆:Umi-OCR如何通过离线引擎重构OCR技术生态
  • 告别AI算力圈“局外人”的100词手册
  • 告别光学设计繁琐计算:Inkscape光线追踪扩展带来绘图革新
  • 2026年知名的呼吸面罩品牌推荐:医用呼吸面罩/有氧呼吸面罩高评分品牌推荐(畅销) - 行业平台推荐
  • 【C++】C++模板特化:精准定制泛型逻辑 - 实践
  • 2026年比较好的呼吸面罩品牌推荐:医用呼吸面罩厂家采购参考指南 - 行业平台推荐
  • 【并发心法】扯下 volatile 的遮羞布:从中断风暴到无锁队列 (Lock-Free Queue),重塑 C++ 极客的内存屏障观
  • 小户型健身不将就|小户型适合的健身器材,小空间也能练出好状态 - 冠顶工业设备
  • 如何优化USB网卡驱动性能?6大核心技术方案解析
  • 2026年质量好的真空除氧器厂家推荐:热力除氧器/无头除氧器/高压除氧器用户好评厂家推荐 - 行业平台推荐
  • 4步构建游戏化编程教育平台:教师专属的互动式教学解决方案
  • 2026年比较好的输送带检测技术厂家推荐:全自动输送带检测/水泥厂输送带检测厂家实力哪家强 - 行业平台推荐
  • 2026年质量好的无头除氧器品牌推荐:真空除氧器厂家实力参考 - 行业平台推荐
  • 2026年知名的扶手调角器品牌推荐:折叠桌调角器/汽车座椅调角器/轨道交通座椅调角器厂家采购参考指南(必看) - 行业平台推荐
  • 2026年比较好的锅炉消音器厂家推荐:管道消音器/小孔消音器/复合式消音器热门厂家推荐汇总 - 行业平台推荐
  • 高效掌握Harepacker-resurrected:从零基础到应用的MapleStory文件编辑全指南
  • 2026年评价高的汽车座椅调角器品牌推荐:特种车辆座椅调角器厂家最新推荐 - 行业平台推荐
  • 学术写作自动化工具:GB/T 7714-2015 CSL样式库使用指南
  • 三级网络知识
  • 微信防撤回功能版本适配解决方案:DLL补丁动态适配技术指南
  • 如何通过Ketcher实现化学结构高效编辑?开源工具完整探索指南