Manual:Wiki family/ja

MediaWikiを使って複数のウィキを立ち上げる方法について以下に記します. 同じサーバーにある複数のウィキをウィキファミリーまたはウィキファームと呼びます. 既知のウィキファームの一覧は にあります.

原則
ウィキファミリーの最も一般的な設定では、単一バージョンのMediaWikiを実行します. このシナリオでは、以下に記す一般的な手順が必要です.
 * 1) まず通常の MediaWiki サイトをインストールし、そこからデータベースのテンプレートを作成します. 中身は完全に空である（どのテーブルにもデータがない）状態でも、ウィキファミリー内のいずれかのウィキについて初期ページ、ユーザ、ウィキ間リンクなど何か情報が追加されていても構いません.
 * 2) 複数の場所に対する通信が一つのMediaWikiに向かうようサーバを設定します. これは複数のドメイン、サブドメイン、サブディレクトリにまたがっていても構いません. この設定はシンボリックリンク、エイリアス、URLのrewriteなどのしくみを使って行うことができます.
 * 3) LocalSettings.phpでウィキファミリーの設定を行います. 設定は大きく分けて4つの部分で構成されています.
 * 4) まず第1に、ウィキごとに識別するためのコード $_SERVER['SERVER_NAME'] あるいは $_SERVER['REQUEST_URI'] (または同様の記述) や   を不変数 (および環境変数) で設定 (例: 変数名  ). 1、2番目の変数はウェブ呼び出し用、3、4番目はメンテナンス用スクリプトを指す (  パラメタを渡す). この時点でウィキの識別に失敗した場合は、必ず設定をやり直すとよい.
 * 5) 第2に設定変数をそれぞれのウィキ識別子に「基づいて」決める. 対象はこちら.
 * 6) 第3に、ウィキごとに異なる変数を決める. 対象はこちら.  もちろん   のように、他のファイルから取ってくることも可能.
 * 7) 第4に、LocalSettings.php の残りの部分で共通の要素を指定. 対象は拡張機能や外装など.
 * 8) 共有するリソースの設定もできます. 対象はユーザー、セッション、メディア (アップロード先他) ウィキ間リンクなど.
 * 9) ウィキファミリーに新しいウィキをインストールするには、データベースの構築と、それをデータベース・テンプレートに読み込み、これら準備が整ったら を走らせます. アップグレードその他のメンテナンスも作業は同様です.

このページの後半で上記のパーツをそれぞれ詳しく説明 (もしくは[更新が必要]と表示) します.

ウィキごとに設定を切り替える設定方法
これにより、同じソースコードを使って、一つのサーバに複数のウィキをインストールできるようになります.


 * 1) MediaWikiファイルをウェブサーバのウェブフォルダにアップロードする.
 * 2) 通常通りウィキの初期設定を行う.  詳細は  を参照.
 * 3) うまくインストールできたら、 をあなたのウィキのルートディレクトリに移動し、何のためのファイルなのか後でわかりやすい名前にファイル名を変更 (例: LocalSettings_myFirstWiki.php)
 * 4) 作成したいウィキの数だけ、上記の操作を2回、3回と繰り返し、各ウィキごとの新たな LocalSettings.php ファイルを作成 (例: LocalSettings_anotherWiki.php など)
 * 5) 2つ以上の別々にインストールしたウィキを統合、メインウィキのファイルから操作するには、各ウィキの LocalSettings.php ファイルのファイル名を変更してからメインウィキのフォルダに移動、各 LocalSettings.php ファイルを開いて  変数をメインウィキのフォルダを示す値に変更する.
 * 6) グローバルな設定用に LocalSettings.php ファイルを作成し、下記2つの方法からどちらかひとつを選んで実行.


 * 複数の (サブ) ドメインがサーバ内の特定のディレクトリにリンクする場合.


 * ウィキのドメインが共通で、パスが異なる場合の設定 (例: 、 ).

ウィキごとに異なるデータベースを使うことをお勧めします (そのために でウィキごとに異なる値を設定). もし使えるデータベースがひとつしかない場合には、ウィキごとに接頭辞 を変えると、インストールを分離できます.

さらに便利な設定として、認識できない URL を呼び出したときに「このウィキは利用できません. 設定を確認してください. 」とエラーメッセージを表示する代わりに、単に「メイン」のURLにリダイレクトする方法があります.

EXPORTを使う
この方法を用いる際、maintenance/update.php を実行するのに の値設定が必要となります. ただし、それが設定されていなくてもコマンドラインから設定することができます. 環境変数を設定することにより問題は回避できます.

サブディレクトリを使って複数ウィキを設定していた場合、以下のようなコマンドを実行すればいいでしょう.

confパラメータを使う
もし同一ファミリー内の各ウィキに別個の ファイルを使用しているなら、#Giant switch statementに述べたように、 パラメータを当てて にどの設定ファイルを使用するか命じます. 例:

Drupalスタイルのサイト
上記において、同じソースコードを使用して単独のサーバ上で複数のwikiをインストールしました. この設定はユーザに対して完全に透明で、画像ディレクトリの観点からはかなり安全であるという点が有利です.


 * 1) すべてのMediaWikiを含むベースディレクトリを作成します. 例えば です.

 ServerAdmin me@myserver.com DocumentRoot /home/web/wiki.mysite.com ServerName wiki.mysite.com CustomLog /var/log/apache2/wiki.mysite.log common # Alias for the site to be accessible Alias /mediawiki/code /home/web/mediawiki/code # Alias for Wiki so images work Alias /images /home/web/mediawiki/sites/wiki.mysite.com/images # If you want to password protect your site #  #   AuthType Basic #   AuthName "My protected Wiki" #   AuthUserFile /etc/apache2/htpasswd/users-mywiki #  require valid-user #  
 * 1) バージョンを宣言するディレクトリにMediaWikiと追加ツールを通常通りにインストールする (例えば )
 * 2) バージョン宣言のディレクトリをコードディレクトリにリンク.  例
 * 3) 画像と設定を含む「sites 」ディレクトリを作成:
 * 4) ウィキを通常の「/code」ディレクトリからセットアップ.
 * 5) インストール成功後に、LocalSettings.php をサイトチェック時に適合する /site ディレクトリに移動.  例: http://mysite.com/mywiki に対応するため、mysite.com.mywiki ディレクトリを作成.  例   詳細は Drupal の settings.php ファイルを参照.
 * 6) メディアファイルを使用するなら、サイトのディレクトリに images ディレクトリを作成.  例    必要なら書き込み可能に設定.
 * 7) Drupal-style LocalSettings.phpファイルをメインディレクトリに設置:
 * 8) サブサイトごとに LocalSettings.php の位置を修正. 次の修正には特に注意:
 * 9) まず   関連のコードをコメントアウト (1.15.3 では16-20行) 、  で「code」ディレクトリに指定されるのを回避.
 * 10) 続いて以下の2行を挿入、画像ファイルへのアクセスを設定. 例 :    ならびに   変数のリセットを防ぐため、2行の挿入位置は   (1.15.3 では25行) 呼び出しより以降にする.
 * 11) 必要に応じて他の調整をする.
 * 12) Apache 2 のインストールを準備. 例: wiki.mysite.com
 * 13) 必要なら「code」ディレクトリにリンクを作成. 例
 * 14) 適切なVHost 構成を作成:
 * 11. サイトをローカルに開設した場合、 ファイル名をサイト名に変更.  これでサイトは動作します.

私の場合、LocalSettings.phpとデータベースをインストールとアップデートするところから他のコードのコピーをしました. 注意点は、付随するDrupalコードに記入した は、コマンドラインからメンテナンスのスクリプトを走らせた場合に定義されないため、この方式を採用すると、加工しない限り、標準のメンテナンスのスクリプトは使えません.

Ubuntu 用に修正した Drupal スタイル方式
Ubuntu/Kubuntu で複数のウィキとサブウィキ (ネスト式を含む) を作成するには、上記の Drupal スタイルと基本的には同じ考え方で修正した、簡略版の方式が利用できます.
 * Ubuntuguide.org MediaWiki のコツ

複数のwiki でリソースを共有
異なる言語のウィキを複数持ち、さらにメディアファイルについては別の単一ウィキを使って同じファイルを共有したいとします.

例:


 * en.yourwiki.org -
 * fr.yourwiki.org -
 * de.yourwiki.org -
 * pool.yourwiki.org - これらウィキ全てにメディアファイルを提供（コモンズのように）
 * ウィキメディアのメディア共用のためのウィキとして と命名されたインターウィキが既に存在するので、ここではメディアファイルwikiは「pool」と命名. 
 * ウィキ名を決めるときは慎重に. メディアファイルウィキを「media」と命名しようとすると (例えば media.example.com)、命名法が埋め込みメディア画像の内部名前空間 ( [[media:file.ext]] ) と衝突する可能性があるからです. 

ファイルシステム上において、それぞれのwikiのためにフォルダを作成してください. 各ウィキでインストール スクリプトを実行します.

この方法ではソース・コードが重複します. この重複を取り除いてキャッシュパフォーマンスを改善するには、共通メディア用を除くそれぞれのウィキについて、以下の非 pool インストール用ディレクトリを pool ディレクトリのシンボリックリンクに置き換えます. （≤ MW 1.20.x）、 、 、 、 、 、 （≤ MW 1.17.x）、 、 、 、 、 （≥ MW 1.22.x ）.

THIS WILL NOT WORK. 例をあげるなら   の後に入力するのは次の通りです.  

Windows では以下のようなコマンドになります.

ウィキ間リンク
MySQL データベースを編集してすべてのウィキ間のウィキ間リンクを設定しなければなりません (お好みで をインストールしてご使用ください).
 * Interwiki (ウィキ間) テーブル
 *  iw_prefix - wikiの言語コードを入力. ドイツ語は「de」、英語は「en」、「fr」はフランス語、mediapoolwikiは「pool」.
 *  iw_url - wikiへの完全なURLを記入. 例えばドイツ語ウィキは「 http://de.yourwiki.org/index.php/$1 」(「$1」を忘れずに!)

インターウィキのテーブルには、作成する複数のウィキに対応するレコードをすべて入力します. (例＝日本語版用、英語版用、メディア用等)

こうして特定の記事を異なる言語版にある対応する記事にリンクすることができました. 例えば英語版のMain_Pageに Hauptseite 追加することで、「ドイツ語版」のメインページにリンクが作成されます. 詳細情報は を参照してください.

Special:Interwiki も参照: (長大なテーブルが開きます. ) 例えばドイツ語版ウィキでは接頭子「en」と url http://en.yourwiki.org/index.php/$1 を追加、チェックボックス「Als lokales Wiki definiert」(訳注: ローカルWikiとして定義) をオンにします. 英語版ウィキではドイツ語版に対し、反対の設定をします. それから両方のウィキでは共有フォルダを2番目の接頭辞「pool」 http://pool.yourwiki.org/index.php/$1 として追加、チェックボックス「Forward」をオンにします.

アップロード
pool-wiki の「images」フォルダが書き込み可能であることを確認してください.

「Upload file-言語版ウィキ」リンクが poolwiki のアップロードサイトを指すよう、言語版ごとに設定を変更しておくと便利です. それぞれの言語版ウィキの LocalSettings.php を開き、以下のコードを追加.

1.17 の場合は $wgUploadMissingFileUrl を赤字リンクの時に pool-wiki にリダイレクトするように設定が必要.

共有ファイルを使用する
言語版ウィキで poolwiki のファイルを使用するには、それぞれの言語版ウィキの「LocalSettings.php」を開き、以下の行を追加します.

これで多言語ウィキにおいて pool ディレクトリから複数のファイルを呼び出そうとした時、例えば Image:MyLogo.png というメディアに統一できます.

画像の説明
それぞれの言語ウィキにおいて、(管理者として) MediaWiki:Sharedupload-desc-here メッセージを開きます.

次のようにテキストを変更します.

このファイルはここでのデータプールに保存されます. ファイルの詳細と解説は次のページに記載されています.

解説を表示.

(ここで英文の先頭の「 [[ 」に続く「:」に注目. これを書くとページ左側のウィキ間リンクの一覧で「pool」を読み込まなくなります. )

共有ディレクトリの poolwiki に保存したメディアの説明文を出力したい場合、それぞれの言語版ウィキの「LocalSettings.php」に次のコードを追加します.

共有設定
複数のウィキを作った場合、似た設定をどのウィキでも共有したらよい場合があります. それは次のようにします. 下記で説明するように、拡張機能の設定はその他の設定とは保存先のファイルを分けるよう推奨します. 大きなファイルに一括して書くことは可能ですが、使い方のニーズによっては必ずしも柔軟性がありません.

ディレクトリ構造に従うなら、下記がサンプルになります.

en/ es/ pl/ ja/ pool/ ExtensionSettings.php WikiFamilySettings.php SharedMediaSettings.php

拡張機能の設定

 * ステップ 1
 * 次の内容を持つ ExtensionSettings.php と命名したファイルを作成し上記の例と同じように設置.


 * ステップ 2
 * 共有設定を使用したいそれぞれのウィキの LocalSettings.php ファイルを編集し次の内容を追加.
 * ステップ 3
 * そしてすべての拡張機能への参照をもれなく追加.

Wikiファームの設定
ウィキファーム全体に適用したい設定があるとします. 例えば、すべてのwikiを同時にリードオンリーモードに設定できるようにしたいとします. またユーザ名/パスワードがデータベース (単体または複数) ですべて共通の場合なら、保存したいとします. さらにまた、このファイルひとつを使って、複数のウィキのユーザパーミッションを一括コントロールできます.

データベース テーブルの共有
共有データベースの設定の手順は Manual:Shared database を参照してください.

Symlink method
The symlinks method was formerly a method that eliminated the need to have redundant copies of MediaWiki on your filesystem while providing flexibility and customization for each wiki. WARNING: As of recent MediaWiki versions, this doesn't work anymore. If you try this, your MediaWiki will break. Instead, it's highly recommended to follow its spiritual successor, the method used by the Wikimedia Foundation (and the method that's used to power Wikipedia, this wiki, and many more!).

$ ls -og lrwxrwxrwx 1 16 2008-11-03 06:29 aaa.example.org -> mediawiki lrwxrwxrwx 1 16 2008-11-03 06:29 bbb.example.org -> mediawiki lrwxrwxrwx 1 16 2008-11-03 06:29 ccc.example.org -> mediawiki

の実例を見てみましょう. 実際の運営において、私たちが管理するサイトの名称とデータベースには多少の違いがあって、それに対処する必要があります.

それでも管理者はデータベースに個別の設定が必要です(例: どのウィキの設定を参照しているか検出するコードは . ) アップグレードはdownload from Git（Gitからダウンロード）すると簡単です. (ディスク上のウィキは1件だとご認識するcodeが残っていないとよいのですが.... )

画像
アップロードを許可していないか、または共用メディア用ウィキのみにアップロードを許可している場合、それぞれのウィキで画像ディレクトリを作成し、仮想ホスト設定でそのディレクトリを参照するようエイリアスの設定を行う必要があります. を実行し、aaa.example.org の仮想ホスト設定に を追記します. 同じ設定をbbbとcccについても行います.

ただし、上記の代替策としてを用いることもでき、その場合、*.example.org/images/ は単にディレクトリ1件しか対象にしません. あるいはまた、例えば *.example.org/$wgDBname/images/ を採用できます.

新たなウィキの追加
作成したにウィキを追加する方法.
 * 1) そのウィキの設定をユーザーのウェブサーバに追加.
 * 2) 一時的に config/index.phpのチェックをコメントアウトしておき、走らせる
 * 3) 生成したconfig/LocalSettings.phpをLocalSettings.phpに統合.
 * 4) 複数ページを追加

古いウィキの削除
ウィキを生成から削除する


 * 1) 設定を削除する場所
 * 2) ウェブ サーバー
 * 3) LocalSettings.php
 * 4) データベースを削除する

ウィキメディアが使っている方法
もう一つの方法はウィキメディア財団が使っている方法です. This uses only one single MediaWiki directory to provide the backbone for all sites, with the specific wiki being served dynamically determined at page load depending on the value of  being sent from the webserver (in WMF's case, Apache) to PHP. 方法の概略は以下の通りです. この方法は安定した方法ではありませんが、ウィキメディア財団が使って成功したことでも分かるようにかなりいい結果が得られます:-)   オンライン設定ウィザードを使ってMediaWikiテンプレートのコピーを設定します. ウィキファーム内のウィキごとに初期ページを設定したいなら、メインページを編集してください.  次に、mysqldump や phpMyAdmin を使ってウィキのデータベースをエクスポートします. データベースの書き出しの方法は構成のみ（例： ）でも実行でき、その場合はで第一の利用者を作成してください.  これを   のような名前でサーバの maintenance/ ディレクトリの下に保存します.  次に、新しいウィキ作成用に短いスクリプトを何件か書きます.  かいつまんで言うなら、ウィキの一覧を作るためにデータベースを複製します. （一覧の基準はフラットファイルでもMySQL/SQLiteでも有効. ）まず最初にテンプレートウィキを書き出し、次にテンプレートのデータベースのダンプを、それぞれのウィキの名前を付けたデータベースに読み込みます.  新しいデータベースの名称には標準の接尾辞（ウィキの名称がcat.example-farm.orgならデータベースはcatwikiと命名）.  設定ファイルにこれに似た処理を加え、必要に応じてデータベースの接尾辞とドメイン名を調整します.   DNS をワイルドカード A のデータで設定、apache にはサーバーの別名を設定 (例:  )、これで動くはずです.  

スクリプトのメンテナンスあるいはupdate.phpが取るパラメータ は書き出すと 定数になります. あなたのLocalSettings.phpファイルはそれを正しく$wgDBnameに設定する必要があります. （コマンドラインにHTTPリクエストはなく、「SERVER_NAME」もありません： For instance:

あなたの一意のLocalSettings.php（通常はサーバから直接アクセスできないCommonSettings.phpを含む数行）はウィキ固有の設定を初期化する$wgDBname変数です. 使用法は を参照してください.

合わせて、もしウィキごとに別ファイルにアップロードしたいなら、アップロードのディレクトリも調整が必要です. If you require the upload directories to be different, consider a more sophisticated setup by modifying $wgLocalFileRepo and/or $wgForeignFileRepos. You may also want to consider a remote server solution. Extensions exist to enable your wiki to use AWS S3 and Azure Storage for remote file storage as well. 上記のとおり、この方法は最も難しいかもしれませんし、技術的な経験値を求められますが、非常に見やすくクリーンなグラフを作ることができます. For more details on how the Wikimedia Foundation configures their wikis, visit the Wikitech wiki's explanation of the Wikimedia Foundation's MediaWiki architecture.

ウィキファームの拡張機能
MediaWiki の拡張機能には複数のウィキを単一のコードベースで簡便にホストするものがいくつかあります.


 * - beta

関連項目

 * システム構成データベース: コメント受付
 * MediaWiki Farmers user group ならびに Wikifarm (ウィキファミリー利用者グループとメーリングリスト)
 * Manual:中央管理 ID — ユーザーのアカウントに「中央管理」用の識別子を与えるメカニズム.
 * MediaWiki Farmers user group ならびに Wikifarm (ウィキファミリー利用者グループとメーリングリスト)
 * Manual:中央管理 ID — ユーザーのアカウントに「中央管理」用の識別子を与えるメカニズム.
 * Manual:中央管理 ID — ユーザーのアカウントに「中央管理」用の識別子を与えるメカニズム.
 * Manual:中央管理 ID — ユーザーのアカウントに「中央管理」用の識別子を与えるメカニズム.