WordPress不能直接运行在FrankenPHP默认配置下，因其依赖.htaccess重写规则实现固定链接，而FrankenPHP默认仅处理index.php和静态文件，需手动添加Caddy重写规则并修复$_SERVER['REQUEST_URI']。
能，但需要手动适配路径和重写规则，不能像Laravel那样开箱即用。
为什么WordPress不能直接跑在FrankenPHP默认配置下
FrankenPHP默认的 php_server 指令只处理 index.php 和静态文件，而WordPress依赖Apache的 .htaccess 重写规则来支持“固定链接”（如 /2024/post-slug）。Caddy本身不解析 .htaccess，FrankenPHP也不会自动转换这些规则。
- 现象：访问非
/index.php的URL（比如首页或文章页）返回 404 - 根本原因：请求没被正确转发到
index.php，PHP没机会执行 WordPress 的路由逻辑 - 关键区别：Laravel 的
Caddyfile示例里用了try_files {path} index.php，WordPress 默认没有这层兜底
必须改的 Caddyfile 配置项
在站点块中，除了 php_server，你还得显式加一条重写规则，把所有非静态资源的请求都交给 index.php 处理。
-
root必须指向 WordPress 的public/目录（即含index.php的那一层），不是项目根目录 - 用
handle+rewrite替代简单php_server：handle { try_files {path} {path}/ /index.php?{query} } - 然后单独启用 PHP 执行：
php指令（不是php_server）——它更底层、更可控 - 记得保留
encode zstd br gzip和file_server，否则静态资源（CSS/JS/图片）会 404
wp-config.php 里要补的一行
FrankenPHP 不提供 $_SERVER['REQUEST_URI'] 的原始值（Caddy 会做归一化），WordPress 依赖它生成链接。不修会导致后台跳转错乱、静态资源路径错误。
立即学习“PHP免费学习笔记（深入）”；
- 在
wp-config.php开头附近加：$_SERVER['REQUEST_URI'] = $_SERVER['REDIRECT_REDIRECT_REQUEST_URI'] ?? $_SERVER['REDIRECT_REQUEST_URI'] ?? $_SERVER['REQUEST_URI'];
- 这个是 FrankenPHP 的已知行为，不是 bug；
REDIRECT_*前缀是 Caddy 传递 CGI 变量时加的 - 漏掉这行，你可能看到“您正在尝试编辑的文章已被其他人更新”这类误报，或者媒体库上传后路径不对
worker 模式对 WordPress 的实际影响
开启 worker 模式后，WordPress 的 bootstrap 成本（加载插件、主题、WP核心类）会被缓存，但要注意副作用。
- 好处：首页渲染、REST API 请求响应明显变快，尤其插件多的站
- 风险：部分插件依赖每次请求都重新初始化全局状态（比如某些缓存、日志、钩子注册逻辑），常驻后可能失效或冲突
- 建议：先用
classic模式跑通，再切worker；上线前重点测后台操作、用户登录、表单提交 - 调试时加
frankenphp日志级别：frankenphp run -log-level debug，看 PHP worker 是否复用成功
最易忽略的是重写规则和 REQUEST_URI 修复这两处——90% 的“跑不起来”问题都卡在这儿，而不是 PHP 版本或扩展缺失。
