ThinkPHP伪静态规则怎么自定义后缀_ThinkPHP伪静态shtml配置说明【教程】-ThinkPHP-PHP中文网

thinkphp 的 .shtml 伪静态后缀必须由框架配置 url_html_suffix 控制，配合开启路由、正确服务器重写规则及剥离后缀处理，否则无法生效。

thinkphp伪静态规则怎么自定义后缀_thinkphp伪静态shtml配置说明【教程】

ThinkPHP 伪静态后缀不能靠服务器规则硬改，必须由框架自身控制；直接在 url_html_suffix 配置项里设成 .shtml，再配合正确路由和 Web 服务器重写规则，才能生效。

怎么让 ThinkPHP 输出 .shtml 后缀的 URL

后缀由框架生成逻辑决定，不是 Apache/Nginx 写个 RewriteRule 就能“伪装”出来的。关键在配置文件：

config/app.php 中设置 'url_html_suffix' => '.shtml'（TP6）或 config.php 中对应位置（TP5）
确保 'url_route_on' => true 已开启，否则路由不解析，后缀无意义
如果用了 Route::rule('article/<id>', 'index/article/read')</id> 这类定义，生成的 URL 自动带 .shtml（前提是没禁用后缀）
手动调用 url() 函数时，后缀会自动追加，例如 url('index/article/read', ['id' => 123]) 返回 /article/123.shtml

Apache 下 .shtml 后缀要额外注意 mod_mime 和 .htaccess 规则

Apache 默认把 .shtml 当作 SSI 文件处理，不经过 PHP 解析，直接返回 404 或源码。必须显式声明交由 PHP 处理：

Wechat HTML Publisher

直接上传HTML富文本到微信公众号草稿箱。支持完整的HTML格式,无需Markdown转换。

下载

在 .htaccess 开头加：AddHandler application/x-httpd-php .shtml

完整重写规则需保留原始 PATH_INFO，不能只写 RewriteRule ^(.*)$ index.php/$1，而应为：

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php?s=$1 [QSA,PT,L]

若用 index.php?s= 模式，pathinfo_depr 必须是 /（默认），否则 /article/123.shtml 里的斜杠会被截断

Nginx 配置 .shtml 伪静态容易漏掉 try_files 的 fallback

Nginx 不识别 .shtml 后缀含义，但也不会像 Apache 那样默认拦截它——问题出在 rewrite 逻辑没覆盖到带后缀的请求路径：

错误写法：rewrite ^/(.*)$ /index.php?s=$1 last; —— 它会把 /article/123.shtml 变成 /index.php?s=article/123.shtml，框架无法识别 .shtml 后缀

正确做法：先去掉后缀再传参，用 if + rewrite 组合：

if (!-e $request_filename) {
    rewrite ^/(.*)\.shtml$ /index.php?s=/$1 last;
    rewrite ^/(.*)$ /index.php?s=/$1 last;
}

更稳妥的是在 PHP 入口统一处理：$_SERVER['PATH_INFO'] 里拿到原始路径后手动 str_replace('.shtml', '', ...)，但破坏了框架原生逻辑，不推荐

IIS 的 web.config 要显式匹配 .shtml 并剥离后缀

IIS 默认不转发带 .shtml 的请求到 index.php，<match url="^(.*)$"></match> 这种通配写法无效，必须明确捕获后缀：

规则中 <match url="^(.*)\.shtml$"></match> 匹配所有 .shtml 请求
<action type="Rewrite" url="index.php?s={R:1}"></action> 把 article/123 传给框架

还要加一条兜底规则匹配无后缀路径，否则 /article/123 会 404：

<rule name="Fallback" stopprocessing="true"><match url="^(.*)$"></match><conditions logicalgrouping="MatchAll"><add input="{REQUEST_FILENAME}" matchtype="IsFile" negate="true"></add><add input="{REQUEST_FILENAME}" matchtype="IsDirectory" negate="true"></add></conditions><action type="Rewrite" url="index.php?s={R:1}"></action></rule>

最易被忽略的是：后缀配置生效的前提是路由地址本身不含扩展名。比如你定义了 Route::rule('news/<id>.shtml', ...)</id>，框架反而会把它当字面量匹配，导致所有 .shtml 请求都进不了通用路由。后缀必须由 url_html_suffix 全局控制，而不是写死在路由表达式里。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！