搭建環境:
apache_2.2.13-win32-x86-no_ssl.msi
php-5.3.0-Win32-VC6-x86.zip
mysql-5.0.22-win32.zip
mantisbt-1.1.7.zip
輔助工具:
EMS(mymanager_lite.zip):可以通過界面形式操作Mysql數據庫
PhpMailer(PHPMailer-ML_v1.5.zip):搭建Mantis郵件服務器
Jpgraph(jpgraph-2.3.4.rar):實現Mantis的統計報表功能
安裝并配置Apache下載地址:
http://httpd.apache.org/download.cgi運行下載的軟件開始安裝,開始都是next,到如下界面時:
設置系統信息
Network Domain:
在Network Domain下填入您的域名(比如:ok.com)
Server Name:
在Server Name下填入您的服務器名稱(比如:
www.ok.com,也就是主機名加上域名;如果自己的ip是公網ip,這里填寫自己的ip,其他人即可訪問自己搭建的mantis,如果有自己的域名,這里可以填寫域名,別人可以通過這個域名訪問自己的mantis,因為我自己電腦沒有公網ip,在網上找了幾個把內網動態解析的軟件也沒有成功,所以這個功能沒有驗證,需要外網訪問mantis的可以驗證)
Administrator's Email Address:
在Administrator's Email Address下填入系統管理員的聯系電子郵件地址(比如:
423114976@qq.com)
上述三條信息僅供參考,其中聯系電子郵件地址會在當系統故障時提供給訪問者,三條信息均可任意填寫,無效的也行(以后需要修改時可以在apache安裝目錄下的conf文件夾下找到httpd.conf這個文件進行編輯,查找ServerName可以修改服務器名,想讓別人通過這個訪問,需要去掉這句話前邊的#;查找ServerAdmin可以修改管理員的郵件地址)。
端口選擇:
下面有兩個選擇,圖片上選擇的是為系統所有用戶安裝,使用默認的80端口,并作為系統服務自動啟動;另外一個是僅為當前用戶安裝,使用端口8080,手動啟動。
注意:檢查80端口有沒有被占用,我安裝時就由于打開IIS,導致apache無法啟動。如果要查看80端口被哪個程序占用,可以在命令行窗口中輸入netstat -an,找到占用該端口的程序的PID,然后在任務管理器中點"查看"->"選擇列...",勾選"PID",找到該PID的程序,結束任務。
3、接著到選擇安裝方式的界面,選擇Custom的安裝方式,這樣可以選擇安裝路徑,選擇好后一路next即可,知道Finish,安裝完成。
4、測試apache按默認配置運行的網站界面是否正常,在IE地址欄輸入“
http://127.0.0.1”,顯示It works,表示apache服務器已安裝成功。(以前版本的apache的默認網站界面有可能跟此版本的不同,如果沒有報錯基本都是正常的,為了確認,也可以到apache安裝目錄下的htdocs文件夾找到index.html,在本地打開看是否跟瀏覽器打開的相同)
3、配置(注意:修改配置文件后需要重啟apache,修改才能生效):
1)開始—>所有程序—>Apache HTTP Server 2.2—>Configure Apache Server—>Edit the Apache httpd conf Configuration file,點擊打開,這時打開的是apache的配置文件httpd.conf;
2)在Apache安裝目錄下,找到conf文件夾,打開里邊的httpd.conf。
安裝PHP下載地址:
http://windows.php.net/downloads ... 0-Win32-VC6-x86.zip選擇適合的版本:
在網上找到一段PHP版本的說明,如下:Download the VC6 builds if you are using the standard Apache.org web server. The VC9 builds should be used for the Apache Lounge binaries or IIS.
A Thread Safe version should be used if you install PHP as an Apache module. The Non Thread Safe version should be used if you install PHP as a CGI binary.
因為我安裝的是標準版的apache,而且需要以apache module模式安裝PHP,因此下載的是VC6的Thread Safe版本,大家可以根據自己的需要選擇適合的版本。
3、我下載的是壓縮包,把它解壓到指定的位置,我的設定在“D:\PHP”
4、配置:
1)把D:\PHP\php.ini-development或php.ini-production(如果是其他版本的PHP,可能需要改php.ini-dist)改成php.ini;
2)查找extension_dir,改為extension_dir="D:\PHP\ext" ,并去掉前邊的分號,因為ext文件夾下有很多我們可能需要調用的擴展庫;同時需要在系統環境變量的path里邊添加上php安裝路徑和其子路徑ext,方法是:“我的電腦”上右鍵—>屬性—>選擇“高級”標簽—>點選“環境變量” ,在“系統變量”下找到“Path”變量,選擇,雙擊或點擊“編輯”,將“;D:\PHP;D:\PHP\ext”加到原有值的后面,然后全部確定。
注意:添加后請務必重啟OS,才能生效,否則不能正確加載PHP擴展庫,比如mantis要用到的php_mysql.dll,不過可以先配置完,到安裝mantis的數據庫前再重啟。
3)查找php_mysql.dll,將這一行前面的號去掉,這樣PHP就能調用mysql模塊了,如果沒有就自己加進去extension_dir=php_mysql.dll
4)查找include_path,找到“; Windows: "\path1;\path2"”,把它下邊一行改為 include_path = ".;d:\PHP\PEAR" ,并去掉前面的分號,因為Mantis中用到了Pear庫,需要包含Pear庫。
5、將php以module方式與Apache相結合,使php融入Apache(如果下載的是.msi安裝版本的php,安裝中選擇支持apache 2.2.x,那么會自動配置apache的http.conf文件、mime.types文件和產生PHP的php.ini文件,由于,安裝版本內容不全,沒有ext和pear等目錄,所以,安裝完后,將解壓版解壓到剛才的安裝目錄下,此括號內是根據網上下載的配置文檔整理的,因為自己直接用的壓縮包,沒有驗證安裝版本的)
1)打開apache的配置文件http.conf,搜索#LoadModule ssl_module modules/mod_ssl.so ,在此句下邊添加如下兩行:
LoadModule php5_module D:/PHP/php5apache2_2.dll
PHPIniDir "D:/PHP"
第一行指以module方式加載php;
注意:D:/PHP/php5apache2_2.dll是PHP的安裝目錄下的dll文件,如果是apache2.2,必須寫"php5apache2_2.dll",如果是其他版本的apache,可以到php安裝目錄下找相應的dll文件,php與apache的版本一定要對應
第二行指明php的配置文件php.ini的位置。
2)搜索AddType application/x-gzip .gz .tgz,在這行下邊添加如下一行:
AddType application/x-httpd-php .php
你也可以加入更多,實質就是添加可以執行php的文件類型,比如你再加上一行“AddType application/x-httpd-php .htm”,則.htm文件也可以執行php程序了,你甚至還可以添加上一行“AddType application/x-httpd-php .txt”,讓普通的文本文件格式也能運行php程序。
3)目錄默認索引文件也可以改一下,因為現在加了php,有些文件就直接存為.php了,我們也可以把“index.php”設為默認索引文件,搜索DirectoryIndex,找到如下一段:
<IfModule dir_module>
DirectoryIndex index.html
</IfModule>
把中間一句修改為:
DirectoryIndex index.php index.html
優先順序可以自己排,我把index.php放在第一位了。編輯完成,保存,關閉。
6、驗證是否配置成功:
在apache的安裝目錄下的htdocs文件夾下建一個index.php文件,代碼如下:
<?php
phpinfo();
?>
在IE地址欄中輸入“
http://127.0.0.1”,如果看到phpinfo的界面,說明配置成功。
安裝Mysql下載地址:
http://download.mysql.cn/src/2006/0710/5543.html安裝:
在3個選項中選擇第3個Custom,在接下來的安裝中可以自己進行一些設置。
安裝路徑可以自由選擇
這里是詢問你是否要注冊一個mysql.com的賬號,或是使用已有的賬號登陸mysql.com,一般不需要了,點選“Skip Sign-Up”,按“Next”略過此步驟。
現在軟件安裝完成了,出現上面的界面,這里有一個很好的功能,mysql配置向導,不用向以前一樣,自己手動亂七八糟的配置my.ini了,將 “Configure the Mysql Server now”前面的勾打上,點“Finish”結束軟件的安裝并啟動mysql配置向導。
選擇配置方式,“Detailed Configuration(手動精確配置)”、“Standard Configuration(標準配置)”,我選擇“Detailed Configuration”。
選擇服務器類型
Developer Machine:開發測試類,mysql占用很少資源
Server Machine:服務器類型,mysql占用較多資源
Dedicated MySQL Server Machine:專門的數據庫服務器,mysql占用所有可用資源
大家根據自己的類型選擇了,一般選“Server Machine”,不會太少,也不會占滿,大家根據自己需要進行選擇,因為我是在自己電腦上測試搭建,所以選擇了第一個“Developer Machine”。
選擇mysql數據庫的大致用途
Multifunctional Database:通用多功能型,好
Transactional Database Only:服務器類型,專注于事務處理,一般
Non-Transactional Database Only:非事務處理型,較簡單,主要做一些監控、記數用,對MyISAM數據類型的支持僅限于non-transactional
隨自己的用途而選擇了,我這里選擇“Multifunctional Database”,按“Next”繼續。
對InnoDB Tablespace進行配置,就是為InnoDB 數據庫文件選擇一個存儲空間,如果修改了,要記住位置,重裝的時候要選擇一樣的地方,否則可能會造成數據庫損壞。我這里沒有修改,使用用默認位置,直接按“Next”繼續。
選擇您的網站的一般mysql訪問量,同時連接的數目
Decision Support(DSS)/OLAP:20個左右
Online Transaction Processing(OLTP):500個左右
Manual Setting:手動設置,自己輸一個數
我這里選“Decision Support(DSS)/OLAP”,按“Next”繼續。
是否啟用TCP/IP連接,設定端口,如果不啟用,就只能在自己的機器上訪問mysql數據庫了,我這里啟用,把前面的勾打上,Port Number:3306,按“Next”繼續。下邊的選項是設定服務器模式,建議勾選。
這個比較重要,就是對mysql默認數據庫語言編碼進行設置,第一個是西文編碼,第二個是多字節的通用utf8編碼,第三個可以選擇自己需要的編碼。按 “Next”繼續。
選擇是否將mysql安裝為windows服務,還可以指定Service Name(服務標識名稱),是否將mysql的bin目錄加入到Windows PATH(加入后,就可以直接使用bin下的文件,而不用指出目錄名,比如連接,“mysql.exe -uusername -ppassword;”就可以了,不用指出mysql.exe的完整地址,很方便)。按“Next”繼續。
這一步詢問是否要修改默認root用戶(超級管理)的密碼(默認為空),“New root password”如果要修改,就在此填入新密碼,“Confirm(再輸一遍)”內再填一次,防止輸錯。“Enable root access from remote machines(是否允許root用戶在其它的機器上登陸,如果要安全,就不要勾上,如果要方便,就勾上它)”。最后“Create An Anonymous Account(新建一個匿名用戶,匿名用戶可以連接數據庫,不能操作數據,包括查詢)”,一般就不用勾了,設置完畢,按“Next”繼續。
確認設置無誤,如果有誤,按“Back”返回檢查。按“Execute”使設置生效。
下邊是一些摘自網上的安裝出錯時的解決辦法,如果安裝時出現問題,可以參照下邊方法,可能會有幫助:
如果一次安裝不成功,卸載后,不會自動刪除安裝目錄下的文件和數據文件,應自己手動刪除才能重新安裝,否則會有影響
存在須刪除文件的地方:
1.你選定的安裝目錄或默認的安裝目錄
2.你指定的數據文件存放目錄
3. C:\Documents and Settings\All Users\Application Data目錄
如遇安裝完配置最后一步啟動服務失敗,原因可能是以前裝過沒有卸載干凈。可卸載重新安裝來解決,也可取消配置,在cmd用命令“net start mysql”啟動
安裝EMS,可以通過圖形界面操作Mysql數據庫
下載地址:
http://www.jspcn.net/mngtools/mymanager_lite.zip
安裝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/"
<Directory "d:/mantis/">
Options Indexes
AllowOverride None
Order allow,deny
Allow from all
</Directory>
注意:這里特別注意,必須寫成反斜杠/,不能寫成斜杠\,否則會無法正確顯示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后進行配置時需要添加的環境變量中是否添加了,如果已經添加,請確認是否重啟系統了。
注意:上圖說的那個CheckBox不要勾選,“Print SQL Queries instead of Writing to the Database”這個選項的意思是打印出SQL查詢,但是不實際執行創建數據庫的動作。如果是要安裝Mantis的話,不需要選這個選項。在選上這個選項的情況下點擊最下邊的Install\Update Database后會報錯,這個好像是Mantis的ADODB庫跟PHP邏輯之間的問題。由于某些原因,為了在修改或丟掉一些列之前丟掉約束,ADODB庫需要有活動的數據庫連接,并發出混有PHP邏輯的請求,很多手動重新創建的SQL請求是冗余的,因此會在選了“Print SQL Queries instead of Writing to the Database”這個選項時打印出的SQL代碼中丟失,所以導致報錯。
安裝成功后界面如下:
啟動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 = 'scmroad@163.com';//這個是管理員自己的郵件地址,接受對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行注釋掉,如果版本不同,可能行數不對應,參考如下內容:
/* 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);
}*/
解決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數據庫的連接參數,管理員的郵箱的;其他的要根據你的實際情況進行修改。