迅睿CMS多语言站点配置手把手实操从零到上线教程

一、前期准备

1. 环境要求：PHP7.2+、MySQL5.6+，迅睿CMS最新稳定版，下载地址：https://www.xunruicms.com/download.html；2. 完成迅睿CMS基础安装（未安装的需先执行：上传install目录到服务器，按页面引导安装至默认站点）。

二、开启多语言核心功能

1. 后台登录

访问您的域名+/admin.php，输入管理员账号密码进入迅睿CMS后台。

2. 开启多语言开关

依次点击【系统设置】→【站点配置】→开启多语言功能，点击选项旁的开关按钮（默认关闭），点击【保存配置】生效。

三、添加多语言站点

依次点击【系统设置】→【多语言管理】→【添加语言】。

1. 基础信息配置（必填）

• 语言标识：填写英文唯一标识，如en，禁止中文；
• 语言名称：填写前台显示名称，如English；
• 站点目录：填写独立目录名，如en，必须提前在网站根目录创建该文件夹；
• 默认语言：仅中文（zh）设为默认，其余语言取消勾选；
• 点击【提交】完成语言添加，记录该语言的ID号（多语言列表中对应行的ID）。

2. 多语言站点路径配置

将默认站点的完整内容复制到根目录的对应语言文件夹（如根目录的en文件夹）；找到语言目录下的config.php，替换为以下完整配置：

```php ```

注意：siteid必须与多语言后台记录的ID完全匹配，否则站点无法正常加载。

四、配置多语言切换与内容同步

1. 语言包同步：进入【内容管理】→【语言包管理】，找到添加的语言（如English），点击【同步语言包】，完成后即可编辑对应语言的内容；

2. 前台切换按钮：打开前台模板的header.html，添加以下代码实现语言切换：

```html ```

五、配置伪静态（必做，否则多语言页面404）

1. Nginx环境配置

打开Nginx站点配置文件，在location /段后方添加以下规则：

```nginx 多语言子目录伪静态支持 location ~ ^/(en|zh)/ { if (!-e $request_filename) { rewrite ^/(.)$ /$1/index.php?$2 last; } } location / { if (!-e $request_filename) { rewrite ^/(.)$ /index.php?$1 last; } } ```

2. Apache环境配置

在站点根目录的.htaccess文件中，替换为以下规则：

```apache RewriteEngine On RewriteBase / 多语言子目录支持 RewriteRule ^(en|zh)/(.)$ /index.php?$2 [L,QSA] RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule ^(.)$ /index.php?$1 [L] ```

配置完成后重启Nginx或Apache服务，使规则生效。

六、多语言站点测试

1. 访问主域名（如example.com），确认显示中文站点内容；

2. 访问多语言路径（如example.com/en/），确认页面正常加载，内容同步；

3. 点击前台切换按钮，确认可正常跳转对应语言页面，无404错误。

七、常见问题修复

1. 多语言页面404

检查对应语言目录是否存在，伪静态规则是否正确，config.php中的siteid是否匹配后台记录的ID；

2. 语言切换不生效

检查切换按钮链接是否为对应路径（如/en/），后台多语言开关是否开启，语言标识是否统一。