Local development quickstart/nl
Deze pagina is een beknopte handleiding voor het opzetten van het lokaal ontwikkelen van MediaWiki met behulp van PHP en Composer.
Vereisten voor installatie
MediaWiki vereist PHP 7.4.3+ en Composer 2.
Linux
Installeer op Ubuntu 22+ of Debian 11+ de vereiste pakketten met behulp van APT.
sudo apt install -y php php-intl php-mbstring php-xml php-apcu php-curl php-sqlite3 composer
Op Ubuntu 20 installeer PHP vanaf APT, maar installeer Composer vanaf getcomposer.org/download.
sudo apt install -y php php-intl php-mbstring php-xml php-apcu php-curl php-sqlite3
Op Fedora 35+, installeer de vereiste pakketten met behulp van DNF.
sudo dnf install -y php composer
Op Arch Linux, installeer de benodigde pakketten met behulp van pacman.
sudo pacman -S php composer --noconfirm
Mac
Installeer de benodigde pakketten met behulp van Homebrew.
brew install php composer
Windows
U heeft de mogelijkheid om de Windows-subsysteem voor Linux te gebruiken en de Linux-instructies op deze pagina te volgen. Of, om MediaWiki rechtstreeks op Windows te installeren, installeert u de vereiste pakketten met behulp van Chocolatey.
choco install -y php composer
Om de vereiste PHP-extensies te laden, beerkt u het bestand php.ini en verwijderd u het commentaar op de volgende regels.
Om de locatie van php.ini te vinden, voert u php --ini
uit en zoekt u naar 'Loaded Configuration File'.
extension:fileinfo
extension:intl
extension:pdo_sqlite
extension:zip
MediaWiki klonen
Gebruik Git om de MediaWiki core repository en de standaard skin te klonen.
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
Het klonen duurt een paar minuten. Terwijl u wacht, maak een Wikimedia-ontwikkelaarsaccount aan als u er nog geen heeft.
Afhankelijkheden installeren
Gebruik, in de hoofdmap van MediaWiki, Composer om de afhankelijkheden van MediaWiki te installeren.
composer update
MediaWiki installeren
Installeer MediaWiki met de interne SQLite-database van PHP.
composer mw-install:sqlite
Server starten
Start de ingebouwde webserver van PHP en open localhost:4000 in een browser om naar uw MediaWiki-instantie te gaan.
Om in te loggen als administrator , gebruikt u gebruikersnaam Admin
en wachtwoord adminpassword
.
composer serve
Volgende stappen
- Take a tour of the MediaWiki codebase – Maak uzelf vertrouwd met de kerncode van MediaWiki door meer te weten te komen over entrypoints en mappen op het hoogste niveau.
- Run unit tests – MediaWiki gebruikt het PHPUnit framework voor het testen van PHP-code en integratie. Lees de documenten om tests uit te voeren en informatie te vinden over het schrijven van tests.
- Install extensions – Voeg extensies toe, zoals VisualEditor en Echo aan uw ontwikkelomgeving. Zie Handleiding: Extensies ontwikkelen om te lezen hoe extensies werken.
- Debug your code – Leer hoe u het debuggen configureert en de MediaWiki-code stap voor stap debugt met XDebug.
- Submit a patch – Ontdek good first bugs , en configureer toegang met SSH tot Wikimedia Gerrit om een patch in te dienen.