Manual:LocalSettings.php/ja

  ファイルは ( ファイルに基づいて) MediaWiki インストレーションの基本的な構成設定を提供します. このファイルの設定を確認するためには時間が必要です. ファイルは通常、Web ベースの MediaWiki インストーラーによって生成されますが、Apache の設定と協調してパラメーターを変更できます. ウィキ ファームとして構成された MediaWiki インストレーションでは、 を使用できます.

サーバー内での場所
ファイルはウィキページではないため、ウェブブラウザーで開くことができません.

その代わり、サーバーのファイルシステム内のファイルです. その内容は ウィキの初期設定時に生成され、ファイルとしてサーバに手動で転写する必要があります. 当該のファイルの保存先は MediaWiki をインストールしたフォルダとし、他のフォルダ や 、またファイル と同じ階層に置きます. もし当該ファイルを指定された階層に「置かなかった」場合、ウィキは動作しません - ウィキが「動作する」なら、 ファイルは「正しく置かれた」状態です. 保存先がわからないときはコマンドラインからたとえば find / -iname LocalSettings.php -print と入力して探します.

（Vagrant を使用する場合は MediaWiki-Vagrant#MediaWiki_settings も参照）.

セキュリティ
通常 にはデータベースログインなどの機密情報が書かれています. このデータは「絶対に」後悔してはいけません！ サーバ上のどこかでセキュリティ違反が 発生した時に、このファイルの内容が他の利用者に暴露されかねないからです. データのセキュリティを向上するには、このファイルに対するUNIX 許可をきちんと設定します. Webサーバの利用者には、必ずこのファイルにアクセス権を設定します. ファイルの所有者アカウントと同じ場合は、許可を「600」に設定可能です. 当該ファイルのオーナーがウェブサーバー「ではない」けれども、オーナーの UNIX 利用者グループに入っている場合があります. そういう場合には許可は「640」で大丈夫です. 強化したセキュリティでは、可能な限り許可を狭めてください.

さらに、ウィキが使うデータベースだけに権限を制限したMySQLユーザをつくり、そのユーザの認証情報を に記しておくことができます. またデータベースサーバへはlocalhostからしかせつぞくできないよう設定することもできます. これにより認証情報が流出した場合も外部からのアクセスを防ぐことができます.

ファイルの内容
を編集するときは、適切なエンコーディングで上書き保存するようにしてください. エンコーディングは「ANSI as UTF-8」(バイト オーダー マーク (BOM) なしの UTF-8 エンコーディングを意味する) にしてください. (訳注: 「ANSI as UTF-8」は Notepad++ でしか使われない用語. )

にはPHPコードが含まれています. その内容は主に変数の定義とその定義値です. 通常、設定を変更することはPHP変数の値を変更することを意味します. 変更内容はファイルをサーバに保存するとすぐに反映されます. 手動で「再起動」する必要はありません. ただし、場合によっては変更内容が実際反映されたのを確認するのにブラウザキャッシュを消去する必要があるかもしれません.

より多くの設定に関する初期の値は  に設定されていますが、このファイルは編集すべきではありません. もし値を変更したい変数について  にまだ記されていないときは、  から該当する行をコピーし、希望する内容に修正して   に追記してください. '''新たな行は  の最後に追加するといいでしょう. '''

ファイルの中に extensions を指す ' ' のような行を記すこともできます. このような記述によってその拡張機能がウィキで使えるようになります. 拡張機能を利用するには  に追加の変数値を設定する必要があるかもしれません. 該当する拡張機能に関する詳細な指示が書かれた説明文書を確認してください.

MediaWikiにおけるほとんどのPHPファイルと同じく、  もPHPの終了タグ  では終わっていません. これは管理者が誤って新たな情報をこのタグの後に書き込んでしまうのを防ぐためです. PHPは終了タグがなくても正常に動作します.

MediaWiki ウィキファーム上でウィキを持つ場合、LocalSettings.php ファイルへの書き込み権限 (および読み込み権限でさえ) がないかもしれません (例えば次を参照: ). ウィキファーム企業はあなたの望みに合わせて変更してくれないことがあります. おそらくはウィキファームのすべてのウィキ群上でほとんど同じ設定をすることが望まれています.

利用できる設定の概要
設定項目一覧や設定ファイルのコメントをみると各変数の役割を知る上で助けになるでしょう. よく使われる機能と合わせ、最も重要な変数を挙げた短いリストを以下に示します.

インクルードパス
$IP (インクルードパス) 変数はウィキのベースインストールへのローカルファイルのパスを保持します. MediaWiki 1.17から$IPの設定は自動化され、 の手動の設定は不要になりました. 自動的に現在の作業ディレクトリがデフォルトになるため、手動で構成せずに済みます.

ファイルは IP 変数に指定されたディレクトリから読み込まれます.

サイト名
 はウィキのセットアップの名前を保持します. この名前は、MediaWiki:Pagetitle などシステム全体で多く含まれます. 例えばウィキペディアのタグラインの「From Wikipedia, the free encyclopedia」はこの設定を使用しています.

サイト名の語形変化
いくつかの表示言語はサイト名の語形変化に対応しています. ' の変数に適切な語形を設定できます (事例については ' 説明文書ページを参照してください).

サイトの言語
ウィキの表示言語は  の設定で制御します. ウィキ利用者はこの設定にかかわらず個人設定で表示言語を変更できます. この変数はすべての非ログイン利用者と大半の登録利用者に適用される初期設定言語を設定するものです.

スクリプトパス
 は MediaWiki の中心的なコードのアクティング ピースであるメインの MediaWiki スクリプトにアクセスするための URL パスの接頭辞です. この設定は、とりわけ Apache の rewrite ルールを利用している場合、必ず Apache 設定と一致しなければなりません.

サーバー名
 にはサーバのベースURL が保持され、プロトコルも伴いますが後置のスラッシュは無視され、もし存在してもサブディレクトリは無視されます. ウィキの動作しているローカルホストか、イントラネットまたはインターネットからか、メール通知と他の数種類のコンピューターメッセージは通常、アクセス元により異なる URL で配信されます.

MediaWiki 1.34 以降、 は LocalSettings.phpに設定の必要あり. それ以前のバージョンでは MediaWiki がサーバ名を自動検知し、 はオプションで自動検知の値を上書きしていました.

www.example.com がインターネットから見られるウィキのサーバーアドレスである場合、次のような行を追加する:

ウィキページでは  という The 特別な意味を持つ語の変数が使えます. これは  と同じ値になります. しかしウィキメディアファミリーでみられるようなあるウィキでは相対URLが用いられていて、完全には展開されません. 例えばこのサイトでは と表示されます. クリックすることも、それ自体をコピーしアドレスバーに貼り付けることもできません.

スクリプト名
 はメインの MediaWiki の PHP スクリプトの名前で、既定では  です. スクリプト名を変更するのはおそらく好ましくありません. しかし、変更したい場合は、変更する場所はこの変数です. やろうとしていることを理解してから変更してください.

記事へのパス
 は MediaWiki のページにアクセスする際に使用するパスです. パスはメインスクリプト (通常は  を使用) へのパスを含み、記事名部分に   プレースホルダーを使用します.

プリティURLまたはショートURLを作成するためにApacheのリライトルールを使用する場合、おそらく正しいパスを指し示す を調整する必要がある. wgArticlePathはMediaWikiの範囲内からURLを構築ために使用されることに注意. 間違いがあった場合、正しいURLを手作業で指定することでメインページにアクセスできるかもしれない一方で内部リンクは不正に表示される. 詳細は Manual:Short URL を参照してください.

典型的な値は以下の通り:

スタイルシートの位置
設置されている MediaWiki インストールのために CSS がある場所への URL を設定するには  変数を使用します.  変数は同じ場所を指定しますが、ファイル システムにアクセスする内部スクリプトで使用されるため、ローカル ファイル システムであることにご注意ください.

アップロードの位置
アップロードディレクトリは利用者によってアップロードされたファイルが保存される場所です. ' 変数には URL パスを、' にはローカルファイルシステムパスを指定します.

ロゴ
 は、すべての MediaWiki のページに既定で左上隅に表示されるグラフィカルなロゴを指定します. 初期設定で指定されたロゴのディレクトリ /wiki/skins/common/images/ の /wiki を、MediaWiki ソフトウェアをインストールしたディレクトリのパスに置き換えます.

まず何か使いたいロゴのファイルを /wiki/skins/common/images/ にコピーします（/wiki は MediaWiki をインストールしたディレクトリのパスに置き換えてください）.

次に、以下のような行を  の中から見つけてください.

もしそのような行が見つからなければ、上記の行をコピーしファイルの最後に追記してください.

そしてロゴファイルを指すようにその行を編集してください. ロゴはウェブ上でアクセスできるようになっていなくてはいけません. この変数の値はウェブブラウザに渡され、ユーザはその値を使ってロゴを取得します. もし設定値がよく分からないとき、ここに設定する値を決めるよい方法は、ウェブブラウザでそのロゴのアドレスにアクセスしてみることです（例えばこのウィキの場合、ロゴのURLは http://upload.wikimedia.org/wikipedia/mediawiki/b/bc/Wiki.png です）. そして完全なURLをこの変数の値に設定してください.

skins/common/images/wiki.png ファイルを自身で用意したロゴに置き換えるだけにしようとする人がいますが、これは推奨しません. なぜならアップグレードする際、このカスタマイズしたロゴは上書きされてしまうからです.

コンタクト情報
 変数は何か問題が発生した際に連絡するための利用者のメールアドレスです. メールアドレスは内部バグ報告を送るために使用されます. 管理者として、あなたのメールアドレスをここに掲載しておきます.

 変数は、パスワードを忘れた利用者にパスワードが送信される際に使用されるメールアドレスです. トラブルや混乱の際に、利用者がメールを送信できるメールアドレスを指定します.

データベースの設定
ページ、利用者情報や多くのものを保存するために MediaWiki はデータベース (現在は MySQL、PostgreSQL のいずれか) にアクセスする必要があります.

 はデータベースのホスト名を含みます. 多くの場合、同じシステム上で動作しているデータベースとしては「localhost」が当てはまりますが、さまざまなインストールのために、データベースが動作しているコンピューターの十分に確認されたドメイン名を入力する必要があります.

 は MediaWiki によって使用される データベース名 です. 単独の MySQL または PostgreSQL では一つ以上のデータベースを保存することができ、一つのサーバーで多くの MediaWiki を動作させることができます. 正しいデータベース名を記載して同じデータベースサーバー上の異なるウィキインストールのために異なるデータベース名を使用することを確認します.

' 変数と ' 変数はデータベースにアクセスするために MediaWiki によって使用されるログイン名とパスワードを含みます. データベースサーバー上でウィキのテーブルを操作できる適切なアクセス権を指定された利用者が所有することで確認できます.

利用者の権限
 は連想配列で、異なる利用者グループのためにページを作成と編集する権限を制限します. この配列において、カスタムパーミッションレベルが作成され、異なる利用者グループのためにパーミッションレベルが設定されます. 異なるパーミッションと利用可能な利用者グループについては でより詳細な情報を見ることができます.

大文字リンクの強制
既定では、小文字 (ラテン文字) でページ名は始まらず、最初の文字を大文字に変換されます. リンクターゲット、含まれるページ、画像またはカテゴリは小文字で始まる名前で指定され、実際のターゲットなどは大文字で始まるページに対応します.

代替的にはページ名は大文字、数字に加えて、小文字で始めることができます. そのためには  変数を調整しなければなりません. false に設定することで小文字を許可し、true は既定の振る舞いをします.

下位ページの有効化
において、 変数を使用することで名前空間ごとに下位ページを有効にします. 例えばメインの名前空間で下位ページを有効にする場合:

画像のアップロード
MediaWiki システムにファイルをアップロードすることを利用者に許可する前に、この機能を有効にしなければなりません. アップロードディレクトリが適切に設定され、Apache ウェブサーバープロセスによって書き込み可能でなければなりません.  変数を true に設定することでウェブユーザーインターフェイスでアップロードすることが可能になります.

次のコードは LocalSettings.php の設定例で includes/DefaultSettings.php から由来しています:

動作中に素早く画像をリサイズできるようにしてサムネイルをサポートしたい場合、MediaWiki には有効なImageMagickが必要です. ImageMagick をシステムにインストールしてテストが済んだら  に true を設定します. ' が  コマンドのインストールの適切な位置を指定し、コマンドがウェブ サーバーのプロセスによって実行可能であること、' が十分に大きいことを確認します. 詳細な情報と障害探索の方法は を参照してください.

また、利用可能な拡張子の修正を行いたい場合、次のように  内に設定します:

ImageMagick で次のようなエラーメッセージが表示された場合.
 * Fatal error: mime_magic could not be initialized, magic file is not available in includes/MimeMagic.php on line 506

さらに以下の行を LocalSettings.php に追加してみてください:

= "file -bi";

インターウィキのサポート
インターウィキ サポートは MediaWiki に組み込まれていますが、内部リンクのために使用される接頭辞を設定する必要があります. この接頭辞は通常 と同じですが、変更する場合、 変数をご希望の名前に設定します.

ユーザーインターフェイスの言語
MediaWikiは様々なローカライズされたユーザーインターフェイスの言語を利用できます. 英語ではない言語でウィキを運営する場合、 を適切な言語コードに設定します (例えば、ドイツ語なら「de」、スペイン語なら「es」、など)

ディレクトリ内にファイルがあれば、あらゆる言語を使用できます. 例えば  がある場合は、スペイン語に「   」を使用できます. 先頭が大文字の「 」を使用しないでください. 動作するかもしれませんが、すべてのテキストが翻訳されていないこともあります.

すべての言語に対応している訳ではありません. の多言語化対応状況の一覧をみるにはこちらを参照してください. 各公開版の状況についてはtranslatewiki.netをご覧ください.

サイトのための著作権の設定

 *  はウィキ上のページで該当する著作権を表示します. 通常は Project:Copyrights です.
 *  はライセンスの全内容を記述したページです. (例えば GNU FDL の場合は、 になります)
 *  は "Content is available under" に続くフッターに含まれるテキストです.  に指定されたページにリンクします.
 *  はフッターの左に設置される画像の URL です.

サイトの著作権宣言を修正するために次の行を に追加します:

後で適切なメッセージを表示するためにMediaWiki:Copyrightを編集します. を使用して著作権ページへのリンクの位置を示します.

例: クリエイティブ・コモンズライセンスを設定します

クリエイティブコモンズライセンスを設定するために以下のように行います:


 * ライセンスを選択する: http://creativecommons.org/choose/
 * 返されたHTMLコードを検査する. 例:


 * のために、最初のアンカーからhref情報を入力します:
 * のために2番目のアンカーからテキストを入力する(文法的に正しいバージョンであるために"a"をウィキ変数に追加します)
 * のために最初のアンカーのimgリンクからソースの情報を入力します. Crative Commonsサイトからあなたのサイトにバッジをコピーしたい場合は以下のコードを追加します.
 * 著作権についての RDF メタデータを使用するには、 に以下の行を追加します:

カスタムの名前空間
$ExtraNamespaces 配列を宣言して ' と ' 配列を修正すると、MediaWiki インストレーションに名前空間を追加できます. また  配列を宣言すると名前空間の別名を追加できます. 同じ名前空間で既に命名したページ、例えば「Technical:Support」というページがあるのに「Technical:」という名前空間を作成すると、そのページは消え、そればかりか Special:Allpages から除去できなくなることに留意が必要です. これを修正するにはまず名前空間を削除、「Technical:Support」をメインの名前空間の「Support」に移動させてリダイレクトを削除します. 次に名前空間を再び作成して「Technical:Support」に戻します. 詳細な情報はをご覧ください.

外装
サイトの既定の外装 (スキン) は  変数で修正できます.

関連項目

 * インストール中に の初期のコンテンツを作成するソースコード.
 * ウィキファミリーで同じ を共有することができます.
 * Manual:データベースパスワードを安全に保管するには - データベースパスワードと  ファイルを安全に保管する方法について.