菜单导航

伪静态配置

最近更新:2026-11-18 | 阅读量:53

标签作用:配置程序伪静态后URL中将不再包含兼容模式的问号,整个地址更美观,也便于推广优化。

适用版本:2.X 、3.X

地址模式:后台仅「伪静态」与「兼容」两项。开启伪静态时,IIS/Apache 环境会自动从源码包 rewrite/ 目录拷贝规则文件到站点根目录(已存在则不覆盖);Nginx 需手工把规则写入虚拟主机配置。

1、IIS7+环境(IIS6的环境自行百度):

1)安装rewrite组件,如果使用空间一般空间商默认已经安装;

2)到后台配置参数中开启伪静态开关(程序会自动拷贝 rewrite/web.config,也可手工对照下方规则);

3)规则内容如下(含 data、static/backup 目录拒绝访问):

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
        <rewrite>
            <rules>
                <rule name="deny_data_backup" stopProcessing="true">
                    <match url="^(data|static/backup)/.*" ignoreCase="true" />
                    <action type="CustomResponse" statusCode="403" statusReason="Forbidden" statusDescription="Access Denied" />
                </rule>
                 <rule name="reIndex" stopProcessing="true">
                    <match url="^(.*)$" ignoreCase="true" />
                    <conditions logicalGrouping="MatchAll">
                        <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
                        <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
                    </conditions>
                    <action type="Rewrite" url="index.php?p={R:1}" appendQueryString="true" />
                </rule>
            </rules>
        </rewrite>
    </system.webServer>
</configuration>

2、Apache环境

1)开启Apache重写模块,具体请百度,如果使用空间一般空间商默认已经开启;

2)到后台配置参数中开启伪静态开关(程序会自动拷贝 rewrite/.htaccess,也可手工对照下方规则);

3)规则内容如下(含 data、static/backup 目录拒绝访问):

<IfModule mod_rewrite.c>
  Options +FollowSymlinks
  RewriteEngine On

  RewriteRule ^(data|static/backup)/ - [F,L]

  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteCond %{REQUEST_FILENAME} !-f

  RewriteRule ^(.*)$ index.php?p=$1 [QSA,PT,L]
</IfModule>

3、Nginx环境

1、到后台配置参数中开启伪静态;

2、在nginx虚拟主机location配置中添加规则(Nginx 不会自动写入,请从源码包 rewrite/nginx.txt 拷贝),规则如下:

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

location ~ ^/(data|static/backup)/ {
    deny all;
}

注意:Nginx中如果站点部署在二级目录,请对应修改重写规则, 如:二级目录为test则:rewrite ^/test/(.*)$ /test/index.php?p=$1 last;

4、上传目录 MIME / nosniff(SVG、SVGZ、AVIF)

Apache:源码包已提供 rewrite/static-upload.htaccess,程序会通过 upload_ensure_htaccess() 自动部署为 static/upload/.htaccess(首次上传、开启伪静态、在线升级成功后会补齐)。请确认站点允许目录级 AllowOverride 且启用了 mod_mime/mod_headers。

Nginx:不会读取 .htaccess,请将源码包 rewrite/static-upload.nginx.conf 中的片段并入站点配置,确保 /static/upload/ 返回正确 Content-Type 与 X-Content-Type-Options: nosniff,并禁止执行上传目录内脚本。其中 .svgz 须带 Content-Encoding: gzip(片段内已单独 location),否则浏览器会把压缩字节当 XML 解析。

常见问题

关于《伪静态配置》的 FAQ

《伪静态配置》这篇手册主要讲了什么?

本文介绍PBootCMS伪静态配置的作用与适用版本说明后台开启伪静态后URL不再包含兼容模式问号地址更美观便于推广优化并分别讲解IIS7以上环境Apache环境和Nginx环境的规则配置方法包括自动拷贝规则文件与手工写入虚拟主机配置的差异同时说明上传目录MIME与nosniff安全设置以及SVGSVGZAVIF等文件类型注意事项帮助站长正确完成伪静态部署提升站点访问体验

按照《伪静态配置》操作遇到代码或报错问题怎么办?

请优先核对代码或配置参数是否完全一致。如果是环境差异或权限问题,建议查阅本站的“常见问题排查”板块,或直接联系我们的技术支持获取协助。

开发手册里的代码可以直接复制到我的 PbootCMS 网站使用吗?

可以直接使用。手册中的代码均经过实际测试。复制使用时,请注意将代码中的文章 ID、栏目编码(scode)等占位符,替换为您自己网站的真实数据即可。