url_html_suffix配置决定URL后缀处理方式：非空时自动截去后缀再匹配路由，空字符串时允许任意后缀且一律截去，false时禁用伪静态；同时影响url()函数生成地址，并与url_route_must=true存在冲突风险。
url_html_suffix 会干扰路由匹配过程
当 url_html_suffix 配置为非空字符串（如 'html' 或 'html|shtml'）时，ThinkPHP 会在路由解析前**自动截掉匹配的后缀**，再拿剩余路径去匹配路由规则。这意味着你写的路由规则必须基于“去掉后缀后的 URL”来定义。
常见错误现象：/user/123.html 访问 404，但 /user/123 能正常访问——说明路由规则里写的是 'user/:id'，而框架因后缀未被允许或未正确剥离，导致匹配失败。
- 若配置
'url_html_suffix' => 'html'，则只接受以.html结尾的请求，且截掉后才进路由；其他后缀（如.htm）直接 404 - 若配置
'url_html_suffix' => ''（空字符串），表示允许任意后缀，且一律截掉，不校验——这是前端 history 模式（如 Vue Router）最友好的设置 - 若配置
'url_html_suffix' => false，则完全禁用伪静态逻辑，URL 后缀原样传入，:id.html中的.html会被当作参数值的一部分，极易出错
url_html_suffix 影响 url() 函数生成的地址
url() 函数不是简单拼字符串，它会读取 url_html_suffix 配置，自动给生成的 URL 加上对应后缀。这个行为和你是否在路由规则中显式写了 .html 无关。
使用场景：你定义了路由 Route::get('article/:id', 'Article/read');，调用 url('article/read', ['id' => 123])：
立即学习“PHP免费学习笔记（深入）”；
- 当
'url_html_suffix' => 'html'→ 输出/article/123.html - 当
'url_html_suffix' => 'xml|json'→ 输出/article/123.xml（取第一个） - 当
'url_html_suffix' => ''→ 输出/article/123（无后缀） - 当
'url_html_suffix' => false→ 输出/article/123（也不加后缀，但此时路由层已不处理后缀）
注意：url() 不会因为某个路由规则里写了 'article/:id.html' 就特殊处理——它只认全局配置。
与 url_route_must = true 冲突时最危险
如果同时开启强制路由模式（'url_route_must' => true）和带限制的 url_html_suffix（比如只设 'html'），会导致大量合法请求被直接拦截在路由入口外，连中间件都进不去。
原因：请求 /user/index.xml 时，因后缀 .xml 不在允许列表中，框架拒绝解析，直接返回 404；而你可能根本没意识到这个请求被“卡死”在后缀校验环节。
- 前端 history 模式下，浏览器可能发起带任意后缀的预检请求（尤其配合某些 CDN 或代理），容易触发此问题
- 关闭
url_route_must（设为false）后，未匹配路由会 fallback 到默认 PATH_INFO 解析，至少能进控制器 - 生产环境若必须开
url_route_must，请确保url_html_suffix设为空字符串或覆盖所有可能后缀
动态路由中 ext() 参数优先级高于全局配置
你可以对单条路由单独控制后缀行为，用 ext() 方法，它比 url_html_suffix 全局配置优先级更高。
例如：Route::get('api/user/:id', 'Api/User/read')->ext('json'); 表示这条路由只响应 .json 后缀，即使全局 url_html_suffix 是 'html'，也不会生效。
-
->ext('json')：仅匹配.json，其余后缀 404 -
->ext('')：允许任意后缀（等效于全局设空字符串） -
->denyExt('php')：禁止特定后缀，常用于安全防护 - 多个路由混用不同
ext()时，务必执行php think route:list确认实际注册效果
真正容易被忽略的是：全局 url_html_suffix 和路由级 ext() 共存时，前者只影响 url() 生成逻辑，后者才决定该路由能否被匹配——两者作用域完全不同。
