Manual:LocalSettings.php/fr

Le fichier   offre de base des paramètres de configuration (basés sur le fichier ) d'une installation MediaWiki. Vous devriez prendre votre temps pour vérifier les paramètres dans ce fichier. Le fichier 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és en tant que wiki ferme, un fichier nommé  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. aussi, c'est un fichier dans le système de fichiers du serveur. Ses contenus sont générés lors de la configuration initiale du wiki et le fichier résultant doit être copiés manuellement sur le serveur. Le fichier doit être situé dans le dossier dans lequel 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 devraient 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 sont 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 : Le fichier utilisateur du serveur web doit avoir accès à ce fichier. Si c'est le même compte, qui est propriétaire du fichier, vous pouvez définir des autorisations à 600. Parfois, l'utilisateur du serveur web n'est pas le propriétaire du fichier, mais il est dans le groupe d'utilisateurs propriétaire d'UNIX. Dans ce cas, les autorisations de 640 doit être fine. Pour plus de sécurité, vous devriez réduire les autorisations aussi loin que possible.

En outre, vous pouvez créer un utilisateur MySQL, qui est limité à 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 pouvez-vous 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.

Contenus du fichier
Lorsque vous modifiez, 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. Quoi qu'il en soit, dans certains cas, vous devrez peut-être effacer 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, 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 de   et modifiez-la de manière appropriée dans LocalSettings.php</tt>. Dans LocalSettings.php</tt>, vous pouvez ajouter de nouvelles lignes à la fin.

Dans le fichier, il peut également y avoir plusieurs lignes telles que ' ', qui pointent vers extensions. Ces lignes permettent d'activer l'extension dans le wiki. Ces extensions peuvent nécessiter la définition des valeurs de plusieurs variables dans LocalSettings.php</tt> ; Consultez la documentation de l'extension correspondante pour obtenir d'autres instructions.

Comme la plupart des fichiers PHP dans MediaWiki,  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 MediaWiki ferme wiki, vous n'avez peut-être pas accès en écriture (peut-être même pas accès en lecture) au fichier  (voir par exemple ). 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.

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.

Inclure le chemin
La variable $IP (include path) contient le chemin du fichier local à l'installation de base de votre wiki. Depuis MediaWiki 1.17, MediaWiki définit $IP automatiquement - il n'est plus nécessaire de le définir manuellement dans LocalSettings.php</tt>. Il sera par défaut le répertoire de travail courant automatiquement et peut être utilisé sans avoir à le définir manuellement.

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

Nom du site
La variable  contient le nom de votre wiki. Ce nom sera inclus plusieurs fois dans tout le système. Par exemple, le Wikipedia slogan «Un article 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 sensible au changement du nom du site. Vous pouvez définir les formes appropriées du mot dans les variables $wgGrammarForms.

Langage du site
La variable $wgLanguageCode contrôle la langue de l'interface de votre wiki. Alors que les utilisateurs peuvent changer la langue qu'ils voient dans leur preferences, cette variable définit la langue par défaut que tous les utilisateurs anonymes, voir la plupart des utilisateurs enregistrés.

Chemin du script
$wgScriptPath est le préfixe de l'URL d'accès au script principal MediaWiki, qui est la pièce centrale (par intérim) du code de MediaWiki. Ce paramètre doit correspondre à la configuration Apache, en particulier si vous utilisez les règles Apache rewrite.

Nom du serveur
$wgServer peut être utilisé pour remplacer éventuellement la détection automatique. Lorsque le wiki est accessible à partir de différent moyens : soit en local (via  ou  ) soit à partir d'un réseau local (via par exemple  ) soit d'Internet (via URL), les notifications par e-mail et quelques autres messages calculé serait normalement transmis avec les différentes URL. L'utilisation de  remplace la détection et le nom du serveur.

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

La variable magic word  peut être utilisée sur les pages wiki ; cela équivaut à la valeur de   ; 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, qui ne peut ni être cliqué ni copié/collé dans la barre d'adresse tel quel.

Nom du script
 est le nom du script PHP principal (index) de MediaWiki, nommé  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.

Redirection du nom du script
 spécifie le chemin de l'URL vers le redirect script qui gère les redirections dans MediaWiki. Ce paramètre est similaire à wgScript puisque le nom exact du script peut être configuré. Comme mentionné ci-dessus, ce n'est probablement pas une bonne idée à moins que vous ne sachiez exactement ce que vous faites.

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

Si vous utilisez Apache, pour réécrire les règles pour créer des URL courtes et simple, vous aurez probablement besoin de modifier  pour utiliser le bon chemin. Il est à noter que wgArticlePath est utilisé pour construire des URLs au sein du MediaWiki. Si une erreur est commise ici, les liens internes seront incorrectes alors qu'il sera toujours possible d'accéder à la page principale en entrant l'URL correcte manuellement. Se reporter ici Manual:Short URL pour plus d'informations sur la configuration d'URL.

La valeurs usuelles sont :

Emplacement des feuilles de style
Utilise la variable $wgStylePath pour définir le chemin URL vers les feuilles de style (CSS) de l'installation MediaWiki. La variable $wgStyleDirectory doit pointer au même endroit, mais il s'agit du chemin du système de fichier local pour des utilisations dans des scripts internes accédant au système de fichier.

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

Logo
La variable $wgLogo variable définit l'image qui s'affiche en haut à gauche de toutes les pages du wiki. Elle se situe dans, sous le paragraphe "require" :

D'abord, copiez le logo que vous voulez dans le répertoire  (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  :

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 sur le 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.

Informations de contact
La variable $wgEmergencyContact correspond à l'adresse e-mail du contact pour les rapports de bugs internes. Il est recommandé d'y ajouter celle de l'administrateur système.

La variable $wgPasswordSender est l'adresse e-mail de l'expéditeur des courriels de recouvrement de mot de passe. Il convient donc que l'on puisse lui écrire en cas 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. Habituellement localhost, mais pour les installations distributées, il faut renseigner le FQDN.

 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 est le login du compte qui accède à la base de données (il doit donc en avoir les droits). $wgDBpassword son mot de passe.

Droits des utilisateurs
$wgGroupPermissions est un tableau associatif, contrôlant les niveaux des permissions d'édition des pages, selon les différents groupes d'utilisateurs. Voir Manual:User rights/fr pour les détails.

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 la variable . Réglage à false permet les caractères minuscules, true choisit le comportement par défaut.

Activer les sous-pages
Dans, les sous-pages sont activées sur une base par espace de noms à partir de . Par exemple, pour activer les sous-pages dans l'espace de noms principal :

Ajouts d'images
Pour autoriser les utilisateurs à télécharger des fichiers sur le système MediaWiki, vous devez activer cette fonctionnalité. Assurez-vous que le répertoire upload (définit dans $wgUploadPath) est correctement configuré et accessible en écriture par le processus du serveur web Apache (son utilisateur ou groupe). Ensuite, définissez la variable $wgEnableUploads à true pour permettre l'ajout de fichiers depuis l'interface Web de l'utilisateur.

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

Pour pouvoir redimensionner les images à la volée et supporter les vignettes, MediaWiki nécessite l'installation de ImageMagick. Une fois celle-ci effectuée et après avoir testé ImageMagick, initialisez  à true. Assurez-vous que ' pointe vers le bon répertoire de la commande  de l'installation, que la commande est exécutable par le processus du serveur web, et que ' est assez grand. Pour plus d'informations, reportez-vous à la section 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 le tableau  :

Dans le cas où ImageMagick génère un message d'erreur semblable au suivant :
 * Fatal error: mime_magic could not be initialized, magic file is not available in includes/MimeMagic.php on line 506

puis essayez d'ajouter la ligne suivante à  :

= "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, mais au cas où vous devez le changer, vous placez la variable au nom préféré.

Langue de l'interface utilisateur
MediaWiki permet une variété de langues d'interface utilisateur locale 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 avec le bon code de langue (par exemple, "de" pour l'allemand, "es" pour l'espagnol, "fr" pour le français, etc.) en minuscule (sinon tout ne sera pas traduit).

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

Remarque : 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  et entrez. Sous Windows, le dossier PHP n'est peut-être pas dans votre variable d'environnement  et vous devrez préfixer php avec le chemin du programme.

Voir aussi localisation statistics pour les statistiques de localisation de la dernière version, et translatewiki.net pour ceux qui concernent les versions précédentes.

Définir les droits d'auteur du site

 * $wgRightsPage : page du wiki qui traite du copyright en vigueur. Habituellement, elle correspond à Project:Copyrights.
 * $wgRightsUrl : description détaillée de la licence (pour GNU FDL par exemple, voir .)
 * $wgRightsText : texte du pied de page qui suit la phrase Les textes sont disponibles sous. Il est relié à la page indiquée dans.
 * $wgRightsIcon : URL de l'image placée à gauche de pied de page.
 * si  n'est pas vide, le lien vers la licence sera à cette page, sinon à.
 * $wgEnableDublinCoreRdf et $wgEnableCreativeCommonsRdf ajoutent des métadonnées

Pour modifier la mention sur le copyright du site, il suffit d'ajouter dans  :

Ensuite il faut éditer la page MediaWiki:Copyright pour renseigner le message, en utilisant  comme position du lien vers la page de copyright.

Exemple : licence Creative Commons

Pour la définir :


 * Choisir la licence : http://creativecommons.org/choose/
 * Examiner le code HTML retourné, ex :


 * Pour  entrer l'info   de la première ancre :
 * Pour  entrer le texte des liens de la seconde ancre de (ajouter le   à la variable Wiki pour une version grammaticalement correcte)
 * Pour  entrer l'info   du lien   dans la première ancre. Pour copier le badge de son propre site au lieu de celui de Creative Commons :


 * Pour utiliser les métadonnées RDF concernant le copyright ajouter au moins l'une des deux lignes suivante dans votre  :

Espaces de noms personnalisés
En déclarant ' et en modifiant ' et , des espaces de noms supplémentaires peuvent être ajoutés à une installation de MediaWiki ; Et en les déclarant des alias de l'espace de noms $wgNamespaceAliases peuvent être ajoutés. Prenez garde de ne pas avoir de pages déjà nommée dans cet espace de noms, par exemple dans la page intitulée « Technical:Support » et que 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, déplacez « Technical:Support » vers « Support » dans le secteur 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 (skins)
L'habillage par défaut du site est modifiable avec .

Voir aussi

 * Code source qui génère le contenu initial de  pendant l'installation.
 * Les familles de Wiki peuvent partager le même.
 * Extension:Configure fourni une manière de configurer les paramètres depuis une page spéciale.
 * Manual:Securing database passwords - un guide pour sécuriser vos mots de passe de base de données et le fichier.