从零开始超详细手把手教你完成迅睿CMS数据库配置全流程

前置准备

开始配置前，你需要提前准备好以下内容，缺少任意一项都会导致配置失败：

• 已经在服务器/虚拟主机面板手动创建好MySQL数据库，重要提醒：迅睿CMS不会自动创建数据库，必须提前创建，创建时必须设置字符集为utf8mb4，排序规则为utf8mb4_general_ci，创建完成后记录好：数据库地址、数据库名、用户名、密码四个核心信息。
• 迅睿CMS程序已经上传解压到服务器根目录，你可以从官方地址直接下载最新版：https://download.xunruicms.com/
• 已经给网站根目录下的config目录、cache目录设置755读写权限，虚拟主机一般面板可以直接设置，linux服务器可以用命令chmod -R 755 config cache设置。

第一种情况：首次安装自动配置数据库

如果你是第一次搭建迅睿CMS网站，推荐用在线自动配置方式，全程3分钟完成，步骤如下：

步骤1：进入安装引导页面

在浏览器输入你的域名加上安装入口，比如https://你的域名/install.php，回车即可进入安装页面，第一步点击同意安装协议即可。

步骤2：环境检查

第二步会自动检测服务器环境是否符合要求，如果有红色报错项，根据提示修复即可，最常见的是权限不足，按照前置要求给对应目录设置权限后刷新页面即可通过。

步骤3：填写数据库信息完成配置

环境检测通过后，进入数据库配置页面，按照以下说明填写对应内容，每个项都不能错：

• 数据库地址：默认填写localhost，如果是云厂商提供的远程数据库，填写服务商给的实际地址，修改了端口的用格式IP:端口填写，比如127.0.0.1:3307
• 数据库名称：填写你提前创建好的数据库完整名称，必须和创建的完全一致，区分大小写
• 数据库用户名：填写数据库对应的授权用户名，虚拟主机可以在面板数据库详情页看到
• 数据库密码：填写对应用户名的数据库密码，复制粘贴时不要带入多余空格
• 数据库前缀：默认保留dr_即可，只有同一个数据库安装多个迅睿CMS时才需要修改前缀
• 管理员账号密码：设置你自己的后台登录账号密码，记录好后续登录用

填写完成后点击「立即安装」，等待1-2分钟系统自动完成配置和数据导入，完成后会跳转到安装成功提示，自动配置就完成了。

第二种情况：手动配置数据库（适用于网站迁移、自动安装失败）

如果是网站迁移到新服务器，或者自动安装失败，可以直接手动修改配置文件，步骤更简单：

步骤1：找到配置文件

进入网站根目录的config目录：

• 如果是全新安装，默认只有模板文件database.php.sample，先把这个文件重命名为database.php
• 如果是迁移修改配置，直接打开已经存在的database.php

步骤2：修改配置参数

把原来的内容全部替换为以下完整代码，只需要修改你自己的参数即可，所有不需要修改的参数保持默认：

```php 'localhost', // 数据库地址 'port' => 3306, // 数据库端口，默认3306不需要修改 'user' => '你的数据库用户名', // 替换为你的用户名 'pwd' => '你的数据库密码', // 替换为你的密码 'name' => '你的数据库名称', // 替换为你的数据库名 'prefix' => 'dr_', // 表前缀，默认不变，迁移时和原数据库前缀保持一致 'charset' => 'utf8mb4', // 字符集，禁止修改 'collation' => 'utf8mb4_general_ci', // 排序规则，禁止修改 'timezone' => '+8:00', // 时区，国内服务器不需要修改 // 连接参数，不需要修改 'connect' => 0, 'persist' => false, ]; ```

你只需要修改以下5个参数，其他参数全部保持默认不动：

• host：换成你的实际数据库地址，本地默认localhost
• port：只有修改了MySQL默认端口才需要改，默认3306不用动
• user：替换为你的数据库用户名
• pwd：替换为你的数据库密码
• name：替换为你提前创建好的数据库名称

迁移网站时，要注意表前缀必须和原数据库的表前缀完全一致，比如原来的表都是dr_开头，这里就不能改其他值。

步骤3：生效配置

修改完成后保存文件，上传覆盖服务器上的原config/database.php，设置文件权限为644，清除网站缓存后，访问你的网站，能正常打开就说明配置成功。

常见问题排查

配置失败按照以下步骤逐一排查，99%的问题都能解决：

• 提示数据库连接失败：首先检查用户名、密码、地址、名称有没有输错，复制时是否带了多余空格；然后检查数据库用户是否给你的服务器IP开了远程访问权限；最后确认数据库已经提前创建，没有拼写错误。
• 页面乱码：检查数据库创建时字符集是不是utf8mb4，配置文件里的charset参数是不是正确，修改后重新保存即可。
• 迁移后提示找不到数据表：检查配置里的表前缀和原数据库的表前缀是否一致，不一致改成一样就可以解决。
• 修改配置后没变化：检查你是不是改错了文件，确认文件路径是根目录/config/database.php，并且上传成功覆盖了原文件。
• 本地环境配置失败：检查本地MySQL服务是否正常启动，端口是不是默认3306，如果端口改了要同步修改配置里的port参数。

按照以上步骤操作，就能完成迅睿CMS的数据库配置，整个过程没有复杂操作，只要参数填写正确就能一次成功。