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.
Category:Gadget:TabbedWindowLinux
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@8.2 composer
brew link php@8.2
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 en u in de toekomst patches wilt maken en delen.
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
- Maak een rondleiding door de MediaWiki codebase – Maak uzelf vertrouwd met de kerncode van MediaWiki door meer te weten te komen over entrypoints en mappen op het hoogste niveau.
- Unittests uitvoeren – 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.
- Extensies installeren – Voeg extensies toe, zoals VisualEditor en Echo aan uw ontwikkelomgeving. Zie Handleiding: Extensies ontwikkelen om te lezen hoe extensies werken.
- Code debuggen – Leer hoe u het debuggen configureert en de MediaWiki-code stap voor stap debugt met XDebug.
- Een patch indienen – Ontdek good first bugs, en configureer toegang met SSH tot Wikimedia Gerrit om een patch in te dienen.