Inicio rápido para el desarrollo local

Esta página es una guía de inicio rápido para configurar un desarrollo local para MediaWiki usando PHP y Composer.

Este flujo de trabajo es sólo adecuado para el desarrollo local. Para servir una página web pública, vea Manual: Requisitos de instalación .

Requisitos previos

MediaWiki requiere PHP 7.4.3+ y Composer 2.

Linux

En Ubuntu 22+ o Debian 11+, instale los paquetes necesarios usando APT.

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

En Ubuntu 20, instale PHP desde APT, pero instale Composer desde getcomposer.org/download.

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

En Fedora 35+, instale los paquetes necesarios usando DNF.

sudo dnf install -y php composer

En Arch Linux, instale los paquetes necesarios usando pacman.

sudo pacman -S php composer --noconfirm

Mac

Instale los paquetes requeridos usando Homebrew.

brew install php composer

Windows

Tiene la opción de usar el Windows Subsistema para Linux y seguir las instrucciones de Linux en esta página. O, para instalar MediaWiki directamente en Windows, instale los paquetes requeridos usando Chocolatey.

choco install -y php composer

Para cargar las extensiones PHP necesarias, edita tu archivo php.ini y deja de comentar las siguientes líneas. Para encontrar la ubicación de php.ini, ejecuta php --ini, y busca el archivo de configuración cargado.

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

Clonar MediaWiki

Utilice Git para clonar el repositorio central de MediaWiki y la skin predeterminada.

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

Clonar MediaWiki toma unos minutos. Mientras esperas, crea una cuenta de desarrollador de Wikimedia si aún no tienes una.

Instalar dependencias

Desde el directorio raíz de MediaWiki, utiliza Composer para instalar las dependencias de MediaWiki.

composer update

Instalar MediaWiki

Instale MediaWiki con la base de datos SQLite de PHP.

composer mw-install:sqlite

Encienda el servidor

Inicie el servidor web incorporado de PHP, y abra localhost:4000 en un navegador para ver su instancia de MediaWiki. Para iniciar sesión como administrador , use el nombre de usuario Admin y la contraseña adminpassword.

composer serve

Siguientes pasos

• Take a tour of the MediaWiki codebase – Familiarice con el código central de MediaWiki aprendiendo sobre los puntos de entrada y directorios de alto nivel.
• Run unit tests – MediaWiki utiliza el marco PHPUnit para la prueba de unidad e integración del código PHP. Lea los documentos para hacer pruebas y encontrar información sobre las pruebas de escritura.
• Install extensions – Agregue extensiones, como VisualEditor y Echo , a su entorno de desarrollo. Consulte Manual:Desarrollo de extensiones para saber cómo funcionan las extensiones.
• Debug your code – Aprende a configurar las ayudas de depuración y a depurar el código de MediaWiki paso a paso con XDebug.
• Submit a patch – Explore Buenos primeros errores y configure el acceso SSH a Wikimedia Gerrit para enviar un parche.