安裝環境:
WindowsXP 32
Apache2.2.22+PHP5.4.39+MySQL5.5.28
一、簡介
MantisBT是由PHP開發的、基於WEB的缺陷跟蹤系統,並采用開源數據庫MySQL,構成一個完整的開源解決方案,如下圖1所示。MantisBT的主要功能可以分為3個部分:管理、缺陷報告和統計分析。每個部分又有一些子功能,子功能下面還有一些具體的功能,其功能結構,可以用圖2來描述。
圖1
圖2
MantisBT的功能特點:
(1)支持多項目、多語言。
(1)權限設置靈活,不同角色有不同權限,還支持自定義角色。
(1) 可以建立缺陷之間的關聯或依賴關系,從而更有效地管理項目。
(1)缺陷統計分析功能比較強,有多種直方圖和圓餅圖,並能導出CSV文件供Excel作進一步分析。
(1) 有自定義字段功能,可以滿足企業的一些特殊要求。
(1) 缺陷可以在不同項目間移動。
(1) 主頁可發布公告、項目相關新聞,方便信息傳播。
(1) 個人可定制Email通知功能,每個用戶可根據自身的工作特點訂閱相關的缺陷狀態郵件。
(1) 可以定制軟件公司特定的缺陷處理流程。
與Bugzilla相比,Mantis有如下優點:
第一、Mantis相對Bugzilla有更好的操作界面。
第二、安裝和使用都相對簡單一點。對於一般的項目, Mantis作缺陷跟蹤,已經綽綽有余。
二、下載安裝
由於Mantis是建立在PHP、MySQL環境之上的,所以Mantis安裝分為兩部分,既要安裝PHP、MySQL等支撐平台,還要完成自身的安裝。支撐平台的安裝可以參照Windows搭建Apache+MySQL+PHP環境。以下詳細介紹mantis自身的安裝。
首先,Mantis官方下載地址為 http://www.mantisbt.org/download.php,下載版本:mantisbt-1.2.19.zip
其次,PHPMyAdmin官方下載地址為http://sourceforge.net/projects/phpmyadmin/ ,下載版本:phpMyAdmin-4.4.4-all-languages.zip
1、安裝
(1)將下載的mantisbt-1.2.19.zip壓縮包進行解壓,放在D:\php目錄中,並將文件夾更名為:mantisbt
(2)將下載的phpMyAdmin-4.4.4-all-languages.zip壓縮包進行解壓,放在D:\php目錄中,並將文件夾更名為:phpMyAdmin
2、配置
(1) 確認apahce和mysql服務已經啟動
(2) 打開瀏覽器,輸入http://localhost/phpMyAdmin,輸入MySQL的登錄用戶名與密碼(root/123456),在“SQL”中執行創建數據庫腳本:create database mantisdb;
或者在“數據庫”中:填寫“mantisdb”、“utf8_general_ci”,點擊“創建”,創建成功.
(3) 打開瀏覽器,輸入http://localhost/mantisbt/admin/install.php進入相關配置
依次輸入:
mysql (數據庫類型)
localhost (服務器名)
root (mantis數據庫擁有者的用戶名)
123456 (mantis數據庫擁有者的密碼)
mantisdb (mantis數據庫名)
root (mysql數據庫管理員用戶)
123456 (mysql數據庫管理員密碼)
最后點擊“Install/Upgrade Database”這個按鈕,安裝開始,其實就是在MySQL中創建相關的表和初始化一些數據的過程,在我的電腦上花了大約七八秒鍾,然后就顯示完成信息了。如果各個條目的右邊都顯示綠色的“GOOD”字樣的話,那就恭喜你,你已經成功安裝了MantisBT,如果有些條目顯示的不是“GOOD”,那就要回頭檢查一下,多半是數據庫權限不夠的問題,比較省事的辦法就是我上面的做法,直接給MantisBT使用root賬號,就不會有權限的問題了。
(4) 查看是否可打開 mantis 登錄頁面(http://localhost/mantisbt/login_page.php)
(5) 配置完成的 Mantis 只有一個默認的系統管理員用戶:administrator,密碼: root。
(6)你會看到登錄界面,登錄界面下面有兩行紅字:
Warning: You should disable the default 'administrator' account or change its password.
Warning: Admin directory should be removed.
都是安全方面的warning,前一個說administrator這個管理員賬號的密碼得改,這個簡單,administrator的默認密碼是“root”,登錄進去,在My Account這個標簽下面修改就可以了,修改密碼的時候還需要你提供真實可用的Email地址。
另外一個warning也不難解決,如它所說,刪除“Admin”目錄,我的是“D:\php\mantisbt\admin”這個目錄。
三、漢化
默認情況下,顯示的語言是英文,現在需要將它漢化為中文,設置如下:
修改配置文件: 在 Mantis 目錄下 config_defaults_inc.php
修改前: $g_default_language = 'english';
修改后: $g_default_language = 'chinese_simplified';
四、郵件配置
1、修改配置文件: 在 Mantis 目錄下 config_defaults_inc.php中設置“Mantis Email Settings”的相關信息,包括下列內容:
(1) 將$g_administrator_email、$g_webmaster_email、$g_from_email、$g_return_path_email等設為有效的郵件地址;
(2) 將$g_phpMailer_method值設為2,表示以smtp方式發送郵件;
(3)將$g_smtp_hosty設定為有效的郵件服務器主機名,如’mail.iflashbuy.com’;
(4)為$g_smtp_username 和$g_smtp_passwordy設定一個登錄郵件服務器的有效用戶賬號和口令。
//Mantis Email Settings
$g_administrator_email='test@iflashbuy.com';
$g_webmaster_email='test@iflashbuy.com';
$g_from_email='test@iflashbuy.com';
$g_return_path_email= 'test@iflashbuy.com';
$g_use_phpMailer = ON; # 使用 PHPMailer 發送郵件
$g_phpMailer_method=2; # PHPMailer 以 SMTP 方式發送 Email
$g_smtp_host='mail.iflashbuy.com'; # SMTP 服務器
$g_smtp_username = 'test@iflashbuy.com'; # 郵箱登錄用戶名
$g_smtp_password='密碼'; # 郵箱登錄密碼
Note: 這邊示例使用的是公司的郵箱作為郵件服務器測試成功。
大家經常會遇到,無法發送郵件,而又不知道如何解決的問題,可以通過以下方法進行調試:
進入郵件測試界面,在瀏覽器中輸入測試地址,例如:http://localhost/mantisbt/admin/test_email.php ,點擊測試,就可以對發送失敗原因進行檢測。
2、附上較理想的郵件設置
五、用 Administrator 注冊新用戶時設置密碼
在 Mantis 目錄下 config_defaults_inc.php 文件中找到 $g_send_reset_password
修改前:$g_send_reset_password = ON;
修改后: $g_send_reset_password = OFF;
特附上設置前與設置后的圖:
六、配置局域網訪問
關閉防火牆,在局域網的任一電腦中輸入:http://ip/mantisbt/login_page.php即可成功訪問。
若失敗,可嘗試以下操作:
在Listen 127.0.0.1:80下一行加入一段代碼Listen 192.168.1.101:80
注:192.168.1.101為Mantis服務器的IP地址
如果以后郵件系統不希望出現bug的地址為127.0.0.1的,請把Listen 127.0.0.1:80注掉。只留Listen 192.168.1.101:80
七、上傳附件配置
1、在 Mantis 目錄下 config_defaults_inc.php 文件中找到Mantis File Upload Settings
$g_allow_file_upload= ON;
$g_file_upload_method= DISK; #上傳到硬盤
$g_max_file_size=2097152; #附件大小限制為2MB
$g_allowed_files= 'txt,jpg,jepg,gif,bmp,doc'; #允許上傳的文件類型
$g_disallowed_files='exe,com'; #不允許上傳的附件類型
$g_absolute_path_default_upload_folder='D:\php\mantisbt\upload'; #默認的文件上傳的絕對路徑
$g_preview_attachments_inline_max_size=99999; #直接顯示任何小於這個字節大小的bmp,png,gif,jpg格式的上傳文件。
2、在MantisBT目錄下新建一個目錄upload(注意最好不要用中文目錄名,目錄名中間也不要帶空格)
八、解決CSV導出的中文顯示是亂碼
假如保存的文件為administrator.csv,其中中文亂碼解決辦法:
1、重命名administrator.csv為administrator.txt
2、另存時選擇編碼方式為ASCII改名過來,就可以了
九、JpGraph
在進行缺陷分析時,須要繪制直方圖、圓餅圖、趨勢圖等,為了解決這個問題,要安裝JpGraph。如果不安裝這個軟件,也可以將數據拷貝到Excel等,再進行分析。如想了解JpGraph,可以參考官方網站http://jpgraph.net/上的相關內容。例如,JpGraph2.3.3安裝到D:\php\mantisbt\library的目錄下,要修改3個地方來完成配置。
1、 Config_default_inc.php為JpGraph進行設置,即在”Mantis JPGRAPH Addon”段中修改下列相關的參數。
$g_use_jpgraph=ON; #將off改為on;
$g_jpgraph_path=’D:\php\mantisbt\library\jpgraph’; #JpGraph所在路徑
$g_graph_font=’simsun’; #定義所用的字體,這里指定宋體
在文件中的”Signup and Lost Passwod”段中修改下列兩個參數:
$g_system_font_folder=’c:\WINDOWS\Fonts’;
$g_font_per_captcha=’simsun.ttc’;
2、在mantisbtmantisbt\plugins\MantisGraph\core\graph_api.php文件中增加中文字體simsun(宋體),其代碼如下:
Function graph_get_font(){
$t_font_map=array(
'simsun'=>FF_SIMSUM, //增加宋體映射
'arial' =>FF_ARIAL,
…
}
3、在mantisbt/library/jpgraph/jpgraph_ttf.inc.php文件中注shi字符集編碼轉換,因為我們已全面采用了UTF-8字符集,其代碼如下:
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;
}
未解決中文問題。。。
后記:
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數據庫的連接參數,管理員的郵箱的;其他的要根據你的實際情況進行修改。
配置文件加載順序:先加載config_defaults_inc.php,后加載config_inc.php。config_inc.php中的值會覆蓋config_defaults_inc.php
如果要修改,建議拷到config_inc.php中修改。