跳转到主内容
极星编程网:以代码为星,赴技术山海!

宝塔面板如何设置网站伪静态_常见伪静态规则配置方法【教程】

伪静态未生效需依次检查Nginx重写模块加载、配置重载、PHP pathinfo支持、子目录/多域名适配及框架规则匹配性;务必查看error.log定位真实错误。 伪静态没生效?先确认 Nginx 重写模块和配置加载方式 宝塔面板里的“伪静态”开关本身不启用任何功能,它只是往站点的
nginx.conf
片段里插入一段
location /
块。真正起作用的是 Nginx 是否加载了该规则、是否满足重写条件,以及 PHP 是否能正确接收
PATH_INFO
或
QUERY_STRING
。 常见错误现象:页面 404、URL 中仍带
index.php
、后台跳转错乱。 检查 Nginx 是否已重载:修改伪静态后必须点“重载 Nginx”,仅保存不生效 确认站点根目录下没有冲突的
.htaccess
(Apache 遗留文件,Nginx 不读取,但可能误导判断) PHP 要求开启
pathinfo
支持(尤其 ThinkPHP/Laravel),可在宝塔 PHP 设置 → “禁用函数”中确认未禁用
apache_getenv
等辅助函数 若用子目录部署(如
/blog/
),伪静态规则中的
rewrite ^(.*)$ /index.php?s=$1 last;
会出错,应改为
rewrite ^/blog/(.*)$ /blog/index.php?s=$1 last;
不同框架的伪静态规则不能混用 ThinkPHP、Laravel、WordPress 的重写逻辑差异很大,直接套用会导致路由解析失败或无限重定向。宝塔提供的模板是按框架入口行为定制的,不是通用万能规则。 使用场景举例:你用 Laravel 但选了 ThinkPHP 模板,
index.php?s=xxx
这种参数 Laravel 根本不认,结果就是所有请求都 fallback 到首页或 404。 ThinkPHP 6+(PATHINFO 模式) :
if (!-e $request_filename) { rewrite ^(.*)$ /index.php?s=$1 last; }
Laravel(标准模式) :
if (!-e $request_filename) { rewrite ^(.*)$ /index.php last; }
(注意没有
?s=$1
) WordPress :
location / { try_files $uri $uri/ /index.php?$args; }
(必须带
$args
,否则分页、搜索失效) Phpcms v9 多站点需额外判断 host:
if ($host ~* ^([a-z0-9\-]+)\.example\.com$) { set $subdomain $1; }
,再配合
rewrite
把请求导向对应子站目录 二级域名伪静态要分两步走:先捕获子域,再映射路径 想让
shop.example.com
自动指向
/www/wwwroot/example.com/shop/
,不能只靠一条 rewrite。Nginx 不会自动把子域名变成路径段,得靠变量提取 + root 重设或内部重写。 容易踩的坑:只写
rewrite ^(.*)$ /shop/$1 last;
,这只能改 URI,不能切换物理目录;用户访问
shop.example.com/admin
仍会去找主站根目录下的
admin
,而不是子站目录。 推荐做法是在站点配置中用
server_name shop.example.com;
单独建一个站点,根目录直指
/www/wwwroot/example.com/shop/
,再为其单独配伪静态规则——最稳 若坚持单站点多二级域,需在主配置里用
map
提取子域:
map $host $subdir { default ""; ~^(\w+)\.example\.com$ $1; }
,再用
root /www/wwwroot/example.com/$subdir;
切勿依赖
if ($host = ...)
做重定向,Nginx 官方明确不推荐在
server
块中用
if
做 host 判断,易引发不可预期的匹配顺序问题 自定义规则调试:别只看浏览器,要看 Nginx error.log 伪静态出问题时,浏览器只显示 404 或空白,真正线索藏在日志里。比如
rewrite or internal redirection cycle
表示重写死循环;
no such file or directory
可能是
$request_filename
判定路径错了。 调试建议直接打开宝塔 → 网站 → 日志 → 错误日志,实时刷新并触发一次请求,比猜强十倍。 临时加日志观察重写过程:
rewrite_log on;
(需在 Nginx 主配置开启
error_log /www/wwwlogs/nginx_error.log notice;
) 测试正则是否匹配:用在线工具(如 regex101)粘贴你的 URI 和规则,注意 Nginx 使用 PCRE,不支持 lookbehind 避免滥用
break
:它会终止当前 location 块内后续指令,常导致
fastcgi_pass
没执行就返回 404 上线前务必关掉
rewrite_log
,它严重拖慢性能 伪静态真正的复杂点不在写那几行正则,而在于它横跨 Nginx 配置层、PHP 运行时环境、框架路由机制三层。少一个环节对不上,整条链就断了。很多人卡在“明明规则一样,别人能用我不能”,往往就是 PHP 的
$_SERVER['PATH_INFO']
没传进来,或者 Nginx 把
$request_uri
和
$uri
搞混了。

相关文章