小皮面板支持哪些程序的伪静态模板

学完这篇，你能知道小皮面板（xp.cn）里伪静态模板藏在哪、内置支持哪些程序、以及遇到没有对应模板的程序时该把规则写到哪里去。

第一步：找到伪静态模板入口

这一步要拿到的是"网站伪静态设置"这个页面，所有内置模板都在这里选。

登录小皮面板后，按这个路径走：

1. 左侧菜单点「网站」；
2. 在站点列表里找到目标站点，点这一行右侧的「管理」按钮；
3. 弹出的站点管理窗口里，选「伪静态」这一栏；
4. 页面上有一个下拉框（一般叫「伪静态规则」或「伪静态模板」），点开就能看到一长串程序名；
5. 选中你要的程序名，点「保存」。

保存后面板会自动把规则写进站点的配置文件并重载 Web 服务器，一般不需要你手动重启。

注意：下拉里的模板是跟着 Web 服务器类型走的。你的站点是 Nginx，模板就是 Nginx 的 rewrite 规则；是 Apache，模板就是 .htaccess 内容。中途把站点从 Apache 换成 Nginx，原来的选择要重新选一遍。

第二步：内置模板大致覆盖哪些程序

小皮面板的下拉列表不是固定不变的，版本不同、装的 Web 服务器不同，列出来的数量会有出入，以你自己面板里实际看到的为准。按常见版本归纳，大致覆盖这几类：

博客与内容管理（CMS）
WordPress、Typecho、Z-Blog、EyouCMS、DedeCMS（织梦）、帝国CMS、PHPCMS、PbootCMS、迅睿CMS、Discuz!（含 Discuz! X）、PHPWind、XiunoBBS。

PHP 框架
ThinkPHP 3、ThinkPHP 5、ThinkPHP 6、Laravel、CodeIgniter、Yii2、Symfony、Slim。

电商与商城
Ecshop、ShopEx、ShopNC、Magento、OpenCart。

其他
Joomla、Drupal、微擎（WeEngine）、We7、部分泛域名相关的通用条目。

注意：列表里同一个程序可能出现多条（比如 ThinkPHP 分 3 和 5/6），选错版本会出现首页能开、内页全 404 的情况。选之前先确认你项目的框架大版本。

第三步：找不到你的程序，用「自定义」填规则

下拉框滚到最底部，通常会有一个「自定义」或「自定义规则」的选项，选中后下面会出现一个可编辑的文本框。把规则粘进去，点保存即可，效果和内置模板完全一样。

以最常见的两个程序为例，Nginx 环境下可以直接用：

WordPress：

location / {
    if (-f $request_filename/index.html){
        rewrite (.*) $1/index.html break;
    }
    if (-f $request_filename/index.php){
        rewrite (.*) $1/index.php;
    }
    if (!-f $request_filename){
        rewrite (.*) /index.php;
    }
}

ThinkPHP 5：

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

ThinkPHP 6 把最后一行换成：

    rewrite ^(.*)$ /index.php/$1 last;

注意：手写规则时括号、分号、^ $ 少一个都会让整个站点 500 或直接打不开。建议先在本地或测试站点试，别直接在生产站点上改。

第四步：验证伪静态是否真的生效

这一步要拿到的是"确实走的是伪静态而不是 404"这个结论。

打开浏览器访问一条不带 .php 的地址，比如 https://你的域名/index.php/Index/index 简化后的 https://你的域名/Index/index，按 F12 打开开发者工具，切到 Network 面板，看这条请求的状态码：是 200 就说明伪静态已生效；是 404 说明规则没匹配上，回到上一步检查模板选型和规则内容。

如果站点用的是 WordPress，更简单的判断方式是：后台「设置 → 固定链接」里换成「文章名」这种形式，能正常点开文章就说明规则通了。

注意：改完规则记得回站点管理页点一次「保存」，只在文本框里改内容不点保存是不生效的。

小结

• 伪静态模板入口：面板左侧「网站」→ 站点右侧「管理」→「伪静态」→ 下拉选择 → 保存。
• 内置模板覆盖 WordPress、Typecho、DedeCMS、帝国CMS、Discuz、ThinkPHP、Laravel、Ecshop 等主流博客、CMS、框架和电商程序，具体数量随版本和 Web 服务器变化。
• 没有对应模板时，选「自定义」把规则粘进文本框保存，效果等同内置模板。
• Nginx 和 Apache 的规则不通用，切换 Web 服务器后要重新配置。
• 判断是否生效看请求状态码：200 成功，404 就是规则没匹配上。