Manual:LocalSettings.php/de

Die Datei   stellt grundlegende Konfigurationseigenschaften (basierend auf der Datei ) einer MediaWiki-Installation zur Verfügung. Du solltest dir Zeit für diese Konfigurationsdatei nehmen. Diese Datei wird standardmäßig vom MediaWiki-Webinstaller erstellt, aber du kannst ihre Parameter optimieren, u. U. in Abhängigkeit von Apache-Einstellungen. Für MediaWiki-Installationen, die als wiki farm konfiguriert sind, steht die Datei  zur Verfügung.

Standort auf dem Server
Die -Datei ist keine Wiki-Seite und kann nicht über den Webbrowser aufgerufen werden. Stattdessen ist es eine Datei im Dateisystem auf dem Server. Ihre Inhalte werden während des ersten Setups des Wikis generiert und müssen manuell auf den Server kopiert werden. Die Datei muss in dem Ordner enthalten sein, in dem du MediaWiki installiert hast, in der Ebene, in der sich auch Ordner wie  und   und Dateien wie   befinden. Wenn diese Datei nicht existiert, wird das Wiki unter keinen Umständen funktionieren – wenn das Wiki läuft, ist die Datei da. Wenn du nicht weißt, wo sie sich befindet, kannst du einen Befehl wie find / -iname LocalSettings.php -print in ein Terminal-Fenster eingeben, um sie zu finden.

(Wenn du Vagrant benutzt, siehe auch MediaWiki-Vagrant#MediaWiki_settings.)

Sicherheit
enthält üblicherweise sensible Daten wie z. B. die Zugangsdaten für Datenbank-Logins. Diese Daten sollten nie der Öffentlichkeit zugänglich gemacht werden! Aufgrund einer Sicherheitslücke irgendwo auf dem Server könnte es passieren, dass andere Benutzer die Fähigkeit erhalten, die Inhalte von dort abgelegten Dateien zu sehen. Um die Sicherheit deiner Daten zu erhöhen, solltest du UNIX-Berechtigungen für diese Datei wie folgt setzen: Der Webserver muss Zugang zu dieser Datei haben. Wenn das der gleiche Account ist, der die Datei besitzt, kannst du die Berechtigungen auf 600 stellen. Manchmal ist der Webserver-Benutzer nicht der Besitzer der Datei, aber er ist in der UNIX-Benutzergruppe des Besitzers. In diesem Fall sollte die Berechtigung von 640 in Ordnung sein. Für verbesserte Sicherheit solltest du Berechtigungen so sehr wie möglich einschränken.

Zusätzlich kannst du ein MySQL-Benutzerkonto anlegen, welches nur Zugriff auf die vom Wiki verwendete Datenbank hat, und dessen Zugangsdaten in  zur Verfügung stellen. Du kansst deinen Datenbankserver auch so konfigurieren, dass er nur Verbindungen von localhost akzeptiert – dies sollte Zugriff von außen im Falle vom Öffentlichwerden von Zugangsdaten verhindern.

Dateiinhalte
Wenn du  bearbeitest, gehe sicher, dass du die Datei wieder in der richtigen Codierung speicherst. Du solltest die Codierung „ANSI as UTF-8“ benutzen – das ist die UTF-8-Codierung ohne die Byte-Reihenfolge-Markierung (BOM).

beinhaltet PHP-Code; hauptsächlich die Definition von Variablen und deren Werten. Eine Einstellung zu verändern bedeutet normalerweise, den Wert einer PHP-Variablen umzuändern. Deine Änderungen werden sofort wirken, nachdem die Datei wieder auf dem Server gespeichert wird. Es ist nicht erforderlich, manuell irgendetwas neu zu starten. Jedoch könnte es sein, dass du in einigen Fällen deinen Browser-Cache leeren musst, um tatsächlich die Änderungen zu sehen, die du gemacht hast.

Die Standardwerte von vielen weiteren Einstellungen sind in  gesetzt, welche nicht bearbeitet werden sollten. Wenn die Variable, die du verändern möchtest, nicht schon in deiner -Datei vorhanden ist, kopiere die betroffene Zeile von   und modifiziere sie entsprechend in. Am Ende von  kannst du neue Zeilen hinzufügen.

In der Datei können auch mehrere Zeilen wie etwa ' ' enthalten sein, welche Erweiterungen einbinden. Diese Zeilen aktivieren die jeweilig zugehörige Erweiterung in dem Wiki. Diese Erweiterungen benötigen eventuell das Einstellen von weiteren Variablen in ; überprüfe die Dokumentation der entsprechenden Erweiterung für weitere Anweisungen.

Wie die meisten PHP-Dateien in MediaWiki endet  nicht mit dem schließenden PHP-Tag. Dies hindert Administratoren daran, versehentlich neue Informationen hinter diesem Tag hinzuzufügen. PHP funktioniert auch ohne einen schließenden Tag korrekt.

Wenn du ein Wiki in einer MediaWiki-Wikifarm betreibst, besitzt du eventuell keinen Schreibzugriff (oder sogar keinen Lesezugriff) auf die Datei  (siehe z. B. ). Das Unternehmen, das die Wikifarm betreibt, kann, aber muss nicht zustimmen, bestimmte Änderungen, die du anforderst, durchzuführen.

Übersicht über verfügbare Einstellungen
Siehe den Index zu Konfigurationseinstellungen und lies die Kommentare in der -Datei, um eine Übersicht darüber zu erhalten, was jede Variable macht. Eine kurze Auflistung der wichtigsten Variablen sowie der am häufigsten angefragten Funktionen befindet sich hierunter.

Include path
Die Variable $IP (include path) enthält den lokalen Dateipfad zur Basisinstallation deines Wikis. Seit MediaWiki 1.17 stellt MediaWiki $IP automatisch ein – das manuelle Festlegen der Variable in  ist nicht mehr notwendig. Sie stellt sich standardmäßig auf das aktuelle Arbeitsverzeichnis ein und kann genutzt werden, ohne manuell definiert werden zu müssen.

Die Datei DefaultSettings.php wird vom durch die Variable IP vorgesehenen Verzeichnis geladen.

Seitenname
 enthält den Namen deines Wikis. Dieser Name wird viele Male im ganzen System verwendet, etwa in MediaWiki:Pagetitle. Beispielsweise macht der Wikipedia-Slogan „Aus Wikipedia, der freien Enzyklopädie“ Gebrauch von dieser Einstellung.

Declensions of site name
Some translations of interface are ready for inflection of site name. You can set proper forms of word in variables ' (for example please refer to the ' documentation page).

Seitensprache
 stellt die Sprache der Benutzeroberfäche des Wikis ein. Während Benutzer die Sprache, die sie sehen, in den Benutzereinstellungen wechseln können, legt die Variable die Standardsprache für alle anonymen Benutzer und die meisten registrierten Benutzer fest.

Skriptpfad
 ist das Präfix im URL-Pfad, unter welchem auf das MediaWiki-Hauptskript, dem zentral arbeitenden Code von MediaWiki, zugegriffen wird. Diese Einstellung sollte mit den Apache-Einstellungen korrespondieren, insbesondere dann, wenn du Apaches Rewrite-Engine benutzt.

Servername
 enthält die Basis-URL des Servers, einschließlich des Protokolls, aber ohne den schließenden Schrägstrich und ohne jegliche Unterverzeichnisse, sollten diese existieren. Wenn das Wiki vom localhost aufgerufen wird, auf dem es läuft, von einem Intranet oder dem Internet, würden E-Mail-Benachrichtigungen und ein paar andere generierte Nachrichten normalerweise von verschiedenen URLs geliefert werden.

Ab MediaWiki 1.34 muss  in LocalSettings.php definiert werden. Davor versuchte MediaWiki, den Servernamen automatisch zu erkennen und  war optional zum Überschreiben der automatischen Erkennung.

Wenn z. B. www.example.com die Serveradresse deines Wikis vom Internet aus gesehen ist, füge eine solche Zeile hinzu:

Das Magische Wort  kann auf Seiten im Wiki verwendet werden; es gleicht dem Wert von  ; allerdings wird es in einem Wiki, das wie die Wikis der WikiMedia-Familie relative URLs benutzt, nicht vollständig ausgegeben; hier zeigt es z. B. an, was in dieser Form weder angeklickt noch in die Addresszeile des Browsers kopiert werden kann.

Skriptname
 ist der Name des MediaWiki zugrundelegenden PHP-Skripts (index), normalerweise benannt. Diesen Skriptnamen zu ändern ist meistens keine gute Idee. Wenn du aber das Verlangen hast, dies zu tun, ist das die Stelle, die du ändern solltest. Gehe sicher, dass du weißt, was du tust.

Name des Weiterleitungsskripts
 spezifiziert den URL-Pfad zum Weiterleitungsskript, welches Weiterleitungen in MediaWiki verarbeitet. Diese Einstellung ist ähnlich zu wgScript insofern, dass du den exakten Namen des Skripts konfigurieren kannst. Wie oben erwähnt wurde, ist es wahrscheinlich keine gute Idee, Änderungen daran durchzuführen, wenn du nicht genau weißt, was du tust.

Artikelpfad
 ist der zu nutzende Pfad, wenn eine Seite in MediaWiki aufgerufen wird. Der Pfad sollte den Pfad zum Hauptskript beinhalten (in der Regel unter der Nutzung von ) und den Platzhalter   für den Artikelnamen verwenden.

Wenn du die Apache Rewrite Rules benutzt, um schöne und kurze URLs zu erstellen, wirst du  wahrscheinlich so anpassen müssen, dass es auf den richtigen Pfad zeigt. Beachte, dass wgArticlePath benutzt wird, um URLs innerhalb von MediaWiki zu konstruieren. Wenn du hier einen Fehler machst, werden inkorrekte interne Links auftauchen, während du die Hauptseite aber möglicherweise noch aufrufen kannst, indem du die richtige URL manuell spezifizierst. Siehe Manual:Short URL/de für mehr Informationen zur URL-Konfigurierung.

Typische Werte sind:

Ort des Stylesheets
Benutze , um den URL-Pfad zum Ablageort der Stylesheets (CSS) für die MediaWiki-Installation einzustellen.  sollte auf den gleichen Ort zeigen; aber beachte, dass dies der Pfad eines lokalen Dateisystems ist, der in internen Skripten, die auf das Dateisystem zugreifen, genutzt wird.

Speicherort von hochgeladenen Dateien
Das Upload-Verzeichnis ist der Ort, an dem die von Benutzern hochgeladenen Dateien aufbewahrt werden. ' spezifiziert den URL-Pfad, ' zeigt auf den lokalen Dateisystempfad.

Logo
 legt fest, welche Grafik als Logo in der oberen linken Ecke auf allen Seiten im Wiki angezeigt wird. Die folgenden Schritte ersetzen das Standardlogo im Verzeichnis /wiki/skins/common/images/, wobei /wiki durch den Pfad zum Verzeichnis, in dem du die MediaWiki-Software installiert hast, ersetzt wird.

Kopiere zuerst das Logo, das du haben möchtest, in das Verzeichnis /wiki/skins/common/images/ (ersetze /wiki durch den Pfad, in dem du die MediaWiki-Software installiert hast).

Versuche dann, eine Zeile in  zu finden, die folgendermaßen aussieht:

Wenn es keine solche Zeile gibt, kannst du die obenstehende Zeile kopieren und am Ende der Datei einfügen.

Modifiziere anschließend diese Zeile, sodass sie auf dein Logo verweist. Das Logo muss im Web zugänglich sein. Der Wert dieser Variable wird an den Webbrowser weitergegeben, welcher ihn benutzt, um das Logo zu laden. Wenn du dir unsicher bist, was hier hineingehört, kannst du in deinem Webbrowser zum Logo navigieren (bspw. ist in diesem Wiki die URL des Logos http://upload.wikimedia.org/wikipedia/mediawiki/b/bc/Wiki.png ) und die vollständige URL als Wert in diese Variable packen.

Einige Leute ersetzen bloß die Datei skins/common/images/wiki.png durch ihr Logo. Das wird nicht empfohlen, da das auf diese Weise angepasste Logo bei einem Upgrade überschrieben werden würde.

Kontaktinfo
 ist die E-Mail-Adresse des Benutzers, der zu kontaktieren ist, wenn etwas schief geht. An diese E-Mail-Adresse werden interne Fehlermeldungen gesendet. Als ein Administrator der Webseite solltest du deine E-Mail-Adresse hierin mit aufnehmen.

 ist die E-Mail-Adresse, von der E-Mails losgesendet werden, wenn Passwörter an Benutzer gesendet werden, die dieses vergessen haben. Wähle eine Adresse, an die Leute im Fall von Problemen oder Verwirrung Antworten senden können.

Datenbankeinstellungen
MediaWiki benötigt Zugriff auf die Datenbank (zurzeit entweder MySQL oder PostgreSQL), um Seiten, Modifikationen, Benutzerinformationen und viele weitere Dinge zu speichern.

 enthält den Namen des Hosts, auf dem die Datenkbank gehostet ist. In den meisten Fällen wird das einfach nur „localhost“ sein, da die Datenbank auf dem gleichen System läuft; aber für verteilte Installationen musst du den vollqualifizierten Namen der Domain des Computers angeben, der die Datenbank betreibt.

 ist der Datenbankname der Datenbank, die von MediaWiki genutzt werden soll. Eine einzelne MySQL- oder PostgreSQL-Installation kann mehr als eine Datenbank lagern und du kannst sogar mehrere MediaWiki-Installationen auf einem einzigen Server betreiben. Gehe sicher, dass du hier den richtigen Datenbanknamen festlegst und benutze unterschiedliche Datenbanknamen für verschiedene Wiki-Installationen mit dem gleichen Datenbankserver.

' und ' enthalten den Login-Namen und das Login-Password, das von MediaWiki genutzt wird, um Zugriff auf die Datenbank zu erhalten. Gehe sicher, dass der angegebene Benutzer die benötigten Rechte hat, um die Tabellen des Wikis auf dem Datenbankserver bearbeiten zu können.

Benutzerrechte
 ist ein assoziatives Array, das die Befugnisse für die Erstellung und das Bearbeiten von Seiten für deine verschiedenen Benutzergruppen kontrolliert. In diesem Array können benutzerdefinierte Berechtigungsebenen erstellt werden und Berechtigungsebenen für die verschiedenen Benutzergruppen können eingestellt werden. Siehe für mehr Informationen zu den verschiedenen verfügbaren Berechtigungen und Benutzergruppen.

Force capital links
By default, no page name can start with a lowercase Roman letter: in an attempt to do so the first letter is converted to uppercase; if a link target, included page, image or category is specified with a name starting with a lowercase letter, the actual target etc. is the page starting with the corresponding capital.

Alternatively page names can start with a lowercase letter, in addition to the possibilities of starting with a capital, a digit, etc. For that you must adjust . Setting it to false allows lowercase characters, true chooses the default behavior.

Unterseiten aktivieren
In, subpages are enabled on a per-namespace basis using . For example, to enable subpages in the main namespace:

Dateiupload
Before users are allowed to upload files to the MediaWiki system, you have to enable that feature. Make sure the Upload Directory is properly configured and writeable by the Apache web server process. Then set  to true to allow uploading in the web user interface.

i.e. Here's some example code from includes/DefaultSettings.php to put in :

If you want to be able to resize images on the fly to support thumbnails, MediaWiki needs a working ImageMagick installation. Set  to true once you have installed and tested ImageMagick on your system. Make sure ' points to the proper location of the  command of your installation, that the command is executable by the web server process, and ' is large enough. See for detailed information and trouble-shooting.

Also, you may want to modify the list of accepted extensions, which is stored within :

In case ImageMagick outputs an error message similar to the following:
 * Fatal error: mime_magic could not be initialized, magic file is not available in includes/MimeMagic.php on line 506

then try adding the following line to :

= "file -bi";

Interwiki-Support
InterWiki support is built into MediaWiki but you need to configure the prefix to be used for your internal links. This prefix is usually the same as, but in case you need to change that, you set the variable to the preferred name.

Sprache der Benutzeroberfläche
MediaWiki allows for a variety of localized user interfaces languages instead of the English default. If you want to run your wiki in a non-English language, set the variable to the proper language code (e.g. "de" for German, "es" for Spanish, etc.)

You may use any of the languages with a file in the directory. E.g. if you find, then you can use   for Spanish. Do not use  with a capital letter. Although it seems to work, not all texts are translated.

Note: After changing the language code, you will need to run a PHP script to make it work. In a terminal window, change to your wiki directory, change to the  folder, and enter. On Windows, the PHP folder might not be in your  environment variable and you'll have to prefix php with the path to the program.

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

Copyright für die Seite setzen

 *  is the page on the wiki that covers the copyrights that it falls under. Usually, this will be Project:Copyrights.
 *  is the page describing full details of your license. (For the GNU FDL, for example, this would be .)
 *  is the text in the footer that follows "Content is available under". It will be linked to the page specified in.
 *  is the URL of the image placed at the left of the footer.
 * Note: If  is non-empty, the link in the copyright/license notice will link to that page on your site. If   is empty then the copyright/license notice will link to   instead.

To modify the copyright statements of the site, add something like this to :

Afterwards, edit MediaWiki:Copyright to provide an appropriate message, using  to indicate the position where the link to your copyright page will be.

Example: setting a Creative Commons license

To set a Creative Commons license do the following:


 * Choose your license: http://creativecommons.org/choose/
 * Examine the returned HTML code, e.g.:


 * For  enter the href info from the first anchor:
 * For  enter the text the second anchor links from (add the "a" to the Wiki variable for a more grammatically correct version)
 * For  enter the src info from the img link in the first anchor. You want to copy the badge to your own site instead of using the one from the Creative Commons site.


 * For using RDF metadata about copyright add one or both of the following lines to your :

Benutzerdefinierte Namensräume
By declaring ', and modifying ', and ', extra namespaces can be added to a MediaWiki installation; and by declaring the ' array namespace aliases can be added. Take heed not to have any pages already titled in that namespace, for instance if 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 for more information as to how to do so.

Skins
The default skin of the site can be modified via .

Siehe auch

 * source code, which generates the inital contents of  during installation.
 * 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  file.