直接下载官方二进制、配环境变量、加Caddyfile即可运行FrankenPHP,无需Docker或PHP/Caddy;下载解压frankenphp.exe,添加至PATH,执行frankenphp --version验证,再建项目目录并写index.php。

直接下载官方二进制,配好环境变量,再加一个 Caddyfile 就能跑起来,不需要 Docker、不用装 PHP 或 Caddy,整个过程 3 分钟内可完成。
下载并安装 FrankenPHP 二进制
访问 frankenphp.dev,进入 Downloads 页面,选择 Windows 版本(通常是frankenphp-windows-amd64.zip 或 frankenphp-windows-arm64.zip)。
解压后得到单个可执行文件 frankenphp.exe。
把它放到一个固定目录,比如 C:\tools\frankenphp\,然后将该路径添加到系统环境变量 PATH 中(控制面板 → 系统 → 高级系统设置 → 环境变量 → 系统变量 → Path → 编辑 → 新建)。
验证是否成功:
打开新终端(CMD 或 PowerShell),运行frankenphp --version
看到类似 frankenphp v1.2.0 的输出即表示安装完成。
创建项目并配置 Caddyfile
新建一个空文件夹作为项目根目录,例如D:\myapp。
在该目录下新建一个 index.php:
```php
再在同一目录下创建 Caddyfile(无后缀,注意大小写):{
frankenphp
}
localhost {
root * ./public
php_server {
try_files {path} /index.php
}
encode zstd br gzip
}⚠️ 如果你没建 public 目录,就把 root <em> ./public</em> 改成 root .,并确保 index.php 在项目根目录。
启动服务并访问
进入项目目录,运行:frankenphp run默认监听 <a href="https://www.php.cn/link/cbb686245ece57c9827c4bc0d0654a8e">https://www.php.cn/link/cbb686245ece57c9827c4bc0d0654a8e</a>(不是 80,避免管理员权限)。
用浏览器打开 <a href="https://www.php.cn/link/cbb686245ece57c9827c4bc0d0654a8e">https://www.php.cn/link/cbb686245ece57c9827c4bc0d0654a8e</a>,即可看到页面输出。
如果想改端口,可以加参数:
frankenphp run --addr :3000 → 访问 <a href="https://www.php.cn/link/8e5687e2d6ab87e5da2f833f3e8986a4">https://www.php.cn/link/8e5687e2d6ab87e5da2f833f3e8986a4</a>
常见问题处理
- 提示“找不到 php_server 指令”:确认 Caddyfile 第一行有{ frankenphp },且未被注释。
- 访问空白或 404:检查 index.php 是否在 root 指向的目录里;Caddyfile 中的路径是相对项目根目录的。
- HTTPS 自动启用失败:Windows 下 Caddy 默认不自动申请公网证书(因 localhost 不支持 Let’s Encrypt),如需本地 HTTPS,可手动配置自签名证书,或暂用 HTTP 开发。
- 想运行 Laravel/Symfony 等框架:把框架的 public/ 设为 root,php_server 会自动处理路由转发(无需额外 rewrite 规则)。
不复杂但容易忽略。
立即学习“PHP免费学习笔记(深入)”;



















