MantisBTのソースを表示

[[Category:課題追跡システム]]
[[Category:ウェブアプリケーション]]
[[en:MantisBT]]
[https://mantisbt.org MantisBT] (Mantis Bug Tracker) は [[PHP]] で書かれたバグトラッカーです。MantisBT が備えている機能一覧はウェブサイトを見てください。

== インストール ==

{{AUR|mantisbt}} パッケージを[[インストール]]してください。

[[:カテゴリ:ウェブサーバー|ウェブサーバー]]やアプリケーションサーバー ([[UWSGI]] など) を選択してアプリケーションを使えるようにします。

== 設定 ==

''mantisbt'' には正規の [https://mantisbt.org/docs/master/en-US/Admin_Guide/html-desktop/ 管理ガイド] が存在し、ガイドに従ってセットアップすることができます。
全ての設定は {{ic|/etc/webapps/mantisbt/config_inc.php}} に記述します。
* 互換性のある [[:カテゴリ:データベース管理システム|DBMS]] をセットアップして 'Database Configuration' セクションを使って mantisbt と DBMS を接続してください。
* サインアップ時の CAPTCHA を無効化しない場合 'Anonymous Access / Signup' セクションに特別な注意が必要です ([[#PHP 拡張]]や [[#TTF フォント]]を参照)。
* [[wikipedia:Simple_Mail_Transfer_Protocol|SMTP]] を使いたい場合は 'Email Configuration' セクションでセットアップしてください。mantisbt はデフォルトで phpmailer を使用しますが、[[Postgrey|グレイリスティング]]を使用するメールサーバーにメールを遅れません。

どんな場合でも、''mantisbt'' を正しく動作させるには満たさなくてはいけない要件が存在します:

=== PHP 拡張 ===

* '''mysqli''' ([[MySQL]]/[[MariaDB]] を使用する場合)
* '''gd''' (ユーザーのサインアップ時に [[wikipedia:CAPTCHA|CAPTCHA]] を使用する場合)

=== TTF フォント ===

* CAPTCHA の作成に使用する [[フォント#Pacman|TrueType フォント]]をインストールしてください。
* 使用したいフォントのパスと名前を設定してください:
{{hc|/etc/webapps/mantisbt/config_inc.php|2=
# trailing slash is important!
$g_system_font_folder = '/usr/share/fonts/TTF/';

# here DroidSans.ttf from the package {{Pkg|ttf-droid}} is used for illustration
$g_font_per_captcha = 'DroidSans.ttf';
}}

{{Note| PHP インスタンスの [http://www.php.net/manual/en/features.safe-mode.php#ini.open-basedir open_basedir] に TTF パス（例えば {{ic|/usr/share/fonts/TTF}}）も含めるようにしてください！}}

=== ウェブサーバー ===

==== nginx + uwsgi ====

以下はバグトラッカーでサブドメインを使用する設定例です。以下で記述しているファイルは {{ic|/etc/nginx/nginx.conf}} の中で読み込む必要があります。''mantisbt'' でサブフォルダを使う構成の場合、多少の修正が必要です。

{{hc|/etc/nginx/nginx.conf|<nowiki>
server {
  listen 80;
  listen [::]:80;
  server_name bugs.mydomain.org www.mydomain.org;
  return 301 https://bugs.mydomain.org$request_uri;
}
server {
  listen 443 ssl;
  listen [::]:443 ssl;
  server_name www.bugs.mydomain.org;
  return 301 https://bugs.mydomain.org$request_uri;
}
server {
  listen 443 ssl;
  listen [::]:443 ssl;
  server_name bugs.mydomain.org;
  include tls.conf;
  root /usr/share/webapps/mantisbt;
  access_log /var/log/nginx/access.bugs.mydomain.log;
  error_log /var/log/nginx/error.bugs.mydomain.log;
  include letsencrypt-challenge.conf;

  location ~ ^/(admin|core|doc|lang) {
    deny all;
  }

  location / {
    index index.php;
    try_files $uri $uri/ @mantisbt;
  }

  location @mantisbt {
    include uwsgi_params;
    uwsgi_modifier1 14;
    uwsgi_pass unix:/run/uwsgi/mantisbt.sock;
  }

  location ~  \.php?$ {
    include uwsgi_params;
    uwsgi_modifier1 14;
    uwsgi_pass unix:/run/uwsgi/mantisbt.sock;
  }

  # Deny serving files beginning with a dot, but allow letsencrypt acme-challenge
  location ~ /\.(?!well-known/acme-challenge) {
    access_log off;
    log_not_found off;
    deny all;
  }
}
</nowiki>
}}

[[UWSGI]] を使うことでリソースの消費量が少ないセットアップを構築できます。

{{hc|/etc/uwsgi/mantisbt.ini|<nowiki>
[uwsgi]
procname-master = mantisbt
plugins = php
master = true
socket = /run/uwsgi/%n.sock
uid = http
gid = http
processes = 10
cheaper = 2
cheaper-step = 1
idle = 600
die-on-idle = true

php-allowed-ext = .php
php-docroot = /usr/share/webapps/mantisbt
php-index = index.php
php-set = date.timezone=Europe/Berlin
php-set = open_basedir=/tmp/:/usr/share/fonts/TTF:/usr/share/webapps/mantisbt:/usr/share/webapps/mantisbt/core:/etc/webapps/mantisbt
php-set = session.save_path=/tmp
php-set = session.gc_maxlifetime  21600
php-set = session.gc_divisor      500
php-set = session.gc_probability  1
php-set = post_max_size=64M
php-set = upload_max_filesize=64M
php-set = always_populate_raw_post_data=-1
php-set = extension=curl
php-set = extension=gd
php-set = extension=imagick
php-set = extension=intl
php-set = extension=mysqli
</nowiki>}}

上記のファイルを修正した場合、[[Systemd#ユニットを使う|systemd]] を使って [[nginx]] を再起動して ''mantisbt'' の [[UWSGI#サービスの起動|uwsgi ソケットを起動・有効化]]してください。

=== データベース ===

アプリケーションが利用できるようになったら、[https://bugs.mydomain.org/admin/install.php /admin/install.php] からデータベースをセットアップしてください。ページの指示に従えば ''mantisbt'' はテーブルを作成します。

{{Note|[[#ウェブサーバー]]の設定を一時的に編集してページを表示できるようにする必要があります。[[#nginx + uwsgi]] を使用する例の場合:
{{hc|/etc/nginx/nginx.conf|<nowiki>
location ~ ^/(core|doc|lang) {
  deny all;
}</nowiki>}}
}}

=== 管理者 ===

''mantisbt'' によって最初に作成されるアカウントは ''administrator'' でパスワードは ''root'' です。
{{Warning|ログインしたらすぐに ''administrator'' ユーザーのパスワードを変更して設定を行ってください。}}

{{Note|[[#ウェブサーバー]]の設定を再度変更して、''admin'' 設定が使えなくなるようにしてください。[[#nginx + uwsgi]] を使用する例を見てください。}}

== 使用方法 ==

これで ''mantisbt'' のセットアップは全て終了です。''administrator'' ユーザーは新しいプロジェクトを作成してユーザーに権限を与えることができます。

== 参照 ==

* [https://mantisbt.org 公式ウェブサイト]
* [https://mantisbt.org/wiki/doku.php 公式 wiki]
* [https://mantisbt.org/documentation.php 公式ドキュメント]
* [https://www.mantisbt.org/bugs 公式バグトラッカー]
* [https://mantisbt.org/forums/ 公式フォーラム]
* [https://mantisbt.org/mailinglists.php 公式メーリングリスト]
* [https://github.com/mantisbt MantisBT on github]
* [irc://irc.freenode.net/mantisbt #mantisbt on freenode.net]