Inicio rápido para el desarrollo loca

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 8.2.0+ y Composer 2.

Linux

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

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

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

sudo dnf install php composer

En Arch Linux, instale los paquetes necesarios usando pacman.

sudo pacman -S php composer

Mac

Instale los paquetes requeridos usando Homebrew.

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

If the following command succeeds, it should show the PHP version. If it fails, likely your $PATH is not configured to find commands from brew.

php -v

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
extension:sodium

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, si planeas crear y compartir parches, 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 integrado 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

• Realice un recorrido por el código base de MediaWiki – Familiarice con el código central de MediaWiki aprendiendo sobre los puntos de entrada y directorios de alto nivel.
• Ejecutar pruebas unitarias – 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.
• Instalar extensiones – Agregue extensiones, como VisualEditor y Echo , a su entorno de desarrollo. Consulte Manual:Desarrollo de extensiones para saber cómo funcionan las extensiones.
• Depurar su código – Aprende a configurar las ayudas de depuración y a depurar el código de MediaWiki paso a paso con XDebug.
• Enviar un parche – Explore Buenos primeros errores y configure el acceso SSH a Wikimedia Gerrit para enviar un parche.