Mantis1.2.19 在Windows 平台上的安裝配置詳解

安裝環境：

　　WindowsXP 32

　　phpstudy

一、簡介

　　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安裝分為兩部分，以下詳細介紹mantis自身的安裝。

首先，Mantis官方下載地址為 http://www.mantisbt.org/download.php，下載版本：mantisbt-1.2.19.zip

其次，PHPstudy官方下載地址為http://www.phpstudy.net/a.php/198.html 

1、安裝

(1)將下載的mantisbt-1.2.19.zip壓縮包進行解壓，放在D:\php目錄中，並將檔案夾更名為：mantisbt

(2)將下載的phpMyAdmin-4.4.4-all-languages.zip壓縮包進行解壓，放在D:\php目錄中，並將檔案夾更名為：phpMyAdmin

2、配置

(1) 安裝phpstduy，運行.exe即可。

(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,…    }