FrankenPHP 在 Windows 系统该怎么快速搭建本地开发环境-php教程-PHP中文网

直接下载官方二进制、配环境变量、加caddyfile即可运行frankenphp，无需docker或php/caddy；下载解压frankenphp.exe，添加至path，执行frankenphp --version验证，再建项目目录并写index.php。

frankenphp 在 windows 系统该怎么快速搭建本地开发环境

直接下载官方二进制，配好环境变量，再加一个 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 在项目根目录。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

启动服务并访问

进入项目目录，运行： frankenphp run

默认监听 @#@#@#@#@#@#@#@#@#@1（不是 80，避免管理员权限）。
用浏览器打开 @#@#@#@#@#@#@#@#@#@1，即可看到页面输出。

如果想改端口，可以加参数： frankenphp run --addr :3000 → 访问 @#@#@#@#@#@#@#@#@#@3

常见问题处理

- 提示“找不到 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 规则）。

不复杂但容易忽略。