Démarrage rapide du développement local

Cette page est un guide de démarrage rapide pour configurer un développement local pour MediaWiki en utilisant PHP et Composer.

Ce flux de travail ne convient que pour le développement local. Pour servir de site Web public, voir Manuel:Instructions d'installation .

Prérequis pour l'installation

MediaWiki nécessite PHP 8.2.0+ et Composer 2.

Linux

Sous Ubuntu 22+ ou Debian 12+, installer les paquets nécessaires en utilisant APT.

sudo apt install php php-intl php-mbstring php-xml php-apcu php-curl php-sqlite3 composer

Sous Fedora 36+, installer les paquets nécessaires en utilisant DNF.

sudo dnf install php composer

Sous Linux Arch, installer les paquets nécessaires en utilisant pacman.

sudo pacman -S php composer

Mac

Installez et activez dans PHP les paquets nécessaires à l'aide de Homebrew en les liant.

brew install php@8.2 composer
brew link --overwrite php@8.2

Si la commande suivante réussit, vous verrez la version PHP affichée. En cas d'échec, il est probable que votre $PATH ne soit pas configuré pour trouver les commandes de brew.

php -v

Windows

Vous pouvez utiliser Windows Subsystem for Linux et suivre les instructions Linux sur cette page. Ou pour installer MediaWiki directement sous Windows, installez les paquets nécessaires en utilisant Chocolatey.

choco install -y php composer

Pour charger les extensions PHP nécessaires, modifiez votre fichier php.ini et décommentez les lignes suivantes. Pour trouver l'emplacement de php.ini, exécuter php --ini, et chercher le fichier de configuration chargé.

extension:fileinfo
extension:intl
extension:pdo_sqlite
extension:zip
extension:sodium

Clôner MediaWiki

Utiliser Git pour clôner le dépôt du noyau MediaWiki et l'habillage par défaut.

git clone https://gerrit.wikimedia.org/r/mediawiki/core.git mediawiki 
git clone https://gerrit.wikimedia.org/r/mediawiki/skins/Vector.git mediawiki/skins/Vector
cd mediawiki

Clôner MediaWiki ne prend que quelques minutes. Pendant que vous attendez, si vous souhaitez créer et partager vos corrections, créez un compte développeur Wikimedia si vous n'en avez pas encore.

Installer les dépendances

A partir de votre répertoire mediawiki créé ci-dessous utilisez Composer pour installer les dépendances de MediaWiki.

composer update

Installer MediaWiki

Installer MediaWiki avec la base de données SQLite incluse avec PHP.

composer mw-install:sqlite

Démarrer le serveur

Démarrer le serveur web intégré de PHP, et afficher localhost:4000 dans un navigateur pour voir votre instance MediaWiki. Pour se connecter en tant qu'administrateur , utiliser le nom d'utilisateur Admin et le mot de passe adminpassword.

composer serve

Etapes suivantes

• Prendre connaissance de la base de code MediaWiki – Habituez-vous au code du noyau MediaWiki en prenant connaissance des points d'accès et des principaux répertoires.
• Exécuter les tests unitaires – MediaWiki utilise l'environnement PHPUnit pour les tests unitaires du code PHP et d'intégration. Lire la documentation pour exécuter les tests et chercher les éléments en rapport avec l'écriture de tests.
• Installer les extensions – Ajouter les extensions telles que VisualEditor et Echo à votre environnement de développement. Voir Développement d'extensions pour connaître le fonctionnement des extensions.
• Déboguer votre code – Apprenez comment configurer les aides au débogage et déboguez le code MediaWiki étape par étape avec XDebug.
• Soumettre une correction – Voir Bogues faciles pour commencer et configurer l'accès SSH à Wikimedia Gerrit pour soumettre une correction.