View source for Help:Installation/fr/Utilisation de Composer avec MediaWiki 1.25+

{{Installation
 |Description=Cette page décrit l'installation faite en utilisant le support natif de Composer pour MediaWiki 1.25+
 |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<ref name="comglob">Dans le cas où vous avez installé Composer "globallement" sur votre serveur, vous devrer omettre les particules <code>php</code> et <code>.phar</code> sur la ligne de commande.</ref> :
#: <syntaxhighlight lang="text">php composer.phar require mediawiki/semantic-media-wiki "~2.1" --update-no-dev </syntaxhighlight> ou bien si Composer est installé de façon globale <syntaxhighlight lang="text">composer require mediawiki/semantic-media-wiki "~2.1" --update-no-dev </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>.
# 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<ref name="comglob" /> :
#: <syntaxhighlight lang="bash">php composer.phar update</syntaxhighlight> ou bien si Composer est installé de façon globale <syntaxhighlight lang="bash">composer 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>.

== 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.25+
| master rev  = 44283
| master link = internal
| status   = effective
| progress = 100
| priority = 1
| category = Manual
| author = LIMAFOX76
| editor = Kghbln
| support = 
| lang = fr
| minversion = 2.0
| desc =
| return =
| nowarn
}}
{{interlanguagelink:fr|Help:Installation/Using Composer with MediaWiki 1.25+}} {{DISPLAYTITLE:Utilisation de Composer avec MediaWiki 1.25+}}