Laravel项目配FrankenPHP用哪个Caddyfile模板-php教程-PHP中文网

默认 php_server 模板在 laravel 下不 work，因其 try_files {path} index.php 未透传原始 uri 且缺失 split_path 和 path_info 设置，导致路由解析失败而 404。

laravel项目配frankenphp用哪个caddyfile模板

直接用官方 Caddyfile 模板，但必须删掉 php_server 里的 try_files 默认值——否则 Laravel 路由会 404。

为什么默认 `php_server` 模板在 Laravel 下不 work

FrankenPHP 官方 Docker 镜像和独立二进制自带的 Caddyfile（比如 caddy/frankenphp/Caddyfile）里，php_server 指令默认写的是：

php_server { try_files {path} index.php }

这会导致两个问题：

{path} 是原始请求路径，比如 /user/123，Caddy 会先查 public/user/123 文件——显然不存在，于是 fallback 到 index.php，但没带 PATH_INFO 或 QUERY_STRING，Laravel 的路由解析器收不到原始 URI，全部变成首页或 404
它没显式启用 fastcgi_split_path_info 类似逻辑，而 Laravel 依赖这个把 /index.php/user/123 拆成脚本路径 + 路由路径

所以你得手动补上路由透传逻辑。

Academic Mentor

面向研究生的AI驱动研究顾问，提供研究评估、方案生成、文献分析、导师匹配及发表指导

下载

`php_server` 必须加的三个参数

在 php_server 块里，只保留这三行（删掉默认 try_files）：

root public/：明确 Web 根目录，不能省（否则 index.php 找不到）
split_path /index.php：告诉 FrankenPHP 把 /index.php/xxx 拆成 PHP 脚本路径 + PATH_INFO 环境变量，Laravel public/index.php 依赖它还原原始路由
env PATH_INFO {http.request.uri.path}：兜底补一个 PATH_INFO，防止某些重写规则漏掉（尤其本地开发用 localhost 时）

完整最小可用块长这样：

localhost {
    root public/
    php_server {
        split_path /index.php
        env PATH_INFO {http.request.uri.path}
    }
    encode zstd br gzip
}

Docker 和本地二进制的 `Caddyfile` 差异点

两者配置结构一致，但注意这些细节：

Docker 场景下：root 路径是容器内路径，挂载 $PWD:/app 后，root 必须写 public/（不是 /app/public/），因为 Caddy 当前工作目录就是 /app
本地二进制场景下：确保你执行 frankenphp run 时在 Laravel 项目根目录，root public/ 才能正确解析
HTTPS 自动启用：只要域名不是 localhost，Caddy 会自动走 Let’s Encrypt；localhost 则用自签名证书，浏览器要手动点“继续访问”
别碰 frankenphp 全局块里的 num_threads：Laravel 在 classic 模式下不依赖它，设了反而可能因线程数过多触发 PHP 内存限制

真正容易被忽略的是 split_path ——它不像 Nginx 的 fastcgi_split_path_info 那样有正则匹配，FrankenPHP 的 split_path 只认字面量前缀，必须严格写成 /index.php，写成 index.php 或 public/index.php 都无效。