mantis安装与配置

安装Mantis
下载地址：http://downloads.sourceforge.net/mantisbt/mantisbt-1.1.7.zip
我下载的是当时的最新稳定版本1.1.7。
安装：
把Mantis的压缩包解压到自己指定的目录，我的路径是D:\mantis。
配置Apache
        在Apache的配置文件中设置mantis的目录为虚拟目录。修改httpd.conf，在文件末尾添加以下文字，以配置mantis目录的访问权限：
        Alias /mantis "d:/mantis/"
           
            Options Indexes
            AllowOverride None
            Order allow,deny
            Allow from all
            
        注意：这里特别注意，必须写成反斜杠/，不能写成斜杠\,否则会无法正确显示mantis。
为Mantis创建表、数据
         访问http://127.0.0.1/mantis/admin/install.php ，出现如下界面，并按照图示填写：
        
        这里和以前的mantis比较大的不同，以前的mantis会提供一个 db_generate.sql数据库脚本来创建mantis需要的数据库，而新版mantis则通过install界面来自动创建，特别需要注意的是Hostname一栏，默认值为localhost，而如果MySQL 安装时变动了端口（mysql的默认端口是3306，如果安装时变动了则按此说明修改），则应该写成 localhost:端口号。
        这里还要注意一个问题，有时创建时会失败，提示：【Checking PHP support for database type 】的错误：BAD   database is not supported by PHP. Check that it has been compiled into your server.查看apache的log发现有如下错误：PHP Warning: PHP Startup: Unable to load dynamic library 'd:\\Program Files\\PHP\\ext\\php_mysql.dll' - \xd5\xd2\xb2\xbb\xb5\xbd\xd6\xb8\xb6\xa8\xb5\xc4\xc4\xa3\xbf\xe9\xa1\xa3\r\n in Unknown on line 0 这是因为不能正确加载php_mysql.dll库，导致php与mysql不能连携，请检查上边安装PHP后进行配置时需要添加的环境变量中是否添加了，如果已经添加，请确认是否重启系统了。
        安装成功后界面如下：
        
启动Mantis
        访问http://127.0.0.1/mantis/ ，出现登录界面，mantis的默认用户名为administrator，默认密码为root。
设置中文显示：
编辑mantis安装目录下的config_defaults_inc.php文件
搜索$g_default_language，并修改为：$g_default_language                = 'chinese_simplified';
注意：有的版本的mantis简体中文的表示方法不同，可以根据下边数组$g_language_choices_arr        = array()里边定义的各种语言中找相应的简体中文的表示方法。

配置邮件服务器：
        在Mantis中有新用户注册时，会给其指定的邮箱发一封邮件，点开邮件中的链接才可以设定密码，因此需要给Mantis添加发送邮件的功能。
下载地址：http://jaist.dl.sourceforge.net/ ... PMailer-ML_v1.5.zip
        如果安装的是其他版本的PHP，需要选择适合自己PHP版本的phpmailer的版本，我选择的是适合PHP5的版本，可以自由选择路径把它解压，我把它解压到D:\PHPMailer-ML_v1.5。
修改d:\mantis\config_inc.php，添加以下内容：
           # phpmailer
            $g_use_phpMailer = ON;
            $g_phpMailer_path = 'D:/PHPMailer-ML_v1.5/';
            $g_smtp_host = 'smtp.163.com';//发送邮件服务器
            $g_smtp_username = 'scmroad';//发送邮件账户的用户名
            $g_smtp_password = '123456';//邮件地址用户名对应的密码
            $g_phpMailer_method = 2;//此处的数值可为0，1，2;0为调用了一个mantis内置的mail（）函数来发送邮件；1为sendmail方式；2为使用smtp方式，登录到邮件服务器内来发送邮件
            
            $g_return_path_email = '[email protected]';//这个是管理员自己的邮件地址，接受对mantis操作的提示邮件
修改mantis的时间
在config_inc.php中添加如下语句：
         #时区设置
        putenv("TZ=Asia/Shanghai");
        如果想设置时间显示的格式，还可以再加上如下语句：
         $g_complete_date_format = 'Y-m-d H:i:s';
        单引号内的字母分别代表：年-月-日 时-分-秒，可以根据自己的习惯修改格式。
        如果这样操作不能解决问题，需要修改php.ini的date.timezone = PRC，修改php.ini后，需要重新启动Apache服务。
登陆界面上的两个警告的处理
        刚配置好的mantis登陆界面会有如下两个警告：
        WARNING: You should disable the default "administrator" account or change its password.
        WARNING: Admin directory should be removed.
   解决第一个警告，需要修改administrator的密码。
   解决第二个警告，需要把mantis安装目录下的admin文件夹删除，一般情况，为了以后能够继续使用，可以重命名为_admin，或者直接将其压缩成一个admin.rar。
配置文件上传
1、在config_inc.php里添加如下两句：
        $g_allow_file_upload   = ON;
        $g_file_upload_method = DISK;
2、在mantis安装目录下新建一个文件夹upload，再在mantis建立的项目中把文件上传路径设置为“upload”（通过Web方式），这样上传的文件就会存放在upload目录中
3、修改上传文件的大小限制：
        config_inc.php 中添加 $g_max_file_size = 5000000; # 5MB（根据自己的需要修改）
        php.ini中修改upload_max_filesize = 5M 和 post_max_size = 5M
4、如果upload文件夹安全性高，不具备写权限，上传文件时会有问题，这时需要给此文件夹增加可写权限。（方法：右键点图片保存的文件夹,选择"属 性"->"安全",点"添加"->"高级"->"立即查找",在查找结果中选择"everyone"后点"确定",在点"确定",然后 把"everyone"的"完全控制"钩上,最后点"确定"）
6、设置附件浏览功能：
        比如，在提交一个bug的时候，有时候会有截图提交附件情况，如果想直接看到错误截图而不想自己下载后再看，这也是 需要设置就能实现的。但是这个功能只是针对bmp, png, gif, jpg格式的图片文件而言，提交的doc等文件就不在之列了。只需将config文件中de $g_preview_attachments_inline_max_size 进行设置即可实现此功能。当将这个设置为0的情况，那么查看bug的时候是永远不会出现附件贴图的，但是如果你将这个设置为一个足够大的尺寸，那么就会在 bug里直接出现图片，这个数值是以字节计算，如果图片上传为32210字节，则你 把$g_preview_attachments_inline_max_size=32211，而且任何小于这个字节大小的bmp, png, gif, jpg格式的图片文件直接显示了。
配置统计报表
下载Jpgraph：http://www.jpgraph.cn/soft/jpgraph-2.3.4.rar
        注意：JPGraph 1.x 版本是针对php4，2.x 是针对php5的，请根据php的版本下载对应版本。
        下载后把它解压到mantis安装目录下的core文件夹下的jpgraph文件夹内。
在config_inc.php里添加如下语句：
        #统计报表
        $g_use_jpgraph = ON;
        $g_jpgraph_path = "D:/mantis/core/jpgraph/src/"; #设置jpgraph的路径
        $g_graph_font = 'chinese_gbk';
在php.ini将“;extension=php_gd2.dll”前面的分号删除，这个模块是JPGraph在显示图表和进行汉字编码转换是所必须的。
修改mantis安装目录下的core目录下的graph_api.php，搜索graph_get_font，在graph_get_font函数中添加：'chinese_gbk' => FF_SIMSUN
修改jpgraph文件夹下的src目录下的jpgraph_ttf.inc.php，将111行到118行注释掉，如果版本不同，可能行数不对应，参考如下内容：
           
解决CSV导出的中文显示是乱码：
        假如到处的文件为administrator.csv，其中中文乱码解决办法：重命名administrator.csv为administrator.txt,另存时选择编码方式为ASCII改名过来，就可以了
说明
1、如果是在windows下装，要特别注意，文件路径的“/”，不能使用“\”，这在php配置文件中是注释的含义。
2、Mantis的设置是这样保存的：在config_defaults_inc.php中保存这Mantis的默认设置，用户自己的设置信息保存在 config_inc.php中，如果某个选项在config_inc.php中有设置，则系统使用config_inc.php中的设置，否则使用 config_defaults_inc.php的系统默认设置;config_inc.php.sample则是Mantis给出的一个用户设置文件例子。
        所以我们需要修改config_inc.php文件中的设置，设置很简单，各个参数的意义可以参见 config_defaults_inc.php，这里对每个参数都有详细的解释，虽然是E文，不过应该都能看懂;Sample中给出的一些设置是一定需要修改的，比如MySQL数据库的连接参数，管理员的邮箱的;其他的要根据你的实际情况进行修改。