禅道如何配置使用外部的MySQL数据库进行连接？

禅道作为一款广受欢迎的项目管理与协同办公软件，其稳定性与性能在很大程度上依赖于后端数据库的正确配置，无论是初次部署还是迁移环境，掌握禅道的数据库配置方法都是 administrators 的必备技能，本文将详细介绍禅道数据库配置的核心要素、操作步骤及高级选项,帮助您构建一个稳固高效的数据基石。

理解核心配置文件 my.php

禅道所有与数据库的连接信息都集中存放在一个名为 my.php 的配置文件中，该文件位于禅道安装目录下的 config 文件夹内（/opt/zentao/config/my.php），正确理解并修改此文件是配置数据库的关键。
主要包含以下几个核心参数,下表详细说明了它们的作用：

通过修改这些参数,禅道即可连接到指定的数据库实例。

数据库配置分步指南

进行数据库配置时，建议遵循以下步骤,以确保过程顺利且无误。

1. 准备数据库环境
   在修改配置文件前，务必确保数据库服务已安装并正在运行，您需要在数据库管理系统中（如MySQL或MariaDB）为禅道创建一个专用的数据库和用户。

   

   • 创建数据库：CREATE DATABASE zentao CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
   • 创建用户并授权：GRANT ALL PRIVILEGES ON zentao.* TO 'zentao_user'@'localhost' IDENTIFIED BY 'your_secure_password';
   • 刷新权限：FLUSH PRIVILEGES;

2. 定位并编辑 my.php
   通过SSH或文件管理器进入禅道的安装目录，找到 config/my.php 文件，使用文本编辑器（如vi, nano）打开它。

3. 填写连接信息
   根据第一步中创建的数据库信息，仔细修改 my.php 文件中的各项参数，确保主机、端口、用户名、密码和数据库名称完全准确，任何一个微小的错误都会导致连接失败,一个典型的配置示例如下：

   <?php
   $config->installed = true;
   $config->debug = false;
   $config->requestType = 'GET';
   $config->db->host = '127.0.0.1';
   $config->db->port = '3306';
   $config->db->user = 'zentao_user';
   $config->db->password = 'your_secure_password';
   $config->db->name = 'zentao';
   $config->db->prefix = 'zt_';
   $config->db->encoding = 'utf8mb4';
   ...

4. 保存并验证
   保存对 my.php 文件的修改，通过浏览器访问禅道系统，如果首页能够正常加载，则表示数据库配置成功，如果出现数据库连接错误，请返回检查 my.php 文件中的参数以及数据库用户的权限设置。

高级配置选项

除了基本的连接参数，my.php 还提供了一些高级选项,可用于性能调优和特定场景适配。

• 字符集设置：强烈建议使用 utf8mb4 字符集，它完全兼容UTF-8，并支持存储包括表情符号在内的更广泛的字符,避免了因字符编码问题导致的乱码。
• 持久连接：通过设置 $config->db->persistent = true; 可以启用数据库持久连接，这能减少建立新连接的开销，在高并发访问场景下可能提升性能，但需注意，它会占用更多的服务器资源,请根据实际情况权衡使用。

相关问答FAQs

问：如果忘记了禅道数据库的密码，该如何重置？
答：忘记密码时，需要分两步走，在数据库服务器层面重置密码，以MySQL为例，您可以通过有权限的root用户登录MySQL，执行 ALTER USER 'zentao_user'@'localhost' IDENTIFIED BY 'new_password'; 来设置新密码，登录禅道服务器，编辑 config/my.php 文件，将 $config->db->password 的值更新为您刚才设定的新密码,保存文件后即可。

问：禅道系统访问缓慢，是否与数据库配置有关？
答：访问缓慢可能与数据库有关，但并非唯一因素，首先应检查服务器本身的CPU、内存和I/O负载情况，确认数据库服务器与禅道应用服务器之间的网络延迟是否正常，如果这些都正常，可以考虑数据库层面的问题，如慢查询、索引缺失等，您可以通过开启MySQL的慢查询日志来分析执行时间过长的SQL语句，并针对性地进行优化，对于大型团队，将数据库部署在独立的、性能更强的服务器上也是一个有效的解决方案。