Flarum のインストール入門から基本設定まで

このチュートリアルは初心者向けの基本チュートリアルです。詳しい方はご容赦ください。本記事では主に composer を使ったインストールについて説明します。共有ホスティングには適していませんが、もちろんローカルで composer によるインストールを済ませてから共有ホスティングへアップロードすることもできます。

インストールの準備

まずサーバー環境を確認してください。サーバーは以下の条件を満たしている必要があります：

Web サーバー: Apache (with mod_rewrite), Nginx, or Lighttpd
PHP 5.6+ および以下の拡張機能: mbstring, pdo_mysql, openssl, json, gd, dom, fileinfo
MySQL 5.5+

LNMP で構築した VPS を使用する場合、通常は fileinfo 拡張機能が不足しています。include/upgrade_php.sh ファイルの内容を自分で変更し、

--disable-fileinfo

を

--enable-fileinfo

に変更してください。その後 ./upgrade.sh を実行して 4 を選択し、PHP をアップグレードします。共有ホスティングの場合はホスティング業者にお問い合わせください。一般的には Linux の共有ホスティングへのインストールをおすすめします。
（更新：LNMP 1.5 以降では fileinfo のオン・オフを選択できるようになり、インストール時に有効にするかどうかを指定できます）

インストールを開始

Flarum CV 統合パッケージを使用する場合は、まず解凍し、ZIP 圧縮してウェブサイトのルートディレクトリにアップロードしてから解凍してください。詳しくは

{cat_insidepost id="116"}

VPS に公式サイト版をインストールする場合は、cd でウェブサイトのルートディレクトリに移動し、次のコマンドを入力してください（サーバーに Composer がインストール済みであることを確認してください。LNMP には標準で付属しているため、ここでは詳しく説明しません）。

composer create-project flarum/flarum . --stability=beta

上記の手順が完了したら、ウェブサイトのルートディレクトリにある assets/ と storage/ の権限を 777 に変更してください（インストール要件を満たしていない場合は変更を求めるメッセージが表示されます）。その後データベースを新規作成します。ウェブサイトのトップページを開くと、そのままインストール画面に進めます。順に コミュニティ名、データベース名、データベースユーザー名、データベースパスワード、データベースプレフィックス（空欄を推奨）、スーパ管理者名、メールアドレス、パスワード、パスワードの確認 を入力し、Install をクリックしてください。

擬似静的設定（NGINX）

nginx.conf ファイルを変更するか、各種コントロールパネルで擬似静的設定を行い、以下の内容を追加してください：

location / { try_files $uri $uri/ /index.php?$query_string; }
location /api { try_files $uri $uri/ /api.php?$query_string; }
location /admin { try_files $uri $uri/ /admin.php?$query_string; }

location /flarum {
    deny all;
    return 404;
}

location ~* \.php$ {
    fastcgi_split_path_info ^(.+.php)(/.+)$;
    fastcgi_pass unix:/var/run/php5-fpm.sock;
    include fastcgi_params;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    fastcgi_index index.php;
}
    
location ~* \.html$ {
    expires -1;
}

メール設定

インストールが正常に完了したら、まず 基本設定 でサイトの説明とウェルカムバナーの内容を設定し、続いてもちろんメール送信の設定を行います。そうしないと新規ユーザーが登録できません（広告スパムを気にしない場合は user-management ユーザー管理プラグインを有効にし、メールアドレスによる登録を無効にすることもできます）。

ここではメール設定を 163 を例に説明しますが、実際には海外の無料メールサービスを使用するほうがおすすめです。設定画面では、最初の項目である SMTP だけは固定です（サーバー上に独自のメールサービスを構築していて、デフォルトの mail を使用できる場合を除く）。残りの設定は、使用するメールサービス提供業者の SMTP 設定に応じて変更してください。

権限設定

ここでは、いくつか注意すべき項目について説明します：

ユーザー一覧を表示 - beta7 で追加された項目です。検索権限に使用され、登録ユーザーに設定した場合、ゲストは検索できません。
投稿の審査を不要にすると返信の審査を不要にする - これは分かれた 2 つの項目です。自分のニーズに応じて設定してください。
登録ユーザーグループの権限を制限する必要がある場合は、デフォルトユーザーグループ プラグインを有効にしてください（CV 版にはすでに付属しています）。
プライバシーカテゴリ または VIP カテゴリ を設定する必要がある場合は、ノードを 1 つ追加し、投稿の表示対象を対応するユーザーグループに設定するとともに、投稿・返信などの権限も変更してください。

ノード（セクション）の設定

操作のコツ：カテゴリを作成すると、新しいカテゴリが下部のタグバーに表示されます。それをノードに変更するには、マウスで上部のノード領域までドラッグ＆ドロップしてください。既存のノードの下で右寄りにドロップすると、カテゴリはそのノードの子カテゴリになります（スクリーンショット右側のようになります）。既存のノードの下で横並びになるようにドロップすると、カテゴリは親ノードになります（スクリーンショット左側のようになります）。
ノードとタグの関係：Flarum では、ノードはカテゴリ（セクション）であり、タグは共通の tags です。スクリーンショット左側のように、公告を選択してダウンロード、質問などのタグを付けることができます。右側のスクリーンショットでは、公告には版務のタグを 1 つだけ付けることができます。

本チュートリアルは以上で終了です。