Manual:$wgConf/ja

詳細
サイト設定のオブジェクトを作成します. 初期設定のままインストールする場合はほとんど使われません.

この設定はWikimediaの大規模インストールを行う際、数百のウィキに対する設定を集約するのに用いられるもので、サイトグループごとの初期値を設定し、ウィキごとに設定を上書きできるようにします.

しかし、少しややこしいかもしれません. :) Currently needed by Extension:CentralAuth to fetch per-site information, eg linking to the proper user pages on each wiki.

設定
Wikis are grouped by the suffix on their database names; on a large installation there may be e.g. 'enwiki' and 'enwiktionary' and 'enwikibooks', each in a different suffix group. Suffixes have to be declared in the  member variable of $wgConf if you want to use.

is the array of settings. Its format is. Settings may be assigned to (from the more specific to the less specific, this is the  part of   as mentioned above):
 * a specific DB name.
 * a wiki tag (since 1.12.0)
 * a suffix (eg 'wiki' or 'wiktionary') to affect all in that suffix group (can be determined with )
 * 'default' to affect all wikis

For string settings, you can define parameters that will be replaced when extracting the settings. It can be useful when the setting has the same format for all wikis. The format is. Be careful to use single quotes or to escape the    or it will be replaced with the PHP variable (that can be not defined at that time).

1.13以前
When extracting global settings, the object will search first the more specific level (the first one in the list above) and if it doesn't find the setting, it will search in less specific levels. When it finds one, if won't search for less specific ones. This means that you have to pay attention for some specific settings, such as, because it doesn't merge the setting with less specific levels, nor the default value (the one in DefaultSettings.php), you'll need to do it by yourself.

To extract the settings in global variables, you can use.

Parameters are:
 * : Wiki's database name (generally ). You have to define it yourself.
 * : Wiki's suffix, used to to get the suffix level.
 * : array of parameters mapping its name to its value.
 * : (since 1.12.0) array of wiki tags.

1.14以降
Some new features were added in 1.14.0. The 1.13 and earlier part can still be used though.

コールバック関数
Since 1.14, a callback has been introduced to be able to modify the parameters passed to  and related function. It might be used to change parameters when such functions are called after LocalSettings.php (this is the case with CentralAuth). You can define it in. The callback function will receive the SiteConfiguration object in the first argument and the wiki name in the second one. It has to return an array with the following keys (all optional): They'll be merged with the parameters passed to  and similar functions. If the  and   are filled, the they'll be used to override the default behaviour of.
 * : site's suffix (corresponding to $suffix paramater of  and similar)
 * : site's lang
 * : array of wiki tags (corresponding to $wikiTags parameter)
 * : array of parameters to be replaced (corresponding to $params parameter)

設定の統合
Arrays can now be merged. This might be useful for. To use it, you have to prefix the keys with a "+" for the settings you want to merge. The two possibilities can be used together.
 * To merge your customized version of the setting with the one in DefaultSettings.php, prefix the setting's name with "+" (such as )
 * To merge a more specific level with a less-specific one, prefix the level with a "+".

Merging happens in the following order:


 * 1) データベース名
 * 2) Tags (in the order provided to the extraction method, which might very well be randomized at this point)
 * 3) Wiki suffix
 * 4) Default

When a key is encountered that is not prefixed with "+", the merging will end.

Example with :

The basic syntax is thus:

例
This example uses 3 wikis:,   and. They are located at  (i.e. ,   and  ).

It assumes that  is already defined.

Wikimedia configuration
To see how Wikimedia uses  to configure its wikis see:
 * CommonSettings.php (Wikimedia's version of LocalSettings.php)
 * InitialiseSettings.php (for )
 * wgConf.php (used by CommonSettings.php to initialize $wgConf)

関連項目

 * The  file (or view it on GitHub), which gives a guide on how $wgConf works which might be easier to understand than this page.