View source for Help:Installation/fr/Utilisation de Composer avec MediaWiki 1.22 - 1.24

{{Installation
 |Description=Cette page décrit l'installation faite en utilisant le support natif de Composer pour MediaWiki 1.22 - 1.24
 |Installation type=new
 |Installation method=Composer
 |Language=fr
}}
== Installation ==

Suivez les instructions pour une nouvelle installation de SMW.

# Installez [[wikipedia:fr:Composer (logiciel)|Composer]] - suivez les instructions d'[http://getcomposer.org/doc/00-intro.md#installation-nix installation de Composer] <tt>(en)</tt> 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 [[mws:Manual:Upgrading|mettre à jour vers la bonne version de MediaWiki]] <tt>(en)</tt>.
# Entrez la ligne de commande d'« initialisation » suivante<ref>Cela est nécessaire étant donné que depuis la version MW 1.25+, MediaWiki utilise Composer pour gérer les composants et les paquets.</ref><ref>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".</ref> depuis le répertoire de base<ref name="base">Il s'agit du répertoire contenant le fichier "LocalSettings.php".</ref> de votre installation MediaWiki :
#: <syntaxhighlight lang="text">php composer.phar require mediawiki/semantic-media-wiki "~2.1"</syntaxhighlight>
#: {{Note (fr)}} La version déclarée dans les lignes ci-dessus est donnée seulement à titre d'exemple. Voir la [https://github.com/SemanticMediaWiki/SemanticMediaWiki/releases page des versions sur GitHub] <tt>(en)</tt> 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 <code>"~2.1"</code> par {{LatestAvailableStableReleaseForComposer}} 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<ref name="base" /> de votre installation MediaWiki :
#: <syntaxhighlight lang="text">php maintenance/update.php</syntaxhighlight>
# Ajoutez un appel vers <code>enableSemantics()</code> à la fin du fichier "LocalSettings.php". <code>enableSemantics()</code> doit contenir le nom de domaine du wiki : un wiki situé sur "exemple.org", par exemple, aura l'appel suivant :
#: <syntaxhighlight lang="php">enableSemantics( 'exemple.org' );</syntaxhighlight>
#: L'appel <code>require_once …</code> 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<ref name="config">Voyez la page d'aide concernant la [[Help:Configuration|configuration de SMW]] <tt>(en)</tt>. Généralement seuls quelques paramètres de configuration doivent être changés si besoin est.</ref> à une exception près<ref name="index">Si vous configurez manuellement [[Help:$smwgNamespaceIndex|<code>$smwgNamespaceIndex</code>]] avec une autre valeur que la valeur par défaut qui est <code>100</code>, vous devez le faire ''avant'' la ligne enableSemantics(). Assurez-vous que la valeur entrée est ≥ <code>100</code> et un nombre pair.</ref> dans le fichier "LocalSettings.php" suivant les besoins ''après'' l'appel <code>enableSemantics()</code>.
# Dans le cas ou vous voulez utiliser des [[Help:SMW extensions|extensions sémantiques]] supplémentaire qui '''ne''' sont '''pas''' installées via Composer comme par exemple [[Semantic Drilldown]] vous devez toujours les appeler en ajoutant les lignes de code respectives <code>require_once …</code> dans votre fichier "LocalSettings.php" ''après'' l'appel <code>enableSemantics()</code>.
# 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 [[Help:Testing|tester SMW]].
# C'est fini !

== Mise à jour ==

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<ref name="base" /> de votre installation MediaWiki :
#: <syntaxhighlight lang="bash">php composer.phar update</syntaxhighlight>
# 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<ref name="base" /> de votre installation MediaWiki :
#: <syntaxhighlight lang="bash">php maintenance/update.php</syntaxhighlight>
# Lancez le script de rafraichissement de la base de données depuis le répertoire de base<ref name="base" /> de votre installation MediaWiki<ref name="refresh">Il s'agit d'une étape optionnelle qui vérifie que le stockage sémantique est valide et à jour.</ref> :
#: <syntaxhighlight lang="bash">php extensions/SemanticMediaWiki/maintenance/SMW_refreshData.php -d 50 -v</syntaxhighlight>
# C'est fini !

== Mise à niveau ==

Voyez la page d'aide concernant la [[Help:Installation/Upgrade from SMW 1.9+ for MW 1.22+|mise à niveau d'une version SMW 1.9+ pour MW 1.22+]] <tt>(en)</tt>.

== MW 1.25+ ==

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 <code>composer require ...</code>, vous devez tout d'abord exécuter <code>composer install</code> avant de pouvoir ajouter des extensions via Composer. Voir aussi la page d'aide concernant l'[[Help:Installation (fr)/Utilisation de Composer avec MediaWiki 1.25+|installation de SMW sur MediaWiki 1.25+]].

== Voir aussi ==

* [[Help:Installation/Installation commands for Composer|Commandes d'installation pour Composer]] <tt>(en)</tt>.
* [[Help:Installation/Example_"composer.json"_file|Fichier exemple "composer.json"]] <tt>(en)</tt>.

== Références ==

<references/>

{{docinfo
| master page = Help:Installation/Using Composer with MediaWiki 1.22 - 1.24
| master rev  = 42202
| master link = internal
| status   = effective
| progress = 100
| priority = 1
| category = Manual
| author = LIMAFOX76
| editor = Kghbln
| support = 
| lang = fr
| minversion = 2.0
| desc =
| return =
| nowarn
}}