bugfree缺陷管理工具部署步骤详解（附PHP+MySQL环境准备与安装教程）

​bugfree是 BugFree 缺陷管理工具​ 的压缩包，BugFree 是个开源的 bug 跟踪系统，主要用来管项目里的 bug，记录谁发现的、谁修的、修到哪一步了，做开发、测试、项目管理都能用。

部署就是解压、配环境、建库、安装，下面用大白话一步步说，跟着做就能跑起来。

一、准备工作

1. 下载压缩包​

   安装包下载：pan.quark.cn/s/212ea3036…

2. 准备运行环境​

   • 需要 PHP + MySQL​ 环境，本地测试可用 XAMPP/WAMP，线上就用宝塔、LNMP 一键环境。
   • PHP 版本建议 5.2~5.6（BugFree 比较老，太高的版本可能要改配置）。
   • MySQL 5.0+。

3. 解压工具​

   • 用 7-Zip 或 WinRAR 解压 bugfree.rar，得到 bugfree目录，里面是网站文件。

4. 备份重要数据​

   • 如果是在已有环境里部署，先备份数据库和重要文件，防止覆盖出问题。

二、部署步骤

1. 解压到网站目录​

   • 把解压出来的 bugfree目录放到你的网站根目录，比如：

     • XAMPP：C:\xampp\htdocs\bugfree
     • 宝塔：/www/wwwroot/bugfree/

2. 设置目录权限​

   • 给这些目录可写权限：

     • bugfree/Attachment/
     • bugfree/Data/
     • bugfree/Log/

   • 宝塔里右键目录 → 权限 → 改成 755 或 777（看服务器配置）。

3. 创建数据库​

   • 在 phpMyAdmin 或数据库管理工具里新建一个数据库，比如叫 bugfree_db。
   • 记好数据库名、用户名、密码，安装时要填。

4. 配置数据库连接​

   • 打开 bugfree/protected/config/main.php，找到数据库配置段：

     'db'=>array(
         'connectionString' => 'mysql:host=localhost;dbname=bugfree_db',
         'username' => 'root',
         'password' => '你的密码',
         ...
     ),
     

   • 改成你的数据库信息，保存文件。

5. 浏览器访问安装向导​

   • 浏览器输入 http://localhost/bugfree/或你的域名 /bugfree/。

   • 进入安装页面，按提示一步一步走：

     • 检测环境（PHP、MySQL 版本是否符合）。
     • 填写管理员账号（用户名、密码、邮箱）。
     • 点“安装”，等进度条走完。

6. 安装完成后的收尾​

   • 删除或改名 bugfree/install/目录（防止别人再次安装）。
   • 登录后台（域名 /bugfree/index.php?r=site/login），默认管理员账号就是你刚才设的那个。

三、首次使用与基本操作

1. 登录后台​

   • 打开浏览器访问你的 BugFree 地址，输入管理员账号密码登录。

2. 创建项目​

   • 点“项目管理” → “新建项目”，填项目名称、描述、负责人。

3. 提交 Bug​

   • 在项目里点“提交 Bug”，填标题、重现步骤、严重程度、指派给谁修。

4. 跟踪 Bug​

   • 在 Bug 列表里看状态（新建、处理中、已修复、已关闭），更新进度。

5. 权限管理​

   • 在“用户管理”里添加测试、开发人员，分配不同权限。

​