Windows下开源缺陷跟踪系统mantis安装指南

1. 简介
mantis(螳螂)是一个基于php/MySQL/web的缺陷跟踪系统，最新版本是0.19.2。
要了解更多信息请到 http://www.mantisbt.org/。
2. 下载
mantis0.19.2   http://www.mantisbt.org/download.php
mysql4.1.8       http://dev.mysql.com/downloads/mysql/4.1.html
PHP5.0.3     http://www.php.net/downloads.php
apache2.0.52   http://httpd.apache.org/download.cgi

3. 安装步骤
   1）安装刚才下载的软件

   下面假设各软件的安装目录为

   c:/mantis-0.19.2

   c:/mysql-4.1.8

   c:/php-5.0.3

   c:/apache-2.0.52 
   我习惯下载zip版的程序，直接解压到一个目录就可以了。没有的话，只好下载windows_installer版本：）。
   a.安装apache2.0.52
   我下载的是 http://apache.freelamp.com/httpd/binaries/win32/apache_2.0.52-win32-x86-no_ssl.msi
   运行安装程序，安装时选择安装给当前用户，采用8080端口，不要安装成服务，对我来说没必要。安装后同样可以再安装成service  
   详细请参考：
   apahce在windows下的安装指南 http://httpd.apache.org/docs-2.0/platform/windows.html
   运行c:/apache-2.0.52/bin/apache.exe，在IE地址栏输入 http://localhost:8080/，可以看到安装成功。如果前面是安装成80端口的服务，则输入 http://localhost/
   b.其它的软件直接解压到自己想要的目录。当然如果你下载的是installer也是一样的，直接运行安装程序，无非是安装后多了几个启动的快捷菜单外加一些默认设置罢了。
   2）为apache配置php
   打开c:/apache-2.0.52 /conf/httpd.conf文件，添加如下内容到文件尾
  #PHP 5
  LoadFile "c:/php-5.0.3/php5ts.dll"
  LoadModule php5_module "c:/php-5.0.3/php5apache2.dll"
  AddType application/x-httpd-php .php
 ＃PHP.ini path
  PHPIniDir "c:/php-5.0.3"
   3）php配置
   将c:/php-5.0.3下的php.ini-dist复制一份，并改名为php.ini
   查找include_path,改为include_path=".;c:/php-5.0.3/pear"
   查找extension_dir,改为extension_dir="c:/php-5.0.3/ext"
   查找php_mysql.dll,将这一行前面的“;”号去掉
   保存文件
   4）为apache安装mantis系统
   打开c:/apache-2.0.52 /conf/httpd.conf文件，添加如下内容到文件尾
   Alias /mantis "c:/mantis-0.19.2/"
   <Directory "c:/mantis-0.19.2/">
    Options Indexes
    AllowOverride None
    Order allow,deny
    Allow from all
  </Directory>

  查找DirectoryIndex，添加index.php到后面。像这样DirectoryIndex index.html index.html.var index.php
   5)创建数据库

   运行c:/mysql-4.1.8/bin/mysqld，启动数据库
   mysql -uroot -p
   create database bugtracker;
   use bugtracker;
   source c:/mantis-0.19.2/sql/db_generate.sql;

  当然你也可以用其它GUI工具创建数据库。
   6)mantis配置
   将c:/mantis-0.19.2下的config_inc.php.sample复制一份，并改名为config_inc.php

  如果你改了root的密码，打开这个文件，设置$g_db_password='yourpassword'
   7)windows环境
   将c:/php-5.0.3添加到path中
   8)启动bug tracking system
   首先启动apache和mysql,
   在址栏输入 http://localhost:8080/mantis/index.php或者 http://localhost/mantis/index.php
   应该可以看到初始页面了。用amdinistrator/root登录，mantis 开始为你工作。
   9)邮件服务器配置
   在c:/php-5.0.3/php.ini文件中查找smtp，将localhost改为你的发件服务器，如SMTP = smtp.163.com

   在php.ini文件中查找sendmail_from，将前面的分号去掉，并在后面填上邮件地址
   在c:/mantis-0.19.2/config_inc.php文件中添加
   $g_smtp_host='smtp.163.com';
   $g_smtp_username='yourusername';
   $g_smtp_password='yourpassword';

   $g_phpMailer_method =2;

 

   查找$g_return_path_email，将后面的邮件地址改为有效的地址， 这一点非常重要，不然将无法正常发送激活注册的邮件。

   config_inc.php其它邮件地址最好也改为有效的地址。

   $g_smtp_username,$g_smtp_password在服务器需要验证时用，不需验证时不用加，或设为
   $g_smtp_username=''
   $g_smtp_password=''
   现在你可以注册新用户，并使用发送邮件功能了。
   10)中文显示

   在APACHE的httpd.conf配置文件中将AddDefaultCharset ISO-8859-1 改为 AddDefaultCharset OFF
   在c:/mantis-0.19.2/config_inc.php中添加
   $g_default_language='auto';
   11)文件上传 

在config_inc.php中添加

$g_allow_file_upload=ON;

$g_file_upload_method=DISK;

并且在c:/mantis-0.19.2下面新建一个upload目录

当你以管理员身份登录，新建项目时,在上传文件路径那一项填上upload即可，如果要为每一个项目指定不同的目录,可以先在upload下建一个projectname，在上传文件路径那一项填上upload/projectname，注意最好不要用中文目录名，目录名中间也不要带空格. 。
4.后记

集成apache+php+mysql+...的安装工具， http://www.apachefriends.org/en/xampp.html用它来安装very easy，即使你什么都不懂，也只要几分钟。
下载windows下的安装包,setup,找到apache/conf/httpd.conf，在文件最后添加
Alias /mantis "c:/mantis-0.19.2/"
   <Directory "c:/mantis-0.19.2/">
    Options Indexes
DirectoryIndex index.php
 AllowOverride None
 Order allow,deny
 Allow from all
  </Directory>
启动apache和mysql就行了。发邮件的功能及其它设置见上面的3.9)...

唯一不好的是，他安装了一整套软件，如果你的机器上已经安装了mysql等，就会浪费一些硬盘空间。

调试的时候注意把瑞星邮件监视等关掉，否则php可能不会返回合适的出错提示，浪费大量时间。