Windows下开源缺陷跟踪系统mantis安装指南 V1.1.0rc3

关键词: mantis 缺陷跟踪 windows php apache mysql

1. 简介
mantis(螳螂)是一个基于php/MySQL/web的缺陷跟踪系统，最新版本是1.1.0rc3。
要了解更多信息请到http://www.mantisbt.org/。
2. 下载
mantis1.1.0rc3 http://www.mantisbt.org/download.php
mysql5.0.45 http://dev.mysql.com/downloads/mysql/5.0.html
http://dev.mysql.com/get/Downloads/MySQL-5.0/mysql-noinstall-5.0.45-win32.zip/from/pick#mirrors
PHP5.2.5 http://www.php.net/downloads.php
http://jp2.php.net/get/php-5.2.5-Win32.zip/from/a/mirror
apache2.2.6 http://httpd.apache.org/download.cgi
3. 安装步骤
1）安装刚才下载的软件
下面假设各软件的安装目录为
c:\mantis-1.1.0rc3
c:\mysql-5.0.45
c:\php-5.2.5
c:\apache-2.2.6
我习惯下载zip版的程序，直接解压到一个目录就可以了。没有的话，只好下载windows_installer版本：）。
a.安装apache-2.2.6
我下载的是http://www.eu.apache.org/dist/httpd/binaries/win32/apache_2.2.6-win32-x86-no_ssl.msi
运行安装程序，安装时选择安装给当前用户，采用8080端口，不要安装成服务，对我来说没必要。安装后同样可以再安装成service
Network Domain: localhost
Server Name: localhost
Administrator's email: webmaster@my.com
详细请参考：
apahce在windows下的安装指南 http://httpd.apache.org/docs-2.0/platform/windows.html
运行c:\apache-2.2.6\bin\apache.exe，在IE地址栏输入http://localhost:8080/，可以看到安装成功。如果前面是安装成80端口的服务，则输入http://localhost/
b.其它的软件直接解压到自己想要的目录。当然如果你下载的是installer也是一样的，直接运行安装程序，无非是安装
后多了几个启动的快捷菜单外加一些默认设置罢了。
2）为apache配置php
打开c:\apache-2.2.6\conf\httpd.conf文件，添加如下内容到文件尾
#PHP 5
LoadFile "c:/php-5.2.5/php5ts.dll"
LoadModule php5_module "c:/php-5.2.5php5apache2_2.dll"
AddType application/x-httpd-php .php
#PHP.ini path
PHPIniDir "c:/php-5.2.5"
3）php配置
将c:\php-5.2.5下的php.ini-dist复制一份，并改名为php.ini
查找;include_path,改为include_path=".;c:\php-5.2.5\pear"
查找extension_dir,改为extension_dir="c:\php-5.2.5\ext"
查找php_mysql.dll,将这一行前面的";"号去掉
保存文件
4）为apache安装mantis系统
打开c:\apache-2.2.6 \conf\httpd.conf文件，添加如下内容到文件尾
Alias /mantis "c:/mantis-1.1.0rc3/"
<Directory "c:/mantis-1.1.0rc3/">
Options Indexes
AllowOverride None
Order allow,deny
Allow from all
</Directory>
查找DirectoryIndex，添加index.php到后面。像这样DirectoryIndex index.html index.html.var index.php
5)windows环境
将c:\php-5.2.5添加到path中
6)启动bug tracking system
首先启动apache和mysql,
运行c:\apache-2.2.6\bin\apache.exe 启动apache
运行c:\mysql-5.0.45\bin\mysqld-nt.exe，启动数据库
在址栏输入http://localhost:8080/mantis/admin/install.php或者http://localhost/mantis/admin/install.php
bugtracker下面的填上root
(如何设置mysql用户名和密码不在本文讨论之内)
点install/update
Install was successful.
Please log in as the administrator and create your first project.
点create
应该可以看到初始页面了。用amdinistrator/root登录，mantis 开始为你工作。
7)邮件服务器配置
在c:\mantis-1.1.0rc3\config_inc.php文件中添加
$g_smtp_host='smtp.163.com';
$g_smtp_username='yourusername';
$g_smtp_password='yourpassword';
$g_phpMailer_method =2;
$g_return_path_email=yourusername@163.com;

$g_return_path_email应为有效的地址,如yourusername@163.com,这一点非常重要,不然将无法正常发送激活注册的邮件.
这些变量修改也可以修改config_defaults_inc.php来实现。
即config_inc.php可以重新定义config_defaults_inc.php中的值。
config_inc.php其它邮件地址最好也改为有效的地址.
$g_smtp_username,$g_smtp_password在服务器需要验证时用,不需验证时不用加
重启apache
现在你可以注册新用户,并使用发送邮件功能了。
8)中文显示
在c:\mantis-1.1.0rc3\config_inc.php文件中添加
$g_default_language = 'chinese_simplified';
9)上传文件
在config_inc.php中添加
$g_allow_file_upload=ON;
$g_file_upload_method=DISK;
并且在c:\mantis-1.1.0rc3下面新建一个upload目录
当你以管理员身份登录,新建项目时,在上传文件路径那一项填上upload即可,如果要为每一个项目指定不同的目录,可以先在upload下建一个projectname,在上传文件路径那一项填上upload\projectname
注意最好不要用中文目录名,目录名中间也不要带空格.
10)配置jpgraph
下载JpGraph Version: 2.3 http://www.aditus.nu/jpgraph/jpdownload.php
解压到c:\mantis-1.1.0rc3\jpgraph-2.3
在c:\mantis-1.1.0rc3\config_inc.php文件中添加
$g_use_jpgraph = ON;
$g_jpgraph_path = 'c:/mantis-1.1.0rc3/jpgraph-2.3/src/';
在c:\php-5.2.5中查找extension=php_gd2.dll,将这一行前面的“;”号去掉，到这里你可能已经注意到我只在需要使用时才启用php相应的扩展模块。
重启apache。
好,现在进入mantis系统，建好项目，分类，提交bug，可以在统计报表里查看各种图形了。
11)jpgraph的图例中文显示
打开c:\mantis-1.1.0rc3\core\graph_api.php
查找：graph_get_font()
在其中添加一行'chinese_gbk' => FF_SIMSUN,
在c:\mantis-1.1.0rc3\config_inc.php文件中添加
$g_graph_font = 'chinese_gbk';
打开c:\mantis-1.1.0rc3\jpgraph-2.3\src\jpg-config.inc.php
查找// DEFINE("TTF_DIR","/usr/X11R6/lib/X11/fonts/truetype/");
改为DEFINE("TTF_DIR","C:/windows/fonts/"); windows 2000下为c:/winnt/fonts/
查找 DEFINE('CHINESE_TTF_FONT','bkai00mp.ttf');
改为 DEFINE('CHINESE_TTF_FONT','simsun.ttc');
jpg-config.inc.php也可以不改，如果生成的图形中的字体想由自己定义，可以这样改。
这时，如果中文仍然是乱码，打开c:\mantis-1.1.0rc3\jpgraph-2.3\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 ) {
        return $aTxt;
    }
这是因为mantis的语言文件是utf-8的，这里把它当成gb2312再转一遍显然不对。

后记：
1.如果自己在php程序中使用jpgraph，可能也要修改才能避免中文乱码。
2.mantis加了一个自动安装数据库的部分，让安装更简单了，其它基本一样。
3.在5.0版上的mysql能正常运行了。

标签: mantis