FrankenPHP无需Apache或Nginx重写规则，因其内置fallback至index.php机制，等效于try_files；需确保public/为document_root、启用PATH_INFO支持、本地化路由注解末尾加“|”匹配空_locale，并用对应环境清缓存及手动重启服务。
FrankenPHP 本身不依赖 Apache 或 Nginx 的重写模块，它用 PHP 原生 SAPI 运行，路由重写逻辑必须由应用层（即 Symfony）自己接管 —— 所以你不需要写 .htaccess 或 nginx.conf 里的 try_files 规则，而是要确保 Symfony 的前端控制器（public/index.php）能捕获所有请求，并把路径正确传给 Router 组件。
为什么 FrankenPHP 不需要传统重写规则
FrankenPHP 启动时默认使用 public/ 为文档根目录，并内置了“fallback to index.php”行为：只要请求的文件或目录不存在，就会自动转发到 index.php，等效于 Nginx 的 try_files $uri $uri/ /index.php?$query_string。这意味着：
- 你不用手动配置
location /或RewriteRule -
/blog/123、/fr/contact、/api/v1/users这类路径会直接进index.php，由 Symfony Router 解析 - 唯一要检查的是：确认
public/确实是 FrankenPHP 的document_root（启动命令里用-d public/或配置文件指定）
Symfony6 路由必须启用 PATH_INFO 支持
FrankenPHP 默认通过 $_SERVER['REQUEST_URI'] 传递原始路径，但 Symfony Router 在 CLI/SAPI 模式下更依赖 PATH_INFO。如果发现 /fr/about 总被识别成 _locale=fr 失败，大概率是 PATH_INFO 没被正确设置。
在 public/index.php 开头加这几行（放在 require_once 框架引导之前）：
立即学习“PHP免费学习笔记（深入）”；
if (isset($_SERVER['REQUEST_URI']) && !isset($_SERVER['PATH_INFO'])) {
$_SERVER['PATH_INFO'] = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
}
这能确保 /fr/about 的路径部分被提取为 PATH_INFO=/fr/about，Router 才能正常匹配带 {_locale} 的注解路由。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
本地化路由注解必须显式允许空 _locale
Symfony 默认不会把 /about 当作 _locale 为空来处理 —— 它只会在路径明确匹配 /{_locale}/{slug} 且 _locale 缺失时 fallback 到 defaults。但 FrankenPHP 下，/about 和 /fr/about 都走同一入口，所以注解得写成：
#[Route('/{_locale}/{slug}', name: 'page', defaults: ['_locale' => 'en'], requirements: ['_locale' => 'en|fr|es|de|'])]
注意结尾的 |：它让正则匹配“空字符串”，从而让 /about 被识别为 _locale=''，再由 defaults 补上 en。不加这个竖线，/about 就根本不会命中这条路由。
同时确保没有其他更宽泛的路由（比如 /{slug}）定义在它前面，否则会优先匹配并截断本地化逻辑。
缓存与调试必须用 FrankenPHP 环境重新生成
Symfony 路由缓存（var/cache/prod/Routing*.php）会根据当前运行环境（APP_ENV、APP_DEBUG、SAPI 类型）生成不同逻辑。FrankenPHP 是 cli-server 类 SAPI，不是 fpm 或 apache2handler，所以：
- 清缓存必须加
--env=prod（或对应环境），例如：php bin/console cache:clear --env=prod - 调试路由时用
php bin/console debug:router --env=prod，避免开发环境缓存干扰 - 如果改了
requirements但没生效，八成是缓存没清干净，或用了错的环境参数
最易忽略的一点：FrankenPHP 启动后不会自动监听文件变更，index.php 或路由注解改了，必须手动重启服务才能生效 —— 它不像 symfony server:start 那样热重载。
