最開始想找一個?Bug 跟蹤管理系統時，是想用 BugZilla 的，但是在實際安裝使用時發現在 Windows 下安裝非常費勁，需要自己改動 n 多的地方才能獲得一個可以在Windows下使用的 Hack 版本，而且郵件設置怎么都沒有成功，最后只好放棄。
在網上查找BugZilla相關資料的時候發現了 Mantis，這也是一個開源的 Bug 跟蹤管理系統，基于 PHP+MySQL，支持 Windows；相對于BugZilla，比較輕量級，不過對于我們的開發團隊來說是完全夠用了，所以我在放棄了BugZilla以后就轉向了 Mantis 。
下面是我寫的一個安裝指南。
Bug 跟蹤管理系統 Mantis 在 IIS5 下安裝指南 v1.1
v1.1：修改部分錯誤；
修改JPGraph和PHPMailer設置部分路徑誤為C:\PHP\C:\PHP\...的錯誤；
JPGraph設置部分增加對PHP.INI中extension_dir的修改；
v1.0：完成于2004-03-18；
這是我寫的一篇 Mantis 在 Windows IIS 下的安裝指南，如果對你有幫助我會很高興。
轉載請注明出處。
和BugZilla一樣，Mantis也是一個開源的Bug管理系統；基于PHP+MySQL，可以運行在Windows/xnix平臺上；它的主頁是http://www.mantisbt.org/，目前最新版本是0.18.2。
和BugZilla不一樣的是，Mantis是輕量級的，在功能上相對比較少一些（特別是報表模塊），不過對于小型的開發團隊是完全夠用了。
對于我來說，Mantis是完全夠用了，而且最重要的一點是：Mantis直接提供對Windows平臺的支持，不需要自己做n多的修改做出一個Hack版本才能運行在Windows平臺上。在多次嘗試使用BugZilla失敗后，我轉向了Mantis。
可能已經有人注意到了，Mantis是螳螂的意思，我想給Mantis起這個名字的人一定是希望這只螳螂能夠把我們系統中的Bug統統吃掉吧:-D？
說明：
1.由于我使用的是IIS，沒有使用apache，因此我下面的安裝說明全部都是在IIS上進行的；
2.下面所說的操作都是我的事后回憶，有些細節可能不是很正確，如果有問題，請大家自己嘗試解決，或與我聯系：TurboNetCobra@hotmail.com（不可能每信必復，如果發送郵件后沒有回音，敬請諒解）；
3.文中所說的軟件的最高版本號均為截止到2004-03-17的最高版本號；
好了，下面我們開始安裝Mantis。
需要作的準備工作：
1.從http://www.mysql.com/downloads/index.html下載MySQL安裝文件，請下載Windows安裝文件，當前有多個版本可供下載，出于穩定起見，建議下載推薦的Production release (recommended)，目前最高版本是4.0.18；同時可以下載MySQL Control Center，一個免費的MySQL圖形管理界面程序；
2.從http://www.php.net/downloads.php下載PHP安裝文件，目前最高版本4.3.4，請下載Windows安裝文件；其中“PHP 4.3.4 installer”EXE包可以自動進行設置，但是比ZIP包缺少一些模塊，如果需要使用圖形報表功能，建議下載“PHP 4.3.4 zip package”ZIP包，因為圖形報表需要使用到包括在ZIP報中的PHP擴展模塊，不過ZIP需要自己手工設置；
提示：對于象我這樣的懶人，你可以這樣做：兩個都下載，先安裝EXE包自動完成設置工作，然后將ZIP包解壓縮到PHP安裝目錄，覆蓋原文件，然后手工修改PHP.ini配置文件，讓PHP載入擴展模塊，就可以得到一個完整的PHP安裝包了*^_^*；
3.從http://www.mantisbt.org/download.php下載Mantis安裝文件，目前最高版本是0.18.2；
4.（可選項）如果希望使用Mantis的PHPMailer發信功能和圖形報表功能，則還需要PHP的PHPMailer模塊和JPGraph模塊，請分別到http://phpmailer.sourceforge.net 和http://www.aditus.nu/jpgraph/index.php下載，最新版本分別是1.71和1.14；
準備就緒，下面就可以開始安裝了；
1.安裝MySQL，建立數據庫；
MySQL的安裝很簡單，解壓縮下載得到的ZIP包，運行其中的setup.exe文件，然后就可以用“Next”大法輕松安裝；這里假設你的MySQL安裝在C:\MySQL下；
安裝后運行C:\mysql\bin\下的winmysqladmin.exe文件，如果在系統任務欄顯示綠燈，表示你的MySQL服務已經啟動了；
1)修改MySQL默認的root用戶密碼：
在命令行下進入c:\mysql\bin，運行如下命令：
???C:\>cd mysql
???C:\mysql>cd bin
???C:\mysql\bin>mysql -u root mysql
??????mysql>UPDATE user SET Password=PASSWORD( ’<new_root_password’> ) WHERE user=’root’;
??????mysql>FLUSH PRIVILEGES;
說明：請將< new_ root_password>改為你設定的root用戶的新密碼。更改密碼后，要用root用戶訪問mysql，必須使用mysql -u root -p，按提示輸入入正確的root新密碼。
2)創建mantis數據庫：
注意：進行這一步以前，需要先把你的Mantis安裝包解壓縮，因為創建數據庫需要用到其中的建表SQL文件。
??????mysql>create database mantis;
??????mysql>connect mantis;
??????mysql>source <mantis_path>\sql\db_generate.sql
說明：請將<mantis_path>改為你解壓縮Mantis安裝包的路徑；
3)創建mantis用戶，并賦給對Mantis數據庫的相應權限：
??????mysql>GRANT SELECT, INSERT, UPDATE, DELETE, INDEX, ALTER, CREATE, DROP, REFERENCES, LOCK TABLES,
?????????????????CREATE TEMPORARY TABLES ON mantis.* TO mantis@localhost IDENTIFIED BY ’<mantis_password>’;
??????mysql>FLUSH PRIVILEGES;
說明：請將<mantis_password>改為你設定的mantis用戶的密碼；這個密碼在下面的操作中要寫到Mantis的配置文件中；
4)完成MySQL初始化工作，退出
??????mysql>exit
上面的數據庫操作也可以直接在mysqlcc圖形界面中完成。
2.安裝PHP
我的安裝方法就是上面說的懶人安裝方法*^_^*，好像就沒有什么特別操作了；在使用圖表和PHPMail時需要修改PHP.ini，這些修改我會在后面講到。
3.設置Mantis
1)打開IIS管理器，在默認網站中增加一個虛擬目錄Mantis，指向你的Mantis解壓縮目錄（這里使用D:\WebSite\Mantis），在“屬性”窗口的“文檔”頁面增加默認文檔“index.php”；
2)將D:\WebSite\Mantis中的config_inc.php.sample復制一份，改名為config_inc.php，修改其中的設置；
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數據庫的連接參數，管理員的郵箱的；其他的要根據你的實際情況進行修改。
下面是我的一些自定義參數，其中一些參數（$g_use_jpgraph 和$g_use_phpMailer的設置請參照下面的內容）：
$g_use_iis = ON; # 使用IIS
$g_show_version = OFF; # 不在頁面下部顯示 Mantis的版本號
$g_default_language = ’chinese_simplified’; # 默認語言為簡體中文
$g_show_project_menu_bar = ON; # 顯示項目選擇欄
$g_show_queries_count = OFF; # 在頁腳不顯示執行的查詢次數
$g_default_new_account_access_level = DEVELOPER; # 默認用戶級別
$g_use_jpgraph = ON; # 使用圖形報表
$g_jpgraph_path = ’C:/PHP/includes/JPGraph/src/’; # JPGraph路徑
$g_window_title = ’Mantis Bug 跟蹤管理系統’; # 瀏覽器標題
$g_page_title = ’Mantis Bug 跟蹤管理系統’; # 頁面標題欄
$g_enable_email_notification = ON; # 開通郵件通知
$g_smtp_host = ’smtp.mail.net’; # SMTP 服務器
$g_smtp_username = ’mailuser’; # 郵箱登錄用戶名
$g_smtp_password = ’mailpwd’; # 郵箱登錄密碼
$g_use_phpMailer = ON; # 使用 PHPMailer 發送郵件
$g_phpMailer_path = ’C:/PHP/includes/PHPMailer/’; # PHPMailer 的存放路徑
$g_phpMailer_method = 2; # PHPMailer 以 SMTP 方式發送 Email
$g_file_upload_ftp_server = ’ftp.yourftp.com’; # 上傳文件 FTP
$g_file_upload_ftp_user = ’ftpuser’; # FTP 登錄用戶名
$g_file_upload_ftp_pass = ’ftppwd’; # FTP 登錄密碼
$g_short_date_format = ’Y-m-d’; # 短日期格式，Y 大寫表示 4 位年
$g_normal_date_format = ’Y-m-d H:i’; # 普通日期格式
$g_complete_date_format = ’Y-m-d H:i:s’; # 完整日期格式
完成以上設置以后，你就可以使用Mantis了，打開IE，輸入http://localhost/mantis，應該就可以看到Mantis的登錄頁面了，你可以用默認用戶名administrator和密碼root登錄進去，進行管理設置。
4.Mantis的初步安全設置
1)在Mantis目錄下有一個admin目錄，如果你在IE中打開這個目錄下的index.php查看，你就會知道這個目錄是進行Mantis Administration的，使用這個模塊可以檢查你的Mantis是否安裝完全，對舊版本的Mantis進行升級，對Mantis的頁面CSS文件進行修改；使用這個管理模塊是不需要用戶名和密碼的，因此任何人都可以通過這個管理模塊查看你的Mantis系統信息，而且由于有升級模塊，在這里還可以直接對數據庫進行修改；因此如果被未授權的人打開，結果會是什么樣不用我多說；最好因此按照系統的建議，在配置完成后將這個admin目錄刪除；注意一定是刪除而不是改名！改名后仍然是可以訪問的！
2)在添加一個管理員用戶后，刪除系統默認的administrator用戶。
5.PHPMail的設置
默認情況下，Mantis使用內置的Mailto()函數進行郵件的發送，包括新用戶注冊發送密碼、Bug改變提醒、重設密碼等郵件的發送都使用MailTo()來完成，不過實際使用中發現，MailTo函數好像不支持需要校驗的郵件服務器，比如我的263郵箱每次都提示需要校驗，所以我給PHP安裝了PHPMail模塊，設置Mantis使用PHPMailer發送郵件。
1)下載PHPMailer：從http://phpmailer.sourceforge.net下載，最新版本是1.71;
2)安裝PHPMailer：將下載下來的phpmailer-1.71.zip解壓縮到C:\PHP\includes \PHPMailer目錄下；
3)修改Windows目錄下的PHP.ini，找到include_path，增加C:\PHP\includes \PHPMailer目錄；
4)如上表所示，設置$g_use_phpMailer、$g_phpMailer_path和$g_phpMailer_method三個參數；
5)現在應該就可以使用PHPMailer進行郵件發送了；
6.圖形報表的設置
默認情況下，Mantis的圖形報表是關閉的，需要安裝JPGraph模塊并設置$g_use_jpgraph為ON才能打開圖形報表；
1)下載JPGraph：從http://www.aditus.nu/jpgraph/index.php下載JPGraph的安裝文件，目前最高版本是1.14；
2)將下載下來的jpgraph-1.14.tar.gz解壓縮到C:\PHP\includes目錄下；
3)打開config_inc.php文件，修改$g_jpgraph_path為JPGraph的src目錄，$g_use_jpgraph為ON；
4)修改Windows目錄下的PHP.ini文件，將“;extension=php_gd2.dll”和“;extension=php_iconv.dll”兩行前面的分號刪除；另外如果extension_dir項不正確，請把extension_dir改為正確的值（應該是extension_dir = "./extensions/"，我這里不知道為什么是extension_dir = "./"，大概就是因為使用懶人安裝方法的緣故吧
）；
5)將C:\PHP\dlls下面的iconv.dll復制到Windows\System32目錄下，以上兩個步驟使PHP自動載入php_gd2和php_iconv.dll模塊，這兩個模塊是JPGraph在顯示圖表和進行漢字編碼轉換是所必須的；
6)修改JPGraph的src目錄下的jpgraph.php；將CACHE_DIR和TTF_DIR分別定義為Windows下的Temp目錄和Fonts目錄，如下所示
DEFINE("CACHE_DIR","E:/WinTemp/Temp/jpgraph_cache");
DEFINE("TTF_DIR","C:/WinNT/Fonts/");
7)現在再打開Mantis的統計頁面，可以看到多了分別按狀態等進行統計的圖形報表，包括柱圖、餅圖和線圖；
8)不過如果你的界面語言是用簡體中文或者繁體中文，那么你會看到圖形中的漢字都是亂碼，這是因為Mantis對于JPGraph的編碼設置不正確造成的，JPGraph會自動將漢字轉換為UTF-8編碼，但是需要在調用JPGraph的時候對標題等SetFont，Mantis沒有做這個操作，因此漢字顯示出來都是亂碼，解決方法是在Mantis\core\graph_api.php中增加對圖形標題等設置字體的代碼；
對于柱圖和線圖，要設置圖形標題和x、y軸標題、節點標題：
??//Set the title and axis font if the default_language is set to chinese
??if (config_get(’default_language’) == ’chinese_simplified’){
????$graph->title->SetFont(FF_SIMSUN,FS_NORMAL);
????$graph->xaxis->title->SetFont(FF_SIMSUN,FS_NORMAL);
????$graph->yaxis->title->SetFont(FF_SIMSUN,FS_NORMAL);
????$graph->xaxis->SetFont(FF_SIMSUN,FS_NORMAL);
????$graph->yaxis->SetFont(FF_SIMSUN,FS_NORMAL);
??}
??else if (config_get(’default_language’) == ’chinese_traditional’){
????$graph->title->SetFont(FF_CHINESE,FS_NORMAL);
????$graph->yaxis->title->SetFont(FF_CHINESE,FS_NORMAL);
????$graph->xaxis->title->SetFont(FF_CHINESE,FS_NORMAL);
????$graph->xaxis->SetFont(FF_CHINESE,FS_NORMAL);
????$graph->yaxis->SetFont(FF_CHINESE,FS_NORMAL);
????};
????
對于餅圖，要設置圖形標題和圖例名稱：
??//Set the title and legend font if the default_language is set to chinese
??if (config_get(’default_language’) == ’chinese_simplified’){
????$graph->title->SetFont(FF_SIMSUN,FS_NORMAL);
????$graph->legend->SetFont(FF_SIMSUN,FS_NORMAL);
??}
??else if (config_get(’default_language’) == ’chinese_traditional’){
????$graph->title->SetFont(FF_CHINESE,FS_NORMAL);
????$graph->legend->SetFont(FF_CHINESE,FS_NORMAL);
??};
??
大家可以找到位置自己修改，簡單的說就是在graph_api.php中每個“$graph->title->Set(…”后面根據當前的圖表是柱圖、線圖還是餅圖分別加上上面兩段；
9)現在你的圖形報表應該就可以顯示中文了。
好了，Mantis的配置工作到此就結束了，現在你的Mantis功能應該是完全而且是安全的了，相對于BugZilla，Mantis的確很“輕量”，不過我的想法是夠用就好，對于小團隊，Mantis足夠應付80％的日常Bug管理工作了。