ThinkPHP伪静态自定义html/shtml后缀设置操作【操作】-ThinkPHP-PHP中文网

url_html_suffix必须配置在config/route.php顶层，值为'html'、'html|shtml|xml'或false；写错位置或格式将失效，且需配合web服务器重写规则才能生效。

thinkphp伪静态自定义html/shtml后缀设置操作【操作】

url_html_suffix 配置项必须写对位置和格式

ThinkPHP 6/8 的伪静态后缀控制只认 config/route.php 顶层的 url_html_suffix，不是 config/app.php，也不是 route.php 里 'rules' 数组内部。写错位置等于没配。

值支持三种形式：'html'（单后缀，不含点）、'html|shtml|xml'（多后缀用竖线分隔）、false（关闭）。注意：'.html' 和 'html' 效果一样，框架会自动补点；但 'shtml' 不等于 '.shtml' —— 后者会导致生成 URL 多出两个点，比如 /article/1..shtml。

TP5 是在 config.php 里配 'URL_HTML_SUFFIX' => 'shtml'，大小写敏感，别写成 url_html_suffix
如果用了多后缀，比如 'html|shtml'，访问 /article/1.pdf 会 404，除非你额外加 'URL_DENY_SUFFIX' => 'pdf|ico|png'（TP3/5）或在中间件里拦截
url_html_suffix 设为空字符串 '' 表示“允许任意后缀”，但此时 request()->ext() 才能取到真实后缀，否则返回空

Web 服务器重写规则必须转发带后缀请求到入口文件

框架配置只是半程——如果 Apache/Nginx 拦截了 .shtml 请求并当成静态文件处理，或者直接 404，那根本进不到 ThinkPHP 路由层。关键不是“让 URL 看起来像静态”，而是“让服务器把请求交给 index.php”。

Nginx 示例（nginx.conf 或站点配置）：

anything-to-html

将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。

下载

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Apache 需确保 .htaccess 生效且内容含标准规则，尤其检查 AllowOverride All 是否开启；IIS 用户需用 web.config 的 <rewrite></rewrite> 段落，不能只靠 <match url="^(.*).shtml$"></match> 这种局部规则——它不转发，只匹配。

常见错误：Nginx 里写了 location ~ \.shtml$ { ... } 却没 fallback 到 PHP，结果所有 .shtml 请求被拒或下载源码
TP 默认会剥离后缀再匹配路由，所以 /article/123.shtml 和 /article/123 路由规则写法一致，无需重复定义
不要在路由规则里硬写后缀，比如 Route::get('article/<id>.shtml', ...)</id> —— 这会让框架误判为固定路径，破坏后缀自动识别逻辑

url() 函数是否加后缀取决于路由注册方式

url() 不是无脑拼后缀。它只对「显式注册的命名路由」或「匹配到启用后缀的路由规则」才追加 url_html_suffix。直接传控制器方法字符串（如 url('index/article/read')）可能不生效，尤其在未开启路由或规则未覆盖时。

推荐写法：Route::get('article/<id>', 'Index/Article/read')->name('article.read');</id>，然后调用 url('article.read', ['id' => 123]) → 输出 /article/123.shtml
闭包路由、未命名的 Route::rule()、或通过 __callstatic 动态生成的路由，url() 无法关联后缀
模板里用 {:url('article.read', ['id'=>123])}，别手写 /article/123.shtml —— 后者绕过框架，导致反向解析失败（比如从 URL 提取参数时丢后缀）
如果当前请求本身就是 /article/123.xml，且 url_html_suffix 包含 xml，那么 url('article.read', [...]) 会生成 .xml 后缀，而非默认第一个

request()->ext() 取后缀前先确认是否命中有效后缀

request()->ext() 返回的是当前请求 URL 的后缀部分（不含点），但它只在请求实际匹配了 url_html_suffix 中声明的后缀时才有值。比如配置是 'html|shtml'，但用户访问 /article/123.pdf，该方法返回空字符串，不是 'pdf'。

TP3 用常量 __EXT__，TP5/6/8 统一用 request()->ext()
如果 url_html_suffix => false，所有后缀都会被当普通参数处理，比如 /article/123.html 中的 html 会变成最后一个参数值
多后缀场景下，ext() 返回的是实际匹配上的那个，不是配置列表里的第一个；可用于动态切换模板或日志标记，但别依赖它做核心业务分支

真正容易被忽略的是：后缀控制本质是“路由层协议”，不是 URL 字符串装饰。改配置、调函数、配服务器，三者缺一不可，任一环节脱节，就会出现生成有后缀但访问 404，或访问能通但 url() 死活不加后缀的情况。