Windows下Mantis的安装与配置

大名鼎鼎的Mantis是一个Bug跟踪系统，使用PHP编写，简单，易用，功能丰富，一直享有盛誉，还有很重要的一点，它是免费的，中小型企业使用它来跟踪缺陷和问题是再合适不过了。今天安装并配置了一下，在这里记录下来：

1.安装：

安装Mantis（现在叫MantisBT）之前，应先准备好Apache，MySQL和PHP的安装，这些在我以前的日志里已经有说明，在这里就不重复了，参见《WAMP（Windows Apache MySQL PHP）+phpMyAdmin安装配置》。

到Mantis官网上下载最新的稳定版本：选择Stable release版本，如mantisbt-1.1.6.zip。

解压到Apache的资源目录下，在浏览器中输入mantis访问地址，如，将进入数据库安装界面，设置相关数据库信息，填写要创建的数据库名字（默认为bugtracer，可修改为其他）、数据库使用用户和密码（我使用了root用户，当然也可以先创建其他用户然后在这里使用），点击安装数据库。

安装完成后，再次打开，用administrator root进行登录，验证安装。

2.配置：

2.1图形报表模块支持

2.1.1编辑php的配置文件php.ini，找到;extension=php_gd2.dll，将前面的“;”去掉，市php能够提供图形支持。

2.1.2到下 载最新的JPGRAPH包，根据自己安装的PHP版本来选择，比如PHP版本为5.1.X或者更高就应该选择下载JpGraph 2.x：如jpgraph-2.3.4.tar.gz，解压到mantis根目录下，重命名为jpgraph。打开mantis安装目录下新生成的 config_inc.php文件，添加：

$g_use_jpgraph   = ON;
$g_jpgraph_path   = '.' . DIRECTORY_SEPARATOR . 'jpgraph' . DIRECTORY_SEPARATOR.'src'.DIRECTORY_SEPARATOR;

2.1.3如果此时打开图标查看，可能会发现图表标题是乱码，这是字体设置问题。

打开mantis根目录下core文件夹下graph_api.php，找到function graph_get_font()在$t_font_map = array(后添加一行：

'chinese_gbk' => FF_SIMSUN,

其中'chinese_gbk' 是个别名，你也可以叫其他的；然后再打开mantis安装目录下的config_inc.php文件，添加一行：

$g_graph_font = 'chinese_gbk';

如果你的mantis采用的是gb2312编码，那么到此为止已经配置好了，如果是utf8编码的话，还需要找到jpgraph目录下src/jpgraph_ttf.inc.php，在文件中找到

elseif( $aFF === FF_SIMSUN ) {
     // Do Chinese conversion
     if( $this->g2312 == null ) {
          include_once 'jpgraph_gb2312.php' ;
          $this->g2312 = new GB2312toUTF8();
     }
     return $this->g2312->gb2utf8($aTxt);
 }

修改为：

elseif( $aFF === FF_SIMSUN ) {
     // Do Chinese conversion
     /*
     if( $this->g2312 == null ) {
          include_once 'jpgraph_gb2312.php' ;
          $this->g2312 = new GB2312toUTF8();
     }
     return $this->g2312->gb2utf8($aTxt);
     */
     return $aTxt;
 }

或者直接将整段注释掉，也可以直接删掉。再打开查看图表，应该没问题了。

2.2其他配置

打开mantis安装目录下的config_inc.php，添加：

 #登录界面默认语言
 $g_default_language  = 'chinese_simplified';
 #邮件服务器配置
 $g_smtp_host='smtp.gmail.com';
 $g_smtp_username='username';
 $g_smtp_password='password';
 $g_phpMailer_method =2;
 #关闭在左下角显示mantis版本号
 $g_show_version=OFF;
 #关闭在左下角显示查询结果数
 $g_show_queries_count = OFF;
 #网络管理员邮箱设置
 $g_webmaster_email  = ;
 #设置时区（北京）
 date_default_timezone_set('PRC');
 #设置文件上传类型（硬盘存储）和路径
 $g_file_upload_method = DISK;
 $g_absolute_path_default_upload_folder = 'D:/Root/mantis/upload/';

注意：

1.如果登录页面默认语言设置为中文，注册邮件是无法发出的，这是我实验了很多次得出的结论，相当郁闷

2.新版本中在配置邮件服务器时$g_use_phpMailer和$g_phpMailer_path是不需要配置的，同时php.ini也不需要做什么修改

这些可以根据自己实际需要来选择是否配置和修改，其他配置可以参见mantis安装目录下config_defaults_inc.php，将其中的项拷贝出来放到config_inc.php，然后修改即可。