Help:Installation/fr/Utilisation de Composer avec MediaWiki 1.22 - 1.24
Installation | |
---|---|
Cette page décrit l'installation faite en utilisant le support natif de Composer pour MediaWiki 1.22 - 1.24 | |
Informations complémentaires | |
Type d'installation : | new |
Méthode d'installation : | Composer |
mediawikiMinVersion : | |
Sommaire | |
Installation[edit]
Suivez les instructions pour une nouvelle installation de SMW.
- Installez Composer - suivez les instructions d'installation de Composer (en) pour ce faire.
- Vérifiez votre version de MediaWiki sur la page spéciale « Spécial:Version » pour vous assurer de la compatibilité. Voir aussi comment mettre à jour vers la bonne version de MediaWiki (en).
- Entrez la ligne de commande d'« initialisation » suivante[1][2] depuis le répertoire de base[3] de votre installation MediaWiki :
php composer.phar require mediawiki/semantic-media-wiki "~2.1"
- Note : La version déclarée dans les lignes ci-dessus est donnée seulement à titre d'exemple. Voir la page des versions sur GitHub (en) pour les dernières versions publiées. Pour les versions plus récentes, s'il existe par exemple une version appelée « SMW 2.4.1 », vous devrez remplacer
"~2.1"
par"~4.2"
et ainsi de suite. Ne mettez jamais le numéro de version correspondant aux corrections de bogues, c'est-à-dire le troisième nombre.
- Lancez le script de configuration depuis le répertoire de base[3] de votre installation MediaWiki :
php maintenance/update.php
- Ajoutez un appel vers
enableSemantics()
à la fin du fichier "LocalSettings.php".enableSemantics()
doit contenir le nom de domaine du wiki : un wiki situé sur "exemple.org", par exemple, aura l'appel suivant :enableSemantics( 'exemple.org' );
- L'appel
require_once …
ne doit plus être ajouté pour Semantic MediaWiki ni même pour Validator étant donné que Composer charge les extensions de façon automatique.
- Ajoutez les réglages optionnels[4] à une exception près[5] dans le fichier "LocalSettings.php" suivant les besoins après l'appel
enableSemantics()
. - Dans le cas ou vous voulez utiliser des extensions sémantiques supplémentaire qui ne sont pas installées via Composer comme par exemple Extension "Semantic Drilldown" vous devez toujours les appeler en ajoutant les lignes de code respectives
require_once …
dans votre fichier "LocalSettings.php" après l'appelenableSemantics()
. - Voyez la page « Spécial:Version » de votre wiki pour vérifier que l'extension a bien été installée.
- Testez votre installation selon la marche à suivre décrite dans la page d'aide pour tester SMW.
- C'est fini !
Mise à jour[edit]
Suivez les instructions pour mettre à jour une installation existante de SMW.
- Faites une sauvegarde de votre base de données et de votre installation.
- Lancer le script de mise à jour depuis le répertoire de base[3] de votre installation MediaWiki :
php composer.phar update
- Voyez la page « Spécial:Version » de votre wiki pour vérifier que l'extension a bien été mise à jour.
- Lancez le script de configuration depuis le répertoire de base[3] de votre installation MediaWiki :
php maintenance/update.php
- Lancez le script de rafraichissement de la base de données depuis le répertoire de base[3] de votre installation MediaWiki[6] :
php extensions/SemanticMediaWiki/maintenance/SMW_refreshData.php -d 50 -v
- C'est fini !
Mise à niveau[edit]
Voyez la page d'aide concernant la mise à niveau d'une version SMW 1.9+ pour MW 1.22+ (en).
MW 1.25+[edit]
Depuis la version MW 1.25+, MediaWiki utilise aussi Composer pour gérer les composants et les paquets. Dans le cas où vous verriez le message suivant [RuntimeException] The lock file does not contain require-dev information, run install with the --no-dev option or run update to install those packages. lorsque vous tentez d'exécuter composer require ...
, vous devez tout d'abord exécuter composer install
avant de pouvoir ajouter des extensions via Composer. Voir aussi la page d'aide concernant l'installation de SMW sur MediaWiki 1.25+.
Voir aussi[edit]
Références[edit]
- ↑ Cela est nécessaire étant donné que depuis la version MW 1.25+, MediaWiki utilise Composer pour gérer les composants et les paquets.
- ↑ Veuillez noter que si Git est installé, il est recommandé d'installer Composer avec le flag "--prefer-source", afin que Composer utilise Git pour télécharger le code. En d'autres termes, au lieu de faire "composer update" ou "php composer.phar update" comme noté sur cette page, vous devrier taper "composer update --prefer-source" ou "php composer.phar update --prefer-source".
- ↑ 3.0 3.1 3.2 3.3 3.4 Il s'agit du répertoire contenant le fichier "LocalSettings.php".
- ↑ Voyez la page d'aide concernant la configuration de SMW (en). Généralement seuls quelques paramètres de configuration doivent être changés si besoin est.
- ↑ Si vous configurez manuellement
$smwgNamespaceIndex
avec une autre valeur que la valeur par défaut qui est100
, vous devez le faire avant la ligne enableSemantics(). Assurez-vous que la valeur entrée est ≥100
et un nombre pair. - ↑ Il s'agit d'une étape optionnelle qui vérifie que le stockage sémantique est valide et à jour.