BugFree 2.0 を XAMPP 環境で構築・設定する完全ガイド

BugFree 2.0 導入および XAMPP 連携構成の概要

ソフトウェア品質管理において、効率的な不具合追跡システムの構築は不可欠です。本記事では、オープンソースの不具合管理ツール「BugFree 2.0」と、ローカルサーバー環境を提供する「XAMPP」を組み合わせて運用可能な開発環境をセットアップする手順を解説します。これにより、チーム開発メンバーは外部コストをかけずに独自のタスク追跡基盤を確立できます。

1. ツール選定の背景と特徴

1.1 BugFree の機能概要

BugFree は、バグの登録、優先度分類、ステータス更新、報告書生成などのライフサイクル管理に対応しています。また、単なるバグ管理に留まらず、タスク割り当てや進捗管理の役割も担い、Web ブラウザベースのインタフェースを通じて直感的な操作を可能にします。

1.2 XAMPP デベロッパー環境のメリット

XAMPP（Cross-Platform, Apache, MariaDB, PHP, Perl）は、Windows、Linux、macOS で動作するクロスプラットフォームなパッケージです。これには HTTP サーバーである Apache、データベースの MySQL、スクリプト言語 PHP が標準同梱されており、追加設定なしで迅速なプロトタイピング環境が構築可能です。

2. ソフトウェア入手と前提確認

まずは各ツールの公式リポジトリから最新安定版を取得します。以下の互換性要件を満たしていることを事前に確認してください。

OS: BugFree および XAMPP の推奨バージョンと照合すること（例：Windows 10/11, Ubuntu, macOS）。
PHP バージョン: BugFree 2.0 に対応した PHP 7.x または同等のバージョンが必要となる場合があります。

2.1 ダウンロードと整合性検証

ファイルを取得した後、改ざん防止のためにハッシュ値の照合を行います。例として SHA256 チェックの処理ロジックを示します。

# 対象ファイルのハッシュ計算
sha256sum xampp-installer-bin.tar.gz

# 出力結果（例）
a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v2w3x4y5z6  xampp-installer-bin.tar.gz

取得したハッシュ値が公式リリースページに記載されている値と一致することを確認し、破損していないファイルをインストール対象として確定させます。

3. XAMPP のインストールと初期設定

3.1 インストール手順

ダウンロード済みのインストーラーを実行し、以下のポイントを押さえて設定を行ってください。

コンポーネント選択： Apache、MySQL、PHP は必須項目として選択します。必要に応じて FileZilla や Mercury Mail も選択可能です。
インストールパス： スペース文字や特殊文字を含まないパス（例：C:\xampp）を指定します。
起動設定： インストール完了後、即座にコントロールパネルを起動するオプションを有効にします。

3.2 トラブルシューティング

インストール後にサービスが起動しない場合、以下の要因が考えられます。

ポート競合の確認

Azure 80 ポートや MySQL 3306 ポートが他のプロセス（IIS など）で占有されている可能性があります。競合時は、設定ファイルの変更が必要です。

; Apache コンフィギュレーション例 (httpd.conf)
Listen 8080
ServerName localhost:8080

権限の問題回避

Windows 環境にて管理者権限がない場合にエラーが発生する場合は、XAMPP コントロールパネルを「管理者として実行」します。
Linux/macOS では以下のコマンドで権限を与えます。

sudo chown -R $USER:$USER /opt/lampp/htdocs
sudo chmod -R 755 /opt/lampp/htdocs

4. BugFree のデプロイと Web 設定

4.1 バーチャルホストの設定

ドメイン名を使ったアクセスを実現するために、ホストと Apache の設定を行います。

ホストファイルの編集： /etc/hosts に以下を追加。

127.0.0.1 tracker-dev

Apache 仮想ホスト定義： httpd-vhosts.conf に次のように記述します。

<VirtualHost *:80>
    DocumentRoot "/opt/lampp/htdocs/tracker-project"
    ServerName tracker-dev
    <Directory "/opt/lampp/htdocs/tracker-project">
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

4.2 設定ファイルの変更

BugFree ディレクトリ内の設定ファイルを変更し、接続情報を適切に設定します。

<?php
// アプリケーション基本設定変更
define('APP_BASE_URL', 'http://tracker-dev/bugfree');

// データベース接続情報
$conf_db_host = 'localhost';
$conf_db_name = 'bugfree_db';
$conf_db_user = 'root';
$conf_db_pass = '';
?>

この状態で、ブラウザより http://tracker-dev にアクセスすると、インストーラ画面が表示されます。

5. データベース構築と初期ユーザー

5.1 DB スキーマの準備

BugFree は MySQL データベースを使用するため、事前にスキーマをインポートする必要があります。PhpMyAdmin を経由する方法と、CLI 経由の方法があります。

PhpMyAdmin によるインポート： 「データベース」新規作成後、「インポート」タブで BugFree に付属する install.sql をアップロードし適用します。
CLI による適用： マスタークエリでデータ投入が可能です。

mysql -u root -p bugfree_db < /path/to/install.sql

5.2 システム管理者の作成

初期アクセス後の画面に従い、最初の管理者アカウントを作成します。以降、ユーザー管理画面から役割（エンジニア、テスター等）に応じた権限を付与できます。これにより、プロジェクト全体のバグ管理フローが円滑に進行します。

タグ: BugFree XAMPP Apache MySQL PHP

6月23日 21:00 投稿

異端開発室