View source for Manual:$wgConf/nl

<languages />
{{SettingSummary
|name=Conf
|version_min=1.5.0
|rev_introduced=9670
|section=Global Objects
|range=
|default=nieuw {{Class doclink|SiteConfiguration}} object.
|summary=Maak een site-configuratieobject. Wordt niet veel gebruikt in een standaardinstallatie.
}}
== Details ==

Maak een site-configuratieobject. Wordt niet veel gebruikt in een standaardinstallatie.

Dit wordt gebruikt op [[#Wikimedia configuration|Wikimedia's massa-installatie]] om een gecentraliseerd configuratiebestand te leveren voor een paar honderd wiki's, met standaardinstellingen per sitegroep en per-wiki overrides.

Het kan echter een beetje verwarrend zijn. :)
Op dit moment nodig door {{ll|Extension:CentralAuth}} om informatie per-site op te halen, bijvoorbeeld door te linken naar de juiste gebruikerspagina's op elke wiki.

<span id="Configuration"></span>
== Configuratie ==

Wiki's zijn gegroepeerd door het achtervoegsel op hun databasenaam; op een grote installatie kunnen er bijvoorbeeld 'enwiki' en 'enwikibooks' zijn, elk in een andere achtervoegselgroep. Achtervoegsels moeten worden gedeclareerd in de <code>suffixen</code> lidvariabele van $wgConf als u {{phpi|$wgConf->siteFromDB()}} wilt gebruiken.

{{phpi|$wgConf->settings}} is de reeks instellingen. Het formaat is {{phpi|$wgConf->settings['wgSettingName']['wiki']}}.

Instellingen kunnen worden toegewezen aan (van de meer specifieke naar de minder specifieke, dit is het <code>'wiki'</code> deel van {{phpi|$wgConf->settings}} zoals hierboven vermeld):

* een specifieke DB-naam.
* een wiki-tag (sinds 1.12.0)
* een achtervoegsel (bijvoorbeeld 'wiki' of 'wiktionary') om alles in die achtervoegselgroep te beïnvloeden (kan worden bepaald met {{phpi|$wgConf->siteFromDB()}})
* 'default' om alle wiki's te beïnvloeden

Voor de stringinstellingen kunt u parameters definiëren die bij het uitpakken van de instellingen worden vervangen.
Het kan nuttig zijn wanneer de instelling hetzelfde formaat heeft voor alle wiki's.
Het formaat is {{tmpl|0=<code>$$1</code>|''naam''}}.
Wees voorzichtig met het gebruik van enkele aanhalingstekens (<code>'</code>) of om e <code>$</code> (<code>\$</code>) te escapen of het zal worden vervangen door de PHP-variabele (die op dat moment niet kan worden gedefinieerd).

<span id="1.13_and_earlier"></span>
=== 1.13 en eerder ===
{{MW 1.13|and earlier}}
Bij het uitpakken van globale instellingen zal het object eerst het meer specifieke niveau zoeken (het eerste niveau in de lijst hierboven) en als het de instelling niet vindt, zal het zoeken in minder specifieke niveaus.
Als het er een vindt, zal het zoeken naar minder specifieke niveaus.
Dit betekent dat u moet letten op enkele specifieke instellingen, zoals <code>{{ll|Manual:$wgGroupPermissions|$wgGroupPermissions}}</code>, omdat het de instelling niet samenvoegt met minder specifieke niveaus, noch de standaardwaarde (die in DefaultSettings.php), u zult het zelf moeten doen.

Om de instellingen in globale variabelen uit te pakken, kunt u {{phpi|$wgConf->extractAllGlobals( $wiki, $suffix, $params, $wikiTags );}} gebruiken.

Parameters zijn:
*<code>$wiki</code> - Wiki's database naam (over het algemeen <code>{{ll|Manual:$wgDBname|$wgDBname}}</code>). Je moet het zelf definiëren.
*<code>$suffix</code> - Wiki's achtervoegsel, gebruikt om het achtervoegselniveau te krijgen.
*<code>$params</code> - een reeks parameters die de naam van de Wiki aan zijn waarde koppelen.
*<code>$wikiTags</code> - {{introduced-inline|1.12.0}} array van wiki-tags.

<span id="1.14_and_newer"></span>
=== 1.14 en nieuwer ===
{{MW 1.14|and after}}
In 1.14.0 zijn enkele nieuwe functies toegevoegd. Het [[#1.13 and earlier|1.13 en eerder]] deel kan echter nog steeds gebruikt worden.

==== Callback function ====
Sinds 1.14 is er een [https://php.net/language.pseudo-types#language.types.callback callback] ingevoerd om de parameters die worden doorgegeven aan {{phpi|SiteConfiguration::get()}} en de bijbehorende functie te kunnen wijzigen.
Het kan worden gebruikt om parameters te wijzigen wanneer dergelijke functies worden aangeroepen na LocalSettings.php (dit is het geval met CentralAuth).
U kunt het definiëren in {{phpi|$wgConf->siteParamsCallback}}.
De callback functie zal het SiteConfiguration object in het eerste argument ontvangen en de wiki naam in het tweede argument.
Het moet een array teruggeven met de volgende key's (allemaal optioneel):

* <code>suffix</code>: site's suffix (komt overeen met $suffix paramater van {{phpi|SiteConfiguration::get()}} en dergelijke)
* <code>lang</code>: site's lang
* <code>tags</code>: reeks wiki-tags (overeenkomend met de parameter $wikiTags)
* <code>params</code>: array van te vervangen parameters (overeenkomend met $params parameter)

Ze worden samengevoegd met de parameters die worden doorgegeven aan {{phpi|SiteConfiguration::get()}} en soortgelijke functies. Als de <code>suffix</code> en <code>lang</code> worden ingevuld, worden ze gebruikt om het standaardgedrag van {{phpi|$wgConf->siteFromDB()}} te overschrijven.

<span id="Settings_merging"></span>
==== Samenvoegen van instellingen ====

Arrays kunnen nu worden samengevoegd. Dit kan nuttig zijn voor <code>{{ll|Manual:$wgGroupPermissions|$wgGroupPermissions}}</code>. Om ze te gebruiken, moet je bij de key's  een "+" voor de instellingen plaatsen die je wilt samenvoegen.

* Om uw aangepaste versie van de instelling samen te voegen met die in DefaultSettings.php, moet u de naam van de instelling voorvoegen met een "+" (zoals <code>'+wgGroupPermissions'</code>)
* Om een meer specifiek niveau samen te voegen met een minder specifiek niveau, moet het niveau worden voorafgegaan door een "+".

De twee mogelijkheden kunnen samen worden gebruikt.

Het samenvoegen gebeurt in de volgende volgorde:

# Databasenaam
# Tags (in de volgorde van de extractiemethode, die op dit punt heel goed willekeurig zou kunnen worden)
# Wiki achtervoegsel
# Standaard

Wanneer een toets wordt aangetroffen die niet voorafgegaan is door een "+", zal de samenvoeging eindigen.

Voorbeeld met {{ll|Manual:$wgGroupPermissions|$wgGroupPermissions}}:

<syntaxhighlight lang="php" style="overflow: auto;">
$wgConf->settings = [

# ...

# '+' triggers a merge with this and the value of $wgGroupPermissions defined
#  in DefaultSettings.php
'+wgGroupPermissions' => [

    # Allow bureaucrats to change status on remote wikis
    #  and allow anonymous users to create page (this part
    #  will not be merged with 'default' since there's no
    #  "+" in front of 'centralwiki')
    'centralwiki' => [
        'bureaucrat' => [
            'userrights-interwiki' => true,
        ],
    ],

    # A wiki with rollback right given to logged-in users
    #  the 'default' part will be merged with this value
    #  (i.e. anonymous users won't be able to create pages)
    '+somewiki' => [
        'user' => [
            'rollback' => true,
        ],
    ],

    # Disallow anonymous users to create pages.
    # Note: the 'default' key should never have a "+" in front of it
    'default' => [
        '*' => [
            'createpage' => false,
            'createtalk' => false,
        ],
    ],
],

# ...

];
</syntaxhighlight>

De basissyntaxis is dus:

<syntaxhighlight lang="php" style="overflow: auto;">
$wgConf->settings = [
'wgConfigurationSetting' => [
    'default' => 'defaultvalue',
    'wikidatabasename1' => 'value that overrides default for this wiki',
],
# To merge the settings you set here with those in DefaultSettings.php:
'+wgConfigurationSetting' => [
# Note: This and DefaultSettings.php are NOT the same! The default specified here
#        overrides that in DefaultSettings.php, and becomes the new default for all
#        your wikis unless you choose to override it for a particular wiki,
#        like for wikidatabasename1 here.
    'default' => 'defaultvalue',
    'wikidatabasename1' => 'value that overrides default for this wiki',
],
];
</syntaxhighlight>

<span id="Example"></span>
== Voorbeeld ==

In dit voorbeeld worden 3 wiki's gebruikt: <code>dewiki</code>, <code>enwiki</code> en <code>frwiki</code>. Ze staan op <code><nowiki>http://</nowiki>localhost/''$wgDBname''/</code> (d.w.z. <code><nowiki>http://</nowiki>localhost/dewiki/</code>, <code><nowiki>http://</nowiki>localhost/enwiki/</code> en <code><nowiki>http://</nowiki>localhost/frwiki/</code>).

Het gaat ervan uit dat de <code>{{ll|Manual:$wgDBname|$wgDBname}}</code> al gedefinieerd is.

{{Note|1=In dit voorbeeld wordt {{phpi|$wgConf->settings}} gedeclareerd in {{ll|Manual:InitialiseSettings.php|InitialiseSettings.php}}, dit is niet vereist en kan worden gedaan in LocalSettings.php.}}

=== InitialiseSettings.php ===

<syntaxhighlight lang="php" style="overflow: auto;">
<?php

$wgConf->settings = [

'wgServer' => [
    # If you want to allow also usage of https, just use '//localhost'
    #  and set 'http://localhost' at 'wgCanonicalServer'
    'default' => 'http://localhost',
],

'wgCanonicalServer' => [
    'default' => 'http://localhost',
],

'wgScriptPath' => [
    'default' => '/$wiki',
],

'wgArticlePath' => [
    'default' => '/$wiki/index.php/$1',
],

'wgSitename' => [
    'default' => 'Wikipedia',
    'frwiki' => 'Wikipédia', # accent in French
],

'wgLanguageCode' => [
    'default' => '$lang',
],

'wgLocalInterwiki' => [
    'default' => '$lang',
],

];
</syntaxhighlight>

=== LocalSettings.php ===

<span id="for_1.13_and_earlier"></span>
==== 1.13 en eerder ====
{{MW 1.13|and earlier}}{{-}}
<syntaxhighlight lang="php" style="overflow: auto;">
$wgLocalDatabases = [
    'dewiki',
    'enwiki',
    'frwiki',
];

$wgConf->wikis = $wgLocalDatabases;
$wgConf->suffixes = [ 'wiki' ];
$wgConf->localVHosts = [ 'localhost' ];

require_once "$IP/InitialiseSettings.php";

list( $site, $lang ) = $wgConf->siteFromDB( $wgDBname );
$params = [
    'site' => $site,
    'lang' => $lang,
    'wiki' => $wgDBname,
];
$wgConf->extractAllGlobals( $wgDBname, $site, $params, [] );
</syntaxhighlight>

<span id="for_1.14_and_newer"></span>
==== 1.14 en nieuwer ====
{{MW 1.14|and after}}{{-}}
<syntaxhighlight lang="php" style="overflow: auto;">
$wgLocalDatabases = [
    'dewiki',
    'enwiki',
    'frwiki',
];

$wgConf->wikis = $wgLocalDatabases;
$wgConf->suffixes = [ 'wiki' ];
$wgConf->localVHosts = [ 'localhost' ];

require_once "$IP/InitialiseSettings.php";

function efGetSiteParams( $conf, $wiki ) {
    $site = null;
    $lang = null;
    foreach( $conf->suffixes as $suffix ) {
        if ( substr( $wiki, -strlen( $suffix ) ) === $suffix ) {
            $site = $suffix;
            $lang = substr( $wiki, 0, -strlen( $suffix ) );
            break;
        }
    }
    return [
        'suffix' => $site,
        'lang' => $lang,
        'params' => [
            'lang' => $lang,
            'site' => $site,
            'wiki' => $wiki,
        ],
        'tags' => [],
    ];
}

$wgConf->suffixes = $wgLocalDatabases;
$wgConf->siteParamsCallback = 'efGetSiteParams';
$wgConf->extractAllGlobals( $wgDBname );
</syntaxhighlight>

<span id="Wikimedia_configuration"></span>
== Wikimedia-configuratie ==

Om te zien hoe Wikimedia <code>$wgConf</code> gebruikt om zijn wiki's te configureren zie:

* [http://noc.wikimedia.org/conf/highlight.php?file=CommonSettings.php CommonSettings.php] (Wikimedia's versie van LocalSettings.php)
* [http://noc.wikimedia.org/conf/highlight.php?file=InitialiseSettings.php InitialiseSettings.php] (voor {{phpi|$wgConf->settings}})

<span id="See_also"></span>
== Zie ook ==

* Het <code>includes/SiteConfiguration.php</code> bestand ([https://github.com/wikimedia/mediawiki/blob/master/includes/SiteConfiguration.php#L23-L109 of bekijk het op GitHub]), heeft een gids over hoe $wgConf werkt die misschien makkelijker te begrijpen is dan deze pagina.