Manuel:LocalSettings.php

From mediawiki.org
This page is a translated version of the page Manual:LocalSettings.php and the translation is 100% complete.
Avertissement Avertissement : Ne modifiez pas le fichier LocalSettings.php avec les éditeurs de documents tels que Notepad sous Windows 10 version 1809 ou antérieur, TextEdit ou autres, qui ajoutent une marque d'ordre d'octets (BOM - Byte Order Mark) aux fichiers. Cela casserait le programme PHP de votre wiki. A la place, utilisez plutôt un éditeur de code comme Vim ou Notepad++. Ceux-ci gèrent l'encodage des fichiers de manière appropriée. Ils peuvent aussi être utilisés pour réparer les fichiers précédemment cassés par des éditeurs de documents.

Le fichier LocalSettings.php offre les paramètres de configuration de base (basés sur le fichier DefaultSettings.php ) pour une installation MediaWiki. Prenez votre temps pour vérifier ces paramètres dans le fichier. Celui-ci est habituellement généré par l'installateur de MediaWiki basé sur le web, mais vous pouvez modifier les paramètres, éventuellement de concert avec les paramètres Apache. Pour les installations MediaWiki configurées en tant que ferme de wikis, un fichier nommé CommonSettings.php peut être utilisé.

Emplacement sur le serveur

Le fichier LocalSettings.php n'est pas une page wiki, et vous ne pouvez pas y accéder avec votre navigateur web. Au contraire, c'est un fichier dans le système de fichiers du serveur. Son contenu est généré lors de la configuration initiale du wiki et le fichier résultant doit être copié manuellement sur le serveur. Le fichier doit être situé dans le dossier où vous avez installé MediaWiki, au même niveau que les dossiers comme includes/ et skins/, et les fichiers comme api.php. Si ce fichier n'y est pas, le wiki ne fonctionnera pas du tout - si le wiki fonctionne, le fichier est là. Si vous ne savez pas où il est, vous pouvez entrer une commande telle que find / -iname LocalSettings.php -print dans une fenêtre de terminal pour le localiser.

(Si vous utilisez Vagrant, voyez aussi MediaWiki-Vagrant#Paramètres MediaWiki).

Sécurité

LocalSettings.php contient généralement des données sensibles telles que les connexions de base de données. Ces données ne doivent jamais être révélées au public ! En raison d'une violation de sécurité quelque part sur le serveur, il peut arriver que d'autres utilisateurs soient en mesure d'afficher le contenu des fichiers. Afin d'améliorer la sécurité de vos données, vous devez définir des autorisations UNIX en conséquence pour ce fichier. L'utilisateur du serveur web doit avoir accès à ce fichier. Si c'est le même compte que le propriétaire du fichier, alors vous pouvez initialiser ces autorisations à 600. Parfois, l'utilisateur du serveur web n'est pas le propriétaire du fichier, mais il est dans le groupe UNIX des utilisateurs propriétaire. Dans ce cas, les autorisations à 640 devraient convenir. Pour une sécurité améliorée, vous devriez restreindre le plus possible les autorisations.

En outre, vous pouvez créer un utilisateur MySQL, qui est limité uniquement à l'accès de la base de données seule utilisée par le wiki et à fournir les informations d'identification de cet utilisateur dans LocalSettings.php. Aussi vous pouvez configurer votre serveur de base de données pour accepter uniquement les connexions depuis localhost - ce qui devrait empêcher l'accès de l'extérieur en cas de fuite des informations d'identification.

Voir aussi Manuel:Sécuriser les mots de passe de la base de données qui présente une méthode pour déplacer les parties sensibles de LocalSettings.php vers un autre fichier situé dans un répertoire différent.

Contenu du fichier

Lorsque vous modifiez LocalSettings.php, assurez-vous de l'enregistrer à nouveau dans le bon encodage. Vous devez utiliser l'encodage « ANSI en UTF-8 » - c'est un encodage UTF-8 sans marqueur d'ordre des octets (byte order mark, BOM).

LocalSettings.php contient du code PHP ; principalement la définition des variables et de leurs valeurs. La modification d'un paramètre signifie habituellement la modification de la valeur d'une variable PHP. Vos modifications prendront effet immédiatement après avoir sauvegardé le fichier sur le serveur: il n'est pas nécessaire de redémarrer manuellement quoi que ce soit. Néanmoins dans certains cas, vous devrez peut-être purger le cache de votre navigateur pour voir réellement les modifications que vous avez apportées.

Les valeurs par défaut de beaucoup d'autres paramètres sont définies dans includes/DefaultSettings.php, qui ne doit pas être édité ; si la variable que vous voulez changer n'est pas déjà mentionnée dans votre LocalSettings.php, copiez la ligne appropriée depuis DefaultSettings.php et modifiez-la de manière appropriée dans LocalSettings.php. Dans LocalSettings.php vous pouvez ajouter les nouvelles lignes à la fin.

Dans le fichier, il peut également y avoir plusieurs lignes telles que 'require_once "$IP/extensions/extension.php";', qui pointent vers les extensions. Ces lignes activent l'extension correspondante dans le wiki. Ces extensions peuvent demander à ce que plusieurs autres variables soient initialisées dans LocalSettings.php; voir la documentation de l'extension pour d'autres instructions.

Comme la plupart des fichiers PHP dans MediaWiki, LocalSettings.php ne se termine pas par la balise PHP de fermeture ?>. Cela empêche les administrateurs d'ajouter accidentellement de nouvelles informations après cette balise. PHP fonctionne bien sans balise de fermeture.

Si vous avez un wiki sur une ferme wiki de MediaWiki , vous n'avez peut-être pas accès en écriture (peut-être même pas d'accès en lecture) au fichier LocalSettings.php (voir par exemple [1]). La société qui gère la « ferme » peut ou non accepter de faire les changements que vous désirez. Peut-être veut-elle garder la plupart des paramètres identiques sur tous les wikis de la ferme wiki.

Ce fichier n'est pas écrit automatiquement sur votre serveur web pour des raisons de sécurité. En remplacement, il est proposé en téléchargement, que vous devez ensuite téléverser sur votre serveur pour que votre wiki commence à travailler. Pour une explication plus complète, voir cette explication (en anglais).

Description des paramètres disponibles

Consultez l'index des paramètres de configuration et les commentaires inclus dans les fichiers de paramètres pour obtenir de l'aide sur ce que font toutes les variables. Vous trouverez ci-dessous une courte liste des variables les plus importantes, ainsi que les caractéristiques les plus demandées.

Paramètres standards

Chemin d'installation

La variable $IP (install path - chemin d'installation) contient le chemin du fichier local vers l'installation de base de votre wiki. Depuis MediaWiki 1.18, le système définit automatiquement $IP. La définition manuelle de $IP dans LocalSettings.php n'est plus nécessaire. $IP sera par défaut le répertoire de travail actuel et peut être utilisé sans qu'il soit nécessaire de le définir manuellement. Si vous essayez d'initialiser $IP (ou MW_INSTALL_PATH) dans LocalSettings.php vous pourriez provoquer des résultats inattendus.

Le fichier DefaultSettings.php est chargé depuis le répertoire désigné par la variable IP.

Nom du site

$wgSitename contient le nom de votre installation wiki. Ce nom sera inclus plusieurs fois dans tout le système, comme sur MediaWiki:Pagetitle. Par exemple, le slogan « De Wikipédia, l'encyclopédie libre » fait usage de ce paramètre.

Déclinaison du nom du site

Certaines traductions de l'interface sont sensibles au changement du nom de site. Vous pouvez définir des formes plus appropriées du mot dans les variables $wgGrammarForms (pour un exemple, allez voir la page de documentation de $wgSitename ).

Langue du site

$wgLanguageCode contrôle la langue de l'interface de votre wiki. Alors que les utilisateurs peuvent changer la langue qu'ils voient dans leur préférences, cette variable définit la langue par défaut que voient tous les utilisateurs anonymes et la plupart des utilisateurs enregistrés.

Chemin du script

$wgScriptPath est le préfixe de l'URL d'accès au script principal de MediaWiki, qui est la pièce centrale du code de MediaWiki. Ce paramètre doit correspondre aux paramètres Apache, particulièrement si vous utilisez les règles de réécriture de Apache.

Nom du serveur

$wgServer contient l'URL de base du serveur y compris le protocole, mais sans la barre oblique à la fin, ni les sous répertoires (s'il y en a). Lorsque l'on accède au wiki soit à partir du Localhost où il s'exécute, soit de l'intranet ou de l'internet, les notifications par courriel ainsi que quelques autres messages générés seront habituellement délivrés avec les différentes URL.

A partir de MediaWiki 1.34 $wgServer doit être initialisé dans LocalSettings.php. Avant cela, MediaWiki essayait d'obtenir automatiquement le nom du serveur et $wgServer était optionnel, pour réécraser l'autodetection.

Si www.example.com est l'adresse du serveur de votre wiki telle que visible depuis internet, ajoutez une ligne similaire à

$wgServer = 'http://www.example.com';

La variable magic word {{SERVER}} peut être utilisée sur les pages wiki ; cela équivaut à la valeur de $wgServer ; cependant, sur un wiki, comme ceux de la famille Wikimedia, où les urls relatives sont utilisées, elle ne sera pas entièrement développée, par exemple ici elle affiche //www.mediawiki.org, qui ne peut ni être cliqué ni copié/collé dans la barre d'adresse tel quel.

Vous pouvez également utiliser une URL relative au protocole comme indiqué ci-dessous. Si vous utilisez une URL relative au protocole, assurez-vous d'avoir initialisé $wgCanonicalServer. $wgCanonicalServer est nécessaire à certains endroits du code lorsqu'une origine avec un protocole et un nom d'hôte, est nécessaire.

$wgServer = '//www.example.com';
$wgCanonicalServer = 'https://www.example.com';

Nom du script

$wgScript est le nom du script PHP principal (index) de MediaWiki, nommé index.php par défaut. Changer le nom du script n'est probablement pas une bonne idée. Cependant, si vous en ressentez le besoin, c'est là qu'il faut faire vos modifications. Assurez-vous de bien savoir ce que vous faites.

Chemin des articles

$wgArticlePath est le chemin à utiliser pour accéder à une page de MediaWiki. Le chemin doit contenir le chemin du script principal (habituellement en utilisant $wgScript) et utiliser la marque substitutive $1 désignant le nom de l'article.

Si vous utilisez les règles de réécriture Apache pour créer des URL courtes et simples, vous aurez probablement besoin de modifier $wgArticlePath pour utiliser le bon chemin. Il est à noter que wgArticlePath est utilisé pour construire des URLs dans MediaWiki. Si une erreur est commise ici, les liens internes seront incorrects alors qu'il sera toujours possible d'accéder à la page principale en entrant l'URL correcte manuellement. Voir Manuel:URL courte pour plus d'informations sur la configuration d'URL.

La valeurs usuelles sont :

"$wgScript/$1" Passer le nom de l'article avec le séparateur "/"
"$wgScript?title=$1" Passer le nom de l'article en tant que paramètre (style ancien)
"/mypath/$1" Chemin personnalisé. Utiliser les règles de réécriture d'Apache pour convertir "mypath" en chemin d'accès approprié au script principal

Emplacement des feuilles de style

Utilisez $wgStylePath pour définir le chemin URL de l'emplacement des feuilles de style (CSS) dans l'installation MediaWiki. $wgStyleDirectory doit pointer au même endroit, mais il s'agit du chemin dans le système de fichiers local, à utiliser dans les scripts internes qui accèdent au système de fichiers.

Emplacement des téléversements

Le répertoire de téléversement est l'endroit où sont stockés les fichiers envoyés par les utilisateurs. $wgUploadPath spécifie le chemin de l'URL, et $wgUploadDirectory le chemin du fichier local dans le système.

$wgLogo spécifie quel logo graphique est affiché dans le coin supérieur gauche de toutes les pages MediaWiki. Ces étapes remplacent le logo par défaut dans le répertoire /wiki/skins/common/images/, en remplaçant /wiki par le chemin vers le répertoire où vous avez installé le logiciel MediaWiki.

D'abord, copiez le logo que vous voulez dans le répertoire /wiki/skins/common/images/ (en remplaçant /wiki par le chemin du répertoire où vous avez installé le logiciel MediaWiki).

Ensuite, essayez de trouver la ligne qui ressemble à ceci dans LocalSettings.php :

$wgLogo = "$wgStylePath/common/images/wiki.png";

Si une telle ligne n'existe pas, vous pouvez copier et coller la ligne ci-dessus à la fin du fichier.

Ensuite, modifiez cette ligne pour pointer vers votre logo. Le logo doit être accessible à partir du web. La valeur de cette variable est transmise au navigateur Web, qui l'utilise pour récupérer le logo. En cas de doute, un bon moyen de choisir ce qu'il faut mettre ici est de naviguer vers le logo dans votre navigateur web (par exemple, l'url du logo de ce wiki est http://upload.wikimedia.org/wikipedia/mediawiki/b/bc/Wiki.png), et mettre l'URL complète comme la valeur de cette variable.

Certaines personnes remplacent simplement le fichier skins/common/images/wiki.png par leur logo. Ce n'est pas recommandé, car le logo personnalisé serait écrasé lors de la mise à niveau.

MediaWiki 1.35 a introduit $wgLogos , permettant des versions multiples pour un même logo. Vous trouverez ci-après, un exemple d'utilisation des logos multiples.

$wgLogos = [
	'1x' => "$wgStylePath/common/images/1x_version.png",
	'1.5x' => "$wgStylePath/common/1.5x_version.png",
	...
	'tagline' => [
		'src' => "$wgStylePath/common/tagline_version.png",
		'width' => 135,
		'height' => 15,
	],
];

Informations de contact

$wgEmergencyContact correspond à l'adresse courriel de contact des utilisateurs pour les dysfonctionnements. Cette adresse courriel est utilisée pour envoyer les rapports de bogues internes. En tant qu'administrateur, vous pouvez mettre votre adresse courriel à la place.

$wgPasswordSender est l'adresse de où le courriel a été envoyé, lorsque les mots de passe sont envoyés aux utilisateurs qui les ont oubliés. Choisissez une adresse à laquelle on peut vous répondre en cas de problème ou de confusion.

Paramètres de la base de données

MediaWiki a besoin d'accéder à la base de données (actuellement MySQL ou PostgreSQL) pour stocker les pages, les modifications, les informations utilisateur et beaucoup d'autres choses.

$wgDBserver représente le nom de l'ordinateur où se trouve la base de données. Habituellement il s'agit de localhost car la base de données s'exécute sur le même système, mais pour les installations distributées, vous devez remplir le nom de domaine complètement qualifié (FQDN) de l'ordinateur sur lequel se trouve cette base.

$wgDBname est le nom de base de donnée de la base de données à utiliser par MediaWiki. Une installation unique de MySQL ou PostgreSQL peut gérer plus d'une base de données et vous pouvez même exécuter plusieurs installations de MediaWiki sur un même serveur. Assurez-vous de bien avoir déclaré le nom correct de la base de données et d'utiliser des noms différents pour les différentes installations de wikis sur le même serveur de bases de données.

$wgDBuser et $wgDBpassword contiennent le nom et le mot de passe du compte à utiliser par Mediawiki, pour accéder à la base de données. Assurez-vous que l'utilisateur spécifié a bien les droits d'accès correspondants pour pouvoir gérer les tables wiki du serveur de base de données.

Voir aussi Manuel:Sécuriser les mots de passe de la base de données pour la méthode permettant de déplacer les parties sensibles de LocalSettings.php vers un autre fichier situé dans un répertoire différent.

Droits des utilisateurs

$wgGroupPermissions est un tableau associatif, contrôlant les niveaux de permission pour la création et la modification des pages, selon vos différents groupes d'utilisateurs. Dans ce tableau, les niveaux personnalisés de permission peuvent être créés, et les niveaux de permission pour les différents groupes d'utilisateurs peuvent être définis. Voir Help:User rights pour davantage d'informations concernant les différentes permissions et les groupes utilisateur disponibles.

Forcer les liens en majuscules

Par défaut, aucun nom de page ne peut commencer par une lettre minuscule lettre romaine : si c'était le cas, la première lettre serait convertie en majuscule ; si une cible de lien, une page, une image ou une catégorie incluse est spécifiée avec un nom commençant par une lettre minuscule, la cible réelle etc... est la page commençant par la lettre capitale correspondante.

Alternativement les noms de page peuvent commencer par une lettre minuscule, en plus des possibilités de commencer par une lettre capitale, un chiffre, etc. Pour cela, vous devez régler $wgCapitalLinks . Le réglage à false permet d'utiliser les caractères minuscules, et true choisit le comportement par défaut.

Activer les sous-pages

Dans LocalSettings.php, les sous-pages sont activées sur la base des espaces de noms à partir de $wgNamespacesWithSubpages . Par exemple, pour activer les sous-pages dans l'espace de noms principal :

$wgNamespacesWithSubpages[NS_MAIN] = 1;

Téléversement d'images

Pour autoriser les utilisateurs à téléverser des fichiers dans le système MediaWiki, vous devez activer cette fonctionnalité. Assurez-vous que le répertoire Upload est correctement configuré et accessible en écriture par le processus du serveur web Apache. Ensuite, initialisez $wgEnableUploads à true pour autoriser le téléversemnt depuis l'interface Web de l'utilisateur.

Voici des exemples de code de « includes/DefaultSettings.php » à copier dans LocalSettings.php :

$wgUploadPath       = "$wgScriptPath/uploads";      ## Wiki 1.5 defaults to /images, but allows more than just images
$wgUploadDirectory  = "$IP/uploads";                ## Wiki 1.5 defaults to /images, but allows more than just images

## To enable image uploads, make sure the above '$wgUploadPath' directory is writable by Apache User or group.
## ''(i.e.  chmod og+w uploads images)''  then the following should be true:
$wgEnableUploads       = true;

$wgUseImageMagick      = true;
$wgImageMagickConvertCommand = "/usr/bin/convert";

## If you want to use image uploads under safe mode, create the directories images/archive, images/thumb and
## images/temp, and make them all writable. Then uncomment this, if it's not already uncommented:
$wgHashedUploadDirectory = false;

Pour pouvoir redimensionner les images à la volée et supporter les vignettes, MediaWiki nécessite une installation opérationnelle de ImageMagick. Une fois celle-ci effectuée et après avoir testé ImageMagick, initialisez $wgUseImageMagick à true. Assurez-vous que $wgImageMagickConvertCommand pointe vers le bon répertoire de la commande convert de votre installation, que la commande est exécutable par le processus du serveur web, et que $wgMaxShellMemory est assez grand. Pour plus d'informations, reportez-vous à la section Manual:Image administration#Image thumbnailing pour des informations détaillées et les diagnostics de dépannage.

En outre, vous pouvez modifier la liste des extensions acceptées, stockées dans $wgFileExtensions  :

$wgFileExtensions = [ 'png', 'jpg', 'jpeg', 'ogg', 'doc', 'xls', 'ppt', 'mp3', 'sxc', 'pdf' ];

Dans le cas où ImageMagick génère un message d'erreur semblable à :

Erreur fatale: impossible d'intialiser mime_magic, le fichier magique n'a pas été trouvé dans includes/MimeMagic.php en ligne 506

essayez d'ajouter la ligne suivante à LocalSettings.php :

$wgMimeDetectorCommand = "file -bi";

Support interwiki

Le support d'InterWiki est intégré à MediaWiki mais vous devez configurer le préfixe à utiliser pour vos liens internes. Ce préfixe est généralement le même que $wgSitename , mais si vous devez le changer, initialisez la variable $wgLocalInterwikis avec le nom préféré.


Langue de l'interface utilisateur

MediaWiki permet une variété de langues d'interface utilisateur locales au lieu de la langue anglaise par défaut. Si vous souhaitez exécuter votre wiki dans une autre langue que l'anglais, configurez la variable $wgLanguageCode avec le bon code de langue (par exemple, « de » pour l'allemand, « es » pour l'espagnol, « fr » pour le français, etc.).

Vous pouvez utiliser l'une quelconque des langues avec un fichier dans le répertoire languages/i18n. Par exemple, si vous trouvez es.json, vous pouvez utiliser "es" pour le français. N'utilisez pas "Es" avec une majuscule. Bien que cela semble fonctionner, tous les textes ne sont pas traduits.

Après avoir modifié le code de langue, vous devrez exécuter un script PHP pour le faire fonctionner. Dans une fenêtre de terminal, allez dans votre répertoire wiki, puis passez au dossier maintenance et entrez php rebuildMessages.php --rebuild. Sous Windows, le dossier PHP n'est peut-être pas dans votre variable d'environnement PATH et vous devrez préfixer php avec le chemin du programme.

Toutes les langues ne sont pas prises en charge. Voir les [de traduction sur Translatewiki] pour connaître la liste à jour des langues prises en charge et jusqu'à quel point. Cette liste représente l'état actuel du noyau MediaWiki, donc en fonction de la version dont vous disposez, il peut y avoir une certaine différence.

Définir les droits d'auteur du site

Si $wgRightsPage n'est pas vide, le lien vers le texte du copyright ou de la licence sera vers cette page de votre site. Si $wgRightsPage est vide, le lien vers le texte du copyright ou de la licence sera alors vers $wgRightsUrl.

Pour modifier la mention sur le copyright du site, il suffit d'ajouter quelque chose comme ceci dans LocalSettings.php :

$wgRightsPage = "YourWiki:Copyright";
$wgRightsText = "copyright YourWiki";

Ensuite modifiez la page MediaWiki:Copyright pour y mettre un message approprié, en utilisant "$1" pour indiquer la cible du lien où se trouvera la page du copyright.

Exemple : définir une licence Creative Commons

Pour définir une licence Creative Commons vous devez :

<a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/3.0/">
<img alt="Creative Commons License" border="0" src="http://creativecommons.org/images/public/somerights30.png" />
</a>
This work is licensed under a
<a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/3.0/">
Creative Commons Attribution-NonCommercial-ShareAlike 3.0 License</a>.
  • Pour $wgRightsURL entrer l'info href de la première ancre :
$wgRightsUrl = "http://creativecommons.org/licenses/by-nc-sa/3.0/";
  • Pour $wgRightsText entrer le texte qui indique de où vient la seconde ancre (ajouter un a à la variable Wiki pour avoir une version grammaticalement correcte)
$wgRightsText = "a Creative Commons Attribution-NonCommercial-ShareAlike 3.0 License";
  • Pour $wgRightsIcon entrer l'info src du lien img dans la première ancre. Pour copier le badge de son propre site au lieu de celui de Creative Commons :
$wgRightsIcon = "http://creativecommons.org/images/public/somerights30.png";
  • Pour utiliser les métadonnées RDF concernant le copyright ajouter au moins l'une des deux lignes suivante dans votre LocalSettings.php :
$wgEnableCreativeCommonsRdf = true;
$wgEnableDublinCoreRdf = true;


Espaces de noms personnalisés

En déclarant $wgExtraNamespaces et en modifiant $wgNamespacesWithSubpages et $wgNamespacesToBeSearchedDefault , des espaces de noms supplémentaires peuvent être ajoutés à une installation MediaWiki ; et en déclarant le tableau $wgNamespaceAliases , vous pouvez ajouter des alias d'espaces de noms. Prenez garde de ne pas avoir de pages déjà nommée dans cet espace de noms, par exemple avec la page intitulée « Technical:Support », si vous avez créé l'espace de noms « Technical: » cette page serait non seulement perdue, mais vous ne pouvez pas la supprimer de Special:Allpages. Pour corriger cela, supprimez l'espace de noms, renommez « Technical:Support » en « Support » dans l'espace de noms principal, supprimez la redirection, réinsérez l'espace de noms et remettez-le dans « Technical:Support ». Voir Espaces de noms personnalisés pour plus d'informations sur la procédure à suivre.

Habillages

L'habillage (skin) par défaut du site est modifiable avec $wgDefaultSkin .

Voir aussi