Manual:LocalSettings.php/fr

Le fichier   offre les paramètres de configuration de base (basés sur le fichier ) 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é  peut être utilisé.

Emplacement sur le serveur
Le fichier  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  et , et les fichiers comme. 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é
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. 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 qui présente une méthode pour déplacer les parties sensibles de   vers un autre fichier situé dans un répertoire différent.

Contenu 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).

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  , copiez la ligne appropriée de   et modifiez-la de manière appropriée dans. Dans, vous pouvez ajouter de nouvelles lignes à la fin.

Dans le fichier, il peut également y avoir plusieurs lignes telles que ' ', qui pointent vers les extensions. Ces lignes permettent d'activer l'extension concernée dans le wiki. Ces extensions peuvent nécessiter la définition des valeurs de plusieurs variables dans  ; 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 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  (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.

Chemin d'installation
La variable  (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  dans   n'est plus nécessaire. 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. Attempting to set  (or  ) in   may produce unexpected results.

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

Nom du site
 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 ' (pour un exemple, allez voir la page de documentation de ').

Langue du site
 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
 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
 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  doit être initialisé dans LocalSettings.php. Avant cela, MediaWiki essayait d'obtenir automatiquement le nom du serveur et  é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 à

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.

You can also use a protocol relative URL as shown below. When using a protocol relative URL, be sure to set. is needed for some places in the code where an origin with a protocol and hostname is needed.

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.

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 les règles de réécriture Apache pour créer des URL courtes et simples, 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 incorrects alors qu'il sera toujours possible d'accéder à la page principale en entrant l'URL correcte manuellement. Voir Manual:Short URL pour plus d'informations sur la configuration d'URL.

La valeurs usuelles sont :

Emplacement des feuilles de style
Utilisez  pour définir le chemin URL de l'emplacement des feuilles de style (CSS) dans l'installation MediaWiki.  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. ' spécifie le chemin de l'URL, et ' le chemin du fichier local dans le système.

Logo
 définit le logo graphique à afficher en haut à gauche de chaque page du wiki. Ces étapes remplacent le logo par défaut du répertoire /wiki/skins/common/images/, où /wiki est 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  (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 à 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 introduced , which allows multiple versions of the same logo. An example of using multiple logos is shown below.

Informations de contact
 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.

 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.

 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.

 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.

 et $wgDBpassword contiennent le nom et le mot de passe du compte à utiliser par Mediawiki, pour la connexion et l'accès à 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.

Also see for a method to move the sensitive parts of   to a different file in a different directory.

Droits des utilisateurs
 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 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 . Le réglage à false permet d'utiliser les caractères minuscules, et true choisit le comportement par défaut.

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

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  à true pour autoriser le téléversemnt 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 une installation opérationnelle 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 votre 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  :

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

essayez d'ajouter la ligne suivante à  :

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 si vous devez le changer, initialisez la variable 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 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. 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.

Toutes les langues ne sont pas prises en charge. Voir ici pour les statistiques de localisation de. Voir translatewiki.net pour les statistiques des versions précédentes.

Définir les droits d'auteur du site

 *  est la page du wiki qui couvre les droits d'auteur dont il relève. Habituellement, ce sera Project:Copyrights.
 *  est la page décrivant les détails complets de votre licence. (Pour la GNU FDL, par exemple, ce serait .)
 *  est le texte du pied de page qui suit « Contenu disponible sous ». Il sera lié à la page spécifiée dans.
 *  est l'URL de l'image placée à gauche du pied de page.

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

Ensuite modifiez la page MediaWiki:Copyright pour y mettre un message approprié, en utilisant  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 :


 * 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 MediaWiki ; et en déclarant le tableau ', 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 pour plus d'informations sur la procédure à suivre.

Habillages
L'habillage (skin) 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.
 * - guide pour sécuriser les mots de passe de votre base de données et le fichier.