MantisBT安装手册

环境搭建及Mantis安装、配置

由于Mantis是用php写的系统，而要调试php程序当然要用到apache+php+mysql，而

apache+php+mysql配置起来却又是很麻烦的事，这还不包括环境冲突、、、等等，这些又或者是那些导致配置失败的问题。但刚巧有这么一个套件可以省去这些以前是需要解决的问题，这个套件就是EasyPHP了。EasyPHP集成了：Apache、PHP、MySQL、PhpMyAdmin。

以上软件可参考文章最后的参考资料。

适用范围

本文介绍基于Windows下的Mantis BUG管理系统的搭建。

软件下载

Mantis下载地址：https://www.360docs.net/doc/2b8746662.html,/

EasyPHP下载地址：https://www.360docs.net/doc/2b8746662.html,/

本文以mantis-1.1.0a4+ EasyPHP-12.1为演示版本，并测试通过。

安装EasyPHP

安装EasyPHP很简单，双击下载到的EasyPHP-12.1_with_PHP-5.4.6-setup.exe，然后一直默认点击Next即可安装完成。当然啦，在License Agreement页面是必须选择I Access The Agreement……

软件默认目录：C:"Program Files"EasyPHP-12.1

若成功运行时，双击在Windows托盘的图标，可看到如下图所示，Apache、MySQL的右边都是显示“Started”并亮绿灯的。

（需要安装VC2005,2008运行库，如果启动Apache时报错：easyphp error in apache configuration file）

已知问题：

1、若Apache没有正常运行，可能是因为Apache的默认使用的80端口被占用（Apache端口修改方

法请继续往下阅读…）；

2、若找不到原因，请重新启动电脑，据说重新启动电脑可以解决80%的问题，希望你遇到的不是余下

的20%中的…

安装Mantis

1、将下载到的mantisbt-1.2.12.rar解压到mantis文件夹；

2、EasyPHP安装目录，打开C:"Program Files/ EasyPHP-12.1/www

3、将mantis文件夹复制到C:"Program Files/ EasyPHP-12.1/www下；

建立Bug数据库

1、右键Windows托盘的图标，选择“Local Web”

2、点击选择“mantis”，进入页面：

3、不用修改/填写任何值，直接点击页面最下方的“Install/Upgrade Database”按钮

4、成功后可看到如下页面：

OK，到此为止，Mantis系统已经搭建成功了。下面立刻验证一下是否已配置成功！

1、再次右键Windows托盘的图标，选择“Local Web”

2、点击选择“mantis”

配置完成的Mantis的只有一个默认的系统管理员用户：

账号：administrator

密码：root

中文版配置

配置完成时，Mantis默认为English系统，而要使用中文版Mantis则需要修改配置文件。

?配置方法：

将english 改为chinese_simplified

局域网访问

配置完成时，Mantis默认为只能够本机访问，若要在局域网内访问则需要修改Apache的配置文件。

??配置方法：

在Listen 127.0.0.1:80下一行加入一段代码 Listen 192.168.1.101:80

注：192.168.1.101为Mantis服务器的IP地址

验证配置是否成功：

在局域网任一电脑中通过IE登录Mantis系统

http:// 192.168.1.101/mantis/login_page.php即可正常访问。

口被占用

Mantis配置完成时，访问Mantis系统可能会出现端口被占用的问题(现象：无法访问mantis)，常见的原因是IIS默认端口为80，而Mantis配置完成时，默认的端口也是80。因此需要修改Mantis的端口或者是IIS的端口才可正常访问Mantis。

配置方法：

将Listen 192.168.1.101:80修改为 Listen 192.168.1.101:8001

修改完成后的代码片段如下所示：

验证配置是否成功：

在局域网任一电脑中通过IE登录Mantis系统

http:// 192.168.1.101:8001/mantis/login_page.php即可正常访问。

使用中遇到的问题总结：

1、部分用户访问mantis时，是英文界面和邮件乱发的解决方法管理->用户管理，点击用户名后在以下页面修改：

2、添加/删除导出excel列表的列

3、MantisBT如何让管理员控制用户密码

方法一：

在Mantis目录下config_defaults_inc.php文件中找到$g_send_reset_password，然后设置成：$g_send_reset_password = OFF 即可。

重新使用administrator账号及密码，登录mantis, 依次选择管理 ->用户管理 -> “创建用户”，可以看到填写密码的输入框啦！

方法二：

从MantisBT版本开始，创建用户后，必须由用户通过确认邮件进行修改密码，而管理员无权对用户的密码进行修改。这对于配置mail不成功的情况下很不方便。

以下配置就可以让管理员轻松管理用户的密码。

解决方式就是考虑修改Mantisbt PHP程序，增加一个密码修改框，这样管理员就可以直接修改用户密码了。

操作步骤如下：

1）修改文件manage_user_edit_page.php

找到位置，将以下代码粘贴到下面一行：

>

:

2）修改文件manage_user_update.php

在$f_user_id = gpc_get_int( 'user_id' );行下面粘贴以下代码：

$f_pass = gpc_get_string('password');

3）还是在文件manage_user_update.php中

找到该行: $result = db_query( $query );

有的版本是：$result = db_query_bound( $query, $query_params );

在该行下面粘贴下面代码：

//Reset the password if specified.

if ($f_pass) user_set_password($f_user_id, $f_pass);

这样一来就增加了Password (change only): 一列，以供管理员修改用户的密码（但是前提是管理员增加用户时不要勾选保护一项，否则管理员无法修改该用户密码）

4、Mantis邮件提醒配置

1.config_ini.php(拷贝的config_inc.php.sample改的)增加以下内容：

# --- Anonymous Access / Signup ---

$g_allow_signup = ON;

$g_allow_anonymous_login = OFF;

$g_anonymous_account = '';

$g_enable_email_notification =ON;

# --- Email Configuration ---

$g_phpMailer_method = PHPMAILER_METHOD_SMTP; # or PHPMAILER_METHOD_SMTP, PHPMAILER_METHOD_SENDMAIL

$g_smtp_host = 'https://www.360docs.net/doc/2b8746662.html,'; # used with PHPMAILER_METHOD_SMTP

$g_smtp_username = 'mantistracker@https://www.360docs.net/doc/2b8746662.html,';

# used with PHPMAILER_METHOD_SMTP

$g_smtp_password = 'ylh189'; # used with PHPMAILER_METHOD_SMTP

$g_administrator_email = 'mantistracker@https://www.360docs.net/doc/2b8746662.html,';

$g_webmaster_email = 'mantistracker@https://www.360docs.net/doc/2b8746662.html,';

$g_from_name = 'Mantis Bug Tracker';

$g_from_email = 'mantistracker@https://www.360docs.net/doc/2b8746662.html,'; # the "From: " field in emails

$g_return_path_email = 'mantistracker@https://www.360docs.net/doc/2b8746662.html,'; # the return address for bounced mail

# --- Attachments / File Uploads ---

$g_allow_file_upload = ON;

$g_file_upload_method = DATABASE; # or DISK

$g_absolute_path_default_upload_folder = ''; # used with DISK, must contain trailing \ or /.

$g_max_file_size = 5000000; # in bytes

$g_preview_attachments_inline_max_size = 512 * 1024;

$g_allowed_files = 'jpg,jpge,bmp'; # extensions comma separated, e.g. 'php,html,java,exe,pl'

# --- Branding ---

$g_window_title = 'MantisBT';

$g_logo_image = 'images/mantis_logo.png';

$g_favicon_image = 'images/favicon.ico';

2.所有PHP.INI文件（在EasyPHP-12.1文件下下面搜索）

修改以下内容：

SMTP = https://www.360docs.net/doc/2b8746662.html,

smtp_port = 25

3.使用非SSL协议端口时，需要注释掉config_defaults_inc.php文件中以下代码

$g_smtp_connection_mode = 'ssl';

4.配置发送邮件提醒

参照链接：https://www.360docs.net/doc/2b8746662.html,/forums/viewtopic.php?f=3&t=15398

5、找不到类别：APPLICATION ERROR #1502

mantisbt出现1502问题解决：

引起问题的原因：当提交的问题有分类，此时删除此分类，就会出现下面的情况。

问题描述：

APPLICATION ERROR #1502

没有找到类别。

请使用浏览器的“返回”按钮来返回到上一页，这样您可以找到发生了什么问题或者进行别的操作；您也可以点击导航栏中的其它项。

解决方法

找到bugtracker中的mantis_bug_table和mantis_category_table，查看两张表中

category_id是否一致，把与mantis_category_table中的category_id不一致时记录修改正确

即可

6、默认时区设置

（系统优先使用config_inc.php中的设置，否则使用config_defaults_inc.php的系统默认设置）

修改mantis的时间在config_defaults_inc.php中修改如下语句：

#时区设置

$g_default_timezone = 'Asia/Shanghai'

如果想设置时间显示的格式，还可以再加上如下语句：

$g_complete_date_format='Y-m-dH:i:s';

单引号内的字母分别代表：年-月-日时-分-秒，可以根据自己的习惯修改格式。

如果这样操作不能解决问题，需要修改php.ini的date.timezone=PRC，修改php.ini后，需要重新启动Apache服务。

个人时区可以根据个人情况设置(在个人资料修改)：

7、修改严重性

打开这个文件D:\mantis\lang\strings_chinese_simplified.txt

#$s_severity_enum_string =’10:新特性,20:微不足道,30:文字错误,40:不合理或别扭,50:次要误,60:严重错误,70:系统崩溃,80:系统死锁’;

$s_severity_enum_string =’10:建议,20:一般问题,30:严重问题,40:程序宕机’;

然后在文件config_defaults_inc.php文件中查找$g_severity_enum_string这个字段就是严重

性等级的字段，可以按照需要在后面的值中进行删减，比如我只需要4类，就如下修改：$g_severity_enum_string =’10:feature,20:trivial,30:text,40:tweak’;

因为Mantis的配置文件，是根据config_defaults_inc.php设置的，但凡是在config_inc.php 这个文件中进行声明的，都将依据config_inc.php为准.