Composer/nl

Composer is een hulpmiddel voor het beheren van afhankelijkheden van broncode van PHP-libraries. Vanaf versie worden de externe afhankelijkheden van MediaWiki met Composer beheerd. Het kan ook worden gebruikt om de installatie van MediaWiki extensies te beheren (beschikbaar vanaf versie ). Dit wordt nog niet goed ondersteund. Dat kan in de toekomst dus nog beter worden.



Composer installeren


Op Unix/Linux en macOS
Het installeren van Composer kan op meerdere manieren, voor de hand ligt deze manier:.

In MediaWiki 1.31, 1.35.0 en 1.35.1 wordt alleen Composer 1.x ondersteund. Ophalen meest recente stabiele Composer 1.x release:

Composer 2.x en Composer 1.x worden ondersteund in MediaWiki >= 1.35.2 (samen met de REL1_36 branch en master). Ophalen meest recente stabiele Composer 2.x release:

Gebruikers van macOS kunnen Homebrew gebruiken om Composer te installeren. Dit zal Composer 2.x installeren, dus u moet kijken of u die versie kunt gebruiken aan de hand van uw versie van MediaWiki, mogelijk moet u versie 1.x installeren en dus de  instructie volgen. Voor het het installeren met gebruik van :

Als dat niet werkt of als u geen Homebrew beschikbaar heeft, probeer dan:

Toolforge en de 'extensie distributeur' gebruiken de kopie van Composer uit de "integration/composer" git repo.

Na de installatie van Composer kunt u de commando's uitvoeren via de gedownloade phar:

U kunt het in uw PATH zetten zodat u het als een normale executable kunt gebruiken en op elke plek uitvoeren:

Als het commando mv mislukt vanwege rechten, voer het dan uit met sudo.



Op Windows
U kunt de installer downloaden van de downloadpagina en daarna uitvoeren. Als u een handmatige installatie wilt doen, volg dan de bovenstaande stappen. Windows kent echter standaard geen wget (of APT, Homebrew), er is ook geen map /usr/local/bin. In deze gevallen kunt u ook composer-1.phar downloaden in uw webbrowser en het bestand dan hernoemen als composer.phar.



Composer 1.x
Als u Composer wilt upgraden naar de laatste stabiele 1.x versie (of downgraden van versie 2.x), dan kan dat met:

Als het update commando mislukt vanwege rechten, voer het dan uit met sudo.

Als u een oude oude versie van composer gebruikt, dan heeft het mogelijk geen  parameter. Voer dan  twee keer uit. De eerste keer kan het upgraden naar 2.x, de 2e keer zal het downgraden na de actuele versie van 1.x.

Composer 2.x
Als u Composer 1.x gebruikt en het wilt upgraden naar Composer 2.x (omdat u een MediaWiki versie >= 1.35.2 gebruikt), dan kan dat met:

Als het update commando mislukt vanwege rechten, voer het dan uit met sudo.



Gebruik in MediaWiki core
MediaWiki 1.25+ is afhankelijk van bepaalde externe libraries die met Composer worden beheerd. Composer maakt een autoloader aan op, deze is toegevoegd bij.

De door Composer beheerde afhankelijkheden worden gebundeld in tarball distributies van MediaWiki en extensies zodat systeembeheerders niet direct Composer hoeven te gebruiken. Wanneer de installatie van MediaWiki via Git wordt gedaan, worden de afhankelijkheden gedeclareerd in  of lokaal geïnstalleerd door het uitvoeren van   of de   repository kan worden gekloond om dezelfde libraries te geven die gebruikt worden op het Wikimedia productie cluster.



Gebruik composer-merge-plugin
MediaWiki core "owns"  and will change the contents of that file in both tarball and Git managed updates. In order to allow local installs to use Composer to load optional libraries and/or manage extensions with Composer, a special plugin for Composer named composer-merge-plugin was developed. This plugin and the MediaWiki core  configuration allow a local deployment to add required extensions and libraries to a file   inside the root MediaWiki directory.

can also be used to install Composer managed libraries that are needed by extensions that are not installed using Composer themselves. This is only needed when the extensions are not installed from tarballs generated by Extension Distributor.

To enable Composer to discover and process the  files that may be included in any and all of your locally installed extensions, add something like this to  :

After any changes to, you need to remove   before running   again so that Composer will recalculate the dependencies and the changes will take effect.

Bronnen

 * List of extensions that can or must be installed with Composer
 * Composer (software)
 * Composer (software)
 * Composer (software)
 * Composer (software)
 * Composer (software)
 * Composer (software)