ThinkPHP中Route的ext方法_限制路由访问后缀如.html【说明】-ThinkPHP-PHP中文网

->ext('html') 仅校验请求路径后缀是否匹配，不改写URL；需Web服务器伪静态配置将.html请求转发至入口文件，且TP6中必须启用url_html_suffix配置，否则无效。

thinkphp中route的ext方法_限制路由访问后缀如.html【说明】

Route::ext() 不是独立函数，而是路由定义链式调用中的方法，用于强制当前路由匹配时只接受指定后缀（如 .html），不带后缀或其它后缀的请求会 404。

为什么 `->ext('html')` 有时不生效

常见错误是把 ->ext() 写在了路由规则末尾但没注意执行顺序，或误以为它能“自动添加后缀”。它只做匹配校验，不改写 URL；且必须配合伪静态 Web 服务器配置（如 Apache 的 .htaccess 或 Nginx 的 try_files）才能让 /news/123.html 这类地址真正被 PHP 接收到。

ThinkPHP 路由层在接收到请求路径后才开始匹配，/news/123 和 /news/123.html 是两个完全不同的 path，若未开启 URL 重写，Web 服务器可能直接返回 404（找不到 .html 文件）
->ext('html') 只对已送达框架的请求起作用 —— 即 Web 服务器必须把 *.html 请求转发给入口文件（如 index.php）
TP6 默认关闭后缀匹配，需确认 config/route.php 中 'url_html_suffix' 未设为空字符串（空值会禁用所有后缀识别）

`->ext()` 与 `['ext' => 'html']` 的区别

两者目标一致，但使用场景和优先级不同：

DeepBI DHTML 页面生成器

生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur

下载

->ext('html') 是链式调用，绑定到单条路由，粒度最细，推荐用于关键页面（如 SEO 友好的文章页）
['ext' => 'html'] 是第三个参数中的数组项，属于「规则级配置」，适用于 Route::rule() 等批量定义方式，但仅在 ThinkPHP 5.x 中稳定支持；TP6 中该写法已被弃用，强行使用可能被忽略
TP6 正确写法统一为链式：Route::get('article/:id', 'article/read')->ext('html');
多个后缀用竖线分隔：->ext('html|shtml')，不支持逗号

禁止某些后缀（比如屏蔽 .php）要怎么处理

->denyExt() 才是干这个的，不是 ->ext()。官方从 TP5.1 开始明确禁止 .php 后缀用于路由，因为存在安全风险（可能暴露入口逻辑或触发双解析漏洞）。

直接写 ->denyExt('php') 会在匹配阶段拒绝所有含 .php 的请求，返回 404
可组合使用：Route::get('api/:id', 'api/get')->ext('json')->denyExt('php|exe')
注意：如果 Web 服务器本身允许 .php 文件直接执行（如 Apache 未禁用 php_flag engine off），denyExt 无法阻止——它只在框架路由层拦截，前置 Web 层仍需配置防护