# 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 了
](https://catchadmin.com/post/2026-03/frankenphp-windows-support)

FrankenPHP 是一个基于 Caddy 和 PHP 构建的现代 PHP 应用服务器，目标是简化 PHP 应用的运行与部署。它既可以作为传统 PHP 应用的运行环境，也提供了 Worker Mode、Hot Reloading 等更偏现代化的能力，因此这两年在 PHP 社区里关注度一直不低。

FrankenPHP 原生支持 Windows 了

后端

编程语言

开发工具

FrankenPHP正式支持Windows原生运行，性能提升显著，基准测试显示比Nginx/PHP-FPM快3.6倍。支持WorkerMode、HotReloading等核心功能，100%兼容Windows环境。解决Go与PHP编译器体系冲突难题，通过Go1.26实现稳定运行。现已提供官方Windows二进制下载，适合PHP开发者直接试用。

文件系统

服务器

编译器

Windows

GitHub

Linux

4核4G3M云服务器 新用户低至38元/年！

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

FrankenPHP正式支持Windows原生运行，性能提升显著，基准测试显示比Nginx/PHP-FPM快3.6倍。支持WorkerMode、HotReloading等核心功能，100%兼容Windows环境。解决Go与PHP编译器体系冲突难题，通过Go1.26实现稳定运行。现已提供官方Windows二进制下载，适合...

FrankenPHP 原生支持 Windows 了-腾讯云开发者社区-腾讯云

FrankenPHP 原生支持 Windows 了

FrankenPHP 原生支持 Windows 了

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐