装程序、搬家、换服务器，绕不开的都是数据库配置。这篇讲配置本身：文件在哪、参数什么含义、怎么改不出错。至于连接报错的排查修复，是另一篇的主题，这里不展开。
配置文件在哪
苹果CMS V10 的数据库配置写在程序根目录的数据库配置文件中，具体文件名随版本略有差异，对照目录结构看最快，推荐参考苹果CMS V10文件夹结构介绍。找到文件后用编辑器打开，里面就是一组键值形式的数据库连接参数，整个文件通常只有二三十行，一眼能看完。
参数逐个讲
常见参数有五个：hostname 是数据库地址，本机数据库就填 127.0.0.1；database 是库名；username 与 password 是数据库账号密码；hostport 是端口，MySQL 默认 3306，改过端口的环境要跟着改。还有一个容易忽略的：表前缀参数，决定了程序操作哪组数据表，随意改动会导致程序读不到已有数据。部分版本还有字符集参数，保持与建库时的 utf8mb4 一致，避免中文乱码。改参数前记一个原则：只改确定含义的项，看不懂的保持原样。hostname 填 localhost 还是 127.0.0.1 在个别环境下行为不同，前者可能走 socket 连接，连接报错时两种写法都试一下。
什么时候要改配置
三种典型场景。一是安装时填错了，数据没进来，改配置重建；二是搬家：数据库迁到新服务器后，新环境里的配置文件要按新库的信息改一遍，完整流程参考备份迁移方案（beifen-qianyi）；三是本地调试切线上环境，同样要改连接参数。改完记得清一下程序缓存，否则旧连接信息可能还在生效。改配置的完整动作是三步：改文件、清缓存、刷新前台验证，缺一步都可能误以为没改对，验证通过后再进行下一步。
注意事项
几条经验。改配置文件前先备份一份原文件，一行错了全站打不开，能秒回滚；账号不要用 root，单独建一个只授权本站数据库的账号，遵循最小权限原则；数据库密码定期更换，换了就同步改配置文件，两边不同步的后果就是连接失败。程序版本与环境的搭配问题，可参考苹果CMS V10（maccmsv10）的版本档案。搬家导库时字符集两边都要选 utf8mb4，导出与导入不一致，中文内容会出乱码，事后修复非常麻烦。
相关阅读
数据库配置是建站的地基，配置无误后，下一步通常是接口绑定与采集，可从苹果CMS 词条（pingguocms）入手了解整体；新环境跑起来后，整体检查建议对照新站上线15项检查清单（xinzhan-qingdan）过一遍。