Nginx 规则通常放入站点 server / location 中;Apache 规则可保存为网站根目录 .htaccess(需开启 mod_rewrite)。规则仅供参考,请按实际环境调整。
填写「期望静态 URL」与「程序实际 URL」。可用占位符:{id} 数字、{slug} 单段、{path} 多段。也可直接填示例数字,工具会自动识别。
提示:静态 URL 写对外访问路径;实际 URL 写站点真实入口。占位符名称需两边一致,例如两边都写 {id}。
伪静态(URL Rewrite)是把带参数的动态地址,改写成看起来像静态页面的 URL。浏览器访问的是「好看的地址」,服务器在内部再转发到真实的 PHP/程序入口,页面内容并不变成真正的 .html 文件。
/news/123.html/index.php?m=news&id=123- 更利于 SEO 与分享,URL 更短、更清晰
- 隐藏真实脚本路径与参数结构
- 可统一入口(如全部转到
index.php)
| 类型 | 说明 |
|---|---|
| 伪静态 / 内部重写 | 地址栏仍是静态 URL,服务器内部转到动态脚本,用户无感 |
| 301 / 302 跳转 | 浏览器会跳到新地址,地址栏会变化;常用于旧链迁移 |
| 真静态 | 磁盘上已有对应 .html 文件,直接返回文件内容 |
- Nginx:写在站点的
server { }或location / { }中,改完需重载 Nginx - Apache:通常放在网站根目录
.htaccess,需开启mod_rewrite,并允许覆盖配置(AllowOverride) - 宝塔等面板一般有「伪静态」填写框,可直接粘贴对应引擎规则
常用指令是 rewrite 匹配正则 目标地址 标志;。匹配从站点 URI 开始,捕获组用 $1、$2 回填。
# 基本形式
rewrite ^/新闻路径正则$ /真实路径 last;
# 示例:/news/123.html → /index.php?m=news&id=123
rewrite ^/news/([0-9]+)\.html$ /index.php?m=news&id=$1 last;
# 示例:整站未命中文件时转到入口
if (!-e $request_filename) {
rewrite ^(.*)$ /index.php?s=$1 last;
}
# 也可用 try_files(WordPress 常见写法)
location / {
try_files $uri $uri/ /index.php?$args;
}
| 标志 | 含义 |
|---|---|
last | 内部重写后重新匹配 location(伪静态最常用) |
break | 内部重写,但不再继续本轮 rewrite |
redirect | 302 临时跳转,地址栏会变 |
permanent | 301 永久跳转,地址栏会变 |
在 .htaccess 中开启重写引擎,用 RewriteRule 匹配。注意:在目录级 .htaccess 里,匹配的是去掉前导 / 后的路径(写 ^news/ 而不是 ^/news/)。
<IfModule mod_rewrite.c>
RewriteEngine On
# RewriteBase /blog/ # 若站点在子目录可设置
# 排除真实存在的文件/目录
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
# /news/123.html → /index.php?m=news&id=123
RewriteRule ^news/([0-9]+)\.html$ /index.php?m=news&id=$1 [QSA,L]
# 兜底到入口
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php?s=/$1 [QSA,PT,L]
</IfModule>
| 标志 | 含义 |
|---|---|
L | Last,本条匹配后停止后续规则 |
QSA | 保留并追加原 URL 查询参数 |
NC | 不区分大小写 |
R=301 / R=302 | 对外跳转(地址栏变化) |
PT | 交给后续处理(部分 PHP 入口需要) |
| 写法 | 含义 | 示例匹配 |
|---|---|---|
^ / $ | 开头 / 结尾 | 整段精确匹配 |
([0-9]+) | 一段数字 | 123 |
([^/]+) | 不含斜杠的一段 | hello-world |
(.*) | 任意内容(可含 /) | a/b/c |
\.html | 字面量 .html | 点号需转义 |
$1 $2 | 第 1、2 个捕获组 | 回填到目标 URL |
把列表页与详情页做成伪静态,并保留未匹配请求到 ThinkPHP 入口:
location / {
rewrite ^/list/([^/]+)/([0-9]+)\.html$ /index.php?c=list&slug=$1&page=$2 last;
rewrite ^/news/([0-9]+)\.html$ /index.php?m=news&id=$1 last;
if (!-e $request_filename) {
rewrite ^(.*)$ /index.php?s=$1 last;
}
}
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteRule ^list/([^/]+)/([0-9]+)\.html$ /index.php?c=list&slug=$1&page=$2 [QSA,L]
RewriteRule ^news/([0-9]+)\.html$ /index.php?m=news&id=$1 [QSA,L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php?s=/$1 [QSA,PT,L]
</IfModule>
- 先确认程序官方推荐规则,再微调;本工具「常用程序」可快速查看常见模板
- 需要自己映射多组 URL 时,用「自定义生成」,占位符如
{id}、{slug}可自动转成捕获组 - 规则从具体到宽泛排列,兜底规则放最后,避免提前吞掉其它路径
- 上线前在测试环境验证:静态资源、后台、接口路径是否被误重写
以上为入门说明,不同面板、PHP 版本与目录结构可能略有差异,请以实际环境为准。