同一个详情页,未开启伪静态时网址可能是这样的:index.php?s=/vod/detail/id/123.html,带着程序路由的特征;开启伪静态后,它变成了:detail/123.html,与一个真实的静态文件在外观上毫无区别。网址还是同一个页面,服务器也还是那台服务器,改变的只是 URL 的呈现形式——通过重写规则把动态参数从网址里"藏"起来,这就是伪静态。对苹果cms站点来说,这一步值得在上线前就做完:规范的 URL 结构对搜索引擎抓取更友好,用户看到的地址也更简洁可信。本文分别给出 nginx 与 Apache 环境下的规则模板、后台开启位置与验证方法,并解决"设置了却404"的典型问题。
很多404问题的根源在于只知道一半流程。伪静态需要两侧配合:服务器侧加载重写规则,程序侧开启伪静态开关并选择 URL 规则。两侧任意一侧缺失,结果要么是前台链接原样带参数(服务器规则没配),要么是页面大面积404(程序选了规则但服务器不会重写)。动手前先确认自己站点的 Web 环境类型,按对应小节配置,两边都对上之后再做验证。
nginx 的重写规则写在站点配置文件的 server 块中。通用规则模板如下,站点路径不含子目录时可直接使用,部署在子目录的站点需要相应调整路径:
location / {
if (!-e $request_filename) {
rewrite ^(.*)$ /index.php?s=$1 last;
break;
}
}
配置步骤:打开 nginx 站点配置文件(面板环境通常在站点设置的"配置文件"或"伪静态"标签里),把规则加入或替换原有空规则块,保存后执行 nginx 配置检测,确认语法无误再重载服务。面板用户操作更简单:在站点的伪静态下拉框里如果预置了苹果cms 相关模板,直接选用即可,效果等价。
Apache 使用 .htaccess 文件承载重写规则,放在站点根目录下即可生效,前提是服务器开启了 mod_rewrite 模块并允许目录使用 htaccess 覆盖。规则模板如下:
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php?s=$1 [QSA,L]
</IfModule>
两条重写条件的含义是:仅当请求不是真实存在的文件或目录时才交给程序路由,这条逻辑与 nginx 版本等价。配置后若不生效,优先检查模块是否加载、htaccess 覆盖权限是否允许,这两项是 Apache 环境伪静态失败的高频原因。
规则形式的选择建议在上线初期一次性定好:URL 结构确定后网站就被搜索引擎逐步收录,中途大改 URL 规则会造成大量失效地址,代价不小。拿不定主意就选默认规则,它的结构经过大量站点的验证。
| 环境 | 规则位置 | 生效动作 |
|---|---|---|
| nginx | 站点配置文件 server 块 | 配置检测后重载服务 |
| Apache | 站点根目录 .htaccess | 保存即生效(模块开启前提下) |
| 面板环境 | 站点设置的伪静态项 | 选用预置模板或粘贴规则后保存 |
验证看三个信号:前台任意详情页的地址栏不再出现 index.php?s= 一类的路由参数;直接访问一个伪静态形式的新地址能正常打开目标页面;浏览器开发者工具的 Network 面板中页面请求返回的是正常状态码而非404。三项同时满足,伪静态才算完整生效。
程序侧开了、服务器侧没配,重写规则缺失时程序生成的伪静态地址无人接手。按本文对应环境小节补齐规则模板,重载或保存后清缓存再验证;面板环境检查是否选错了站点,规则要配在当前站点名下。
多为 URL 规则与重写规则不匹配——程序侧选用的规则形式产生了服务器规则没有覆盖的路径形态。核对两侧规则是否配套,改回配套组合后清理缓存验证。
环境差异问题。本地与线上的 Web 服务类型或版本可能不同,先确认线上环境的类型与本文模板的对应关系;Apache 环境重点查 mod_rewrite 与覆盖权限,nginx 环境重点查配置文件是否真正加载了所写的规则块。
伪静态属于站点上线清单里的 SEO 基础项,完整清单与全局流程见 苹果CMS资源站搭建全流程;程序与环境的入门认知见 苹果CMS是什么入门指南;上线后内容侧的持续生产,则交给采集体系,见 苹果CMS采集接口配置总教程。配置类的工作做完一次,长期受益。