Manual:LocalSettings.php/ja

The   file provides basic configuration settings (based on the  file) of a MediaWiki installation. You should take your time to review the settings in this file. The file is usually generated by the web-based MediaWiki installer but you can tweak the parameters, possibly in concert with Apache settings. For MediaWiki installations configured as a wiki farm, a file named  may be used.

サーバー内での場所
The LocalSettings.php file is not a wiki page and you cannot access it with your web browser. Instead, it is a file in the file system of the server. Its contents are generated during the initial setup of the wiki and the resulting file must be copied on the server manually. The file must be located in the folder you installed MediaWiki into, on the same level with folders like "includes/" or "skins/" and files like "api.php". If this file is not there, the wiki will not work at all - if the wiki does work, the file is there. If you do not know where it is, you can run this command  on the UNIX shell to make your server show you where the file actually is.

セキュリティ
LocalSettings.php usually contains sensitive data such as database logins. This data should never be revealed to the public! Due to a security breach somewhere on the server, it might happen that other users are able to view the contents of files. In order to improve security of your data, you should set UNIX permissions for this file accordingly: The webserver user must have access to this file. If this is the same account, who is the owner of the file, then you can set permissions to 600. Sometimes, the webserver user is not the file owner, but he is in the owner's UNIX user group. In this case, permissions of 640 should be fine. For improved security you should narrow permissions down as far as possible.

Additionally, you can create a MySQL user, who is restricted to only the database used by the wiki and provide this user's credentials in LocalSettings.php. Also can you configure your database server to only accept connections from localhost - this should prevent access from outside in case of leaked credentials.

ファイルの内容
When you edit LocalSettings.php, make sure to save it in the right encoding again. You should use "ANSI as UTF-8" encoding - that is UTF-8 encoding without byte order mark (BOM).

LocalSettings.php contains PHP code; mainly the definition of variables and their values. Changing a setting usually means changing the value of a PHP variable. Your changes will take effect immediately after saving the file again on the server: There is no need to manually "restart" anything. Anyway, in some cases you may need to clear your browser's cache to actually see the changes you made.

The default values of many more settings are set in, which should not be edited; if the variable you want to change is not already mentioned in your  , copy the appropriate line from   and modify it appropriately in LocalSettings.php. Within  you can add new lines at the end.

Within the file, there can also be several lines such as ' ', which point to extensions. These lines enable the according extension in the wiki. Those extensions may require setting the values of more variables in ; check the documentation of the according extension for further instructions.

Your version of  may not end with a closing PHP tag of  . This is done on purpose, as it prevents people from accidentally adding new information after this tag. PHP will function just fine without a closing tag.

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

利用できる設定の概要
See the configuration settings index and the comments included in the settings files for help on what all the variables do. A short listing of the most important variables, as well as the most requested features, is listed below.

インクルードパス
The $IP (include path) variable holds the local file path to the base installation of your wiki. Make sure you refer to the fully qualified file path. Do not include a slash at the end of the path. Since MediaWiki 1.17, setting $IP in LocalSettings.php is no longer needed. It will default to the current working directory automatically.

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

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

Declensions of site name
Some translations of interface are ready for inflection of site name. You can set proper forms of word in variables $wgGrammarForms.

サイトの言語
The $wgLanguageCode variable controls the language of your wiki's interface. While users can switch the language they see in their preferences, this variable sets the default language that all anonymous users and most registered users see.

スクリプトパス
$wgScriptPath is the URL path prefix to access the main MediaWiki script that is the central acting piece of code of MediaWiki. This setting should correspond to the Apache settings, especially if you are using Apache's rewrite rules.

サーバー名
$wgServer can be used optionally to overwrite the automatic detection. When the wiki is accessed from either the localhost where it runs, from an intranet or from the internet, e-mail notifications and a few other computed messages would be usually delivered with the different URLs. Using  overwrites the detection and the server name will be constant.

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

The magic word variable  can be used on wiki pages; it equals the value of  ; however, on a wiki, such as those in the WikiMedia family, where relative urls are used, it will not fully expand, for example here it displays, which can neither be clicked nor copy-pasted into the address bar as it is.

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

リダイレクトスクリプト名
$wgRedirectScript 変数は、MediaWiki でリダイレクトを取り扱う リダイレクト　スクリプト への URL パスを指定します. この設定は正確なスクリプト名を設定できる wgScript と似ています. 上記で説明したように、本当に何をしようとしているのか理解していない場合、変更するのは好ましくありません.

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

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

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

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

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

ロゴ
The $wgLogo variable specifies which graphical logo is displayed in the top left corner of all mediawiki pages. These steps replace the default logo in the /wiki/skins/common/images/ directory, replacing /wiki with the path to the directory where you installed the MediaWiki software.

First, copy whatever logo you want into the /wiki/skins/common/images/ directory (replacing /wiki with the path to the directory where you installed the MediaWiki software).

Next, try to find the line that looks like this in :

If there's no such line, you can copy and paste the line above at the end of the file.

Then, modify that line to point to your logo. The logo must be web accessible. The value of this variable is passed to the web browser, which uses it to fetch the logo. If in doubt, a good way to pick what to put here is navigate to the logo in your web browser (for example, this wiki the url of the logo is http://upload.wikimedia.org/wikipedia/mediawiki/b/bc/Wiki.png ), and put the full url as the value of this variable.

Some people just replace the skins/common/images/wiki.png file with their logo. This is not recommended, as the customized logo would be overwritten on upgrade.

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

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

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

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

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

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

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

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

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

下位ページの有効化
$wgNamespacesWithSubpages 変数を使用することで名前空間ごとのベースで下位ページを有効にします. 例えばメインの名前空間で下位ページを有効にします:

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

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

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

ImageMagickでトラブルに遭遇した場合、次のエラーメッセージが表示されます:

その場合、次の行を追加して見てください; $wgMimeDetectorCommand = "file -bi";

LaTeXインラインの方程式
LaTeX で数式を描画するために、LaTeX インストールをシステム上で動作させる必要があります. この機能を有効にするために $wgUseTeX 変数を true に設定します. $wgMathPath、$wgMathDirectory、$wgTmpDirectory が適切に設定されていることを確認します. 変更するためによい理由がない限り、既定の値を使う方がよいでしょう.

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

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

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

Note: After changing the language code, you will need to run a php script to make it work. With your command line tool, go to your wiki directory, open the "maintenance" folder, and type " ". Please note that on Windows, the PHP folder might not be included in the PATH environment variable.

Not all languages are supported. See here for a list of the localisation statistics of. See translatewiki.net for the statistics per released version.

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

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

サイトの著作権宣言を修正するために次の行をLocalSettings.phpに追加します: 後で適切なメッセージを表示するためにMediaWiki:Copyrightを編集します. を使用して著作権ページへのリンクの位置を示します.

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

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


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


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


 * 著作権についてのRDFメタデータを使用するためには、LocalSettings.phpに次の行を追加します.

カスタムの名前空間
By declaring the $wgExtraNamespaces array, and modifying the $wgNamespacesWithSubpages, and $wgNamespacesToBeSearchedDefault arrays, extra namespaces can be added to a MediaWiki installation; and by declaring the $wgNamespaceAliases array namespace aliases can be added. Take heed not to have any pages already titled in that namespace, for instance in you had a page called "Technical:Support" and you created the Technical: namespace, then that page would not only be lost, but you cannot remove it from Special:Allpages. To fix this delete the namespace, move "Technical:Support" to "Support" in mainspace, delete the redirect, reinsert the namespace, and move it back to "Technical:Support". See Custom namespaces for more information as to how to do so.

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

関連項目

 * LocalSettings.php ファイルを作成するソースコード. このコードによりインストール中に LocalSettings.php の既定コンテンツを作成します.
 * Wiki families can share the same.
 * Extension:Configure provides a way to set configuration settings from a special page.
 * Manual:Securing database passwords - a guide to securing your database passwords and LocalSettings.php file.