迅睿CMS框架从零开始安装配置全流程实操

一、运行环境与依赖检查

在开始部署迅睿CMS之前，必须确保服务器环境严格符合要求，否则会导致安装失败或运行报错。迅睿CMS基于CodeIgniter框架开发，对PHP版本和扩展有明确限制。

1. PHP版本要求

推荐使用PHP 7.2 至 7.4 版本。虽然PHP 8.0及以上版本在某些环境下可以运行，但为了确保插件和核心模块的绝对兼容性，PHP 7.4是最稳定的选择。请务必在php.ini中关闭以下函数：

• exec
• shell_exec
• passthru
• system
• proc_open
• popen
• curl_exec
• curl_multi_exec
• parse_ini_file
• show_source

2. 必须开启的PHP扩展

请在php.ini中确认以下扩展处于开启状态（extension=...）：

• pdo_mysql（数据库连接核心）
• gd或imagick（图片处理、缩略图生成）
• curl（用于远程请求、接口调用）
• fileinfo（用于文件类型识别）
• mbstring（多字节字符串处理）
• zip（用于插件和模块的安装解压）

3. 数据库要求

支持MySQL 5.6 及以上版本，推荐使用 MySQL 5.7 或 8.0。数据库引擎必须设置为 InnoDB，字符集统一设置为 utf8mb4 以支持emoji表情和生僻字。

二、程序下载与目录权限配置

1. 获取源码

直接访问迅睿CMS官方下载中心获取最新正式版源码包。不要使用测试版进行生产环境部署。下载后解压，将解压得到的文件上传至网站根目录。

2. 目录权限设置（Linux环境）

这是新手最容易卡壳的步骤。迅睿CMS需要对特定目录拥有读写权限才能生成缓存、上传文件和写入配置。请使用SSH终端连接服务器，执行以下命令设置权限：

假设你的网站根目录是 /www/wwwroot/xunruicms，请执行：

```bash 进入网站根目录 cd /www/wwwroot/xunruicms 递归设置目录权限为755，文件权限为644 find . -type d -exec chmod 755 {} \; find . -type f -exec chmod 644 {} \; 关键步骤：给以下特定目录设置可写权限（777） chmod -R 777 cache/ chmod -R 777 uploadfile/ chmod -R 777 template/ chmod -R 777 config/ ```

注意：如果是Windows服务器，确保IIS用户或IIS_IUSRS对上述文件夹拥有“完全控制”权限。

三、执行安装向导

环境配置无误后，即可通过浏览器进行可视化安装。

1. 运行安装程序

在浏览器地址栏输入：http://你的域名/install.php。如果环境检测通过，页面会自动跳转到“许可协议”页面。

2. 数据库配置详情

在“环境检测”通过后，进入“配置数据库”步骤。请务必填写准确的信息：

• 数据库服务器：通常填写 localhost 或 127.0.0.1。如果数据库在远程服务器，请填写IP地址。
• 数据库端口：默认为 3306。
• 数据库用户：填写数据库账号（如root）。
• 数据库密码：填写数据库密码。
• 数据库名称：提前在数据库管理面板（如phpMyAdmin）创建一个空数据库，填写此处。
• 数据表前缀：默认为 dr_。建议修改以增加安全性，例如 xr_。

3. 管理员账号设置

设置网站后台的管理员用户名和密码。密码强度建议包含大小写字母、数字和特殊符号，且长度超过12位。填写完毕后点击“安装”，等待约3-5秒，安装成功后会提示删除install.php文件。

```bash 安装完成后，务必在服务器执行以下命令删除安装文件，防止被恶意重装 rm -f /www/wwwroot/xunruicms/install.php ```

四、核心目录结构解析

安装完成后，熟悉目录结构是二次开发的基础。迅睿CMS采用了严格的MVC架构。

• /dayrui/：这是核心框架目录，严禁修改此目录下的文件。升级时直接覆盖此目录即可。
• /config/：全局配置文件目录，包含数据库配置、路由配置等。
• /template/：前端模板目录。HTML文件和CSS、JS资源通常存放在此。
• /uploadfile/：附件存储目录。图片、视频、文档上传后都会保存在这里。
• /cache/：缓存目录。系统生成的配置缓存、模板缓存都存于此。
• /public/：入口文件目录，index.php在此处。静态资源文件也可放在这里。
• /static/：系统自带的静态资源库（如Bootstrap、jQuery等），不建议修改。

五、数据库连接配置详解

如果安装后更换了服务器密码，或者需要手动调整数据库配置，可以编辑 /config/database.php 文件。以下是完整的配置参数说明：

```php 'localhost', // 用户名 'username' => 'root', // 密码 'password' => '123456', // 数据库名 'database' => 'xunruicms', // 端口 'port' => '3306', // 数据库前缀 'prefix' => 'dr_', // 字符集 'char_set' => 'utf8mb4', // 数据库排序规则 'dbcollat' => 'utf8mb4_general_ci', // 是否开启调试模式，生产环境建议设为false 'pconnect' => FALSE, // 是否开启严格模式 'stricton' => FALSE, // 缓存驱动 'cache_on' => TRUE, 'cachedir' => '', ]; ?> ```

注意：修改此文件后，必须进入后台刷新缓存，或者在服务器端删除 /cache/ 目录下的所有文件，配置才会生效。

六、伪静态规则配置

为了SEO优化，必须开启伪静态，使URL呈现为.html形式而非动态的index.php?s=形式。

1. 后台开启伪静态

登录后台，进入 系统 -> 系统设置 -> 网站设置，找到“网站URL模式”，选择 静态生成 或 伪静态。

2. Web服务器规则配置

根据你的服务器环境，将以下规则添加到网站根目录：

Apache环境 (.htaccess文件)：

```apache RewriteEngine On RewriteBase / 禁止访问config和cache目录 RewriteRule ^(config|cache|template|uploadfile)/(.)$ - [F,L] 核心伪静态规则 RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule ^(.)$ index.php/$1 [L] ```

Nginx环境 (在nginx.conf的server配置中添加)：

```nginx location / { 禁止访问敏感目录 location ~ ^/(config|cache|template|uploadfile)/ { return 403; } if (!-e $request_filename) { rewrite ^(.)$ /index.php?s=$1 last; break; } } ```

配置完成后，重启Nginx或Apache服务。访问网站任意栏目页，检查URL是否正常显示且页面打开无404错误。

七、发布第一篇内容实操

环境搭建完毕后，进行一次完整的内容发布测试，验证系统功能。

1. 创建栏目

进入后台 内容 -> 网站栏目。点击“添加栏目”。

• 栏目名称：输入“新闻中心”。
• 栏目目录：输入“news”（生成URL会用到）。
• 栏目模型：选择“新闻模型”。
• 发布权限：勾选“管理员”。

保存后，系统会自动生成该栏目的模板文件（如果未指定）。

2. 发布内容

进入 内容 -> 内容管理，选择刚才创建的“新闻中心”栏目，点击“发布内容”。

• 输入“测试文章标题”。
• 关键词：输入“测试,迅睿,CMS”。
• 内容：在编辑器中输入正文。
• 选项：勾选“生成静态HTML”（如果选择了静态模式）。

点击保存。如果提示“发布成功”，则说明数据库写入和权限配置均无问题。

3. 前台验证

访问网站前台，点击“新闻中心”，查看是否能看到刚才发布的文章。如果无法显示，请检查 /template/ 目录下是否存在对应的HTML模板文件，或者检查栏目设置中是否关联了正确的模板。