Installer in Joomla

1. De basis

1.1 Wat com_installer is

com_installer is het core Joomla-component dat de hele levensloop van een extensie beheert: installeren, inschakelen, uitschakelen, bijwerken en verwijderen. Het heeft geen eigen menu op het hoogste niveau. In plaats daarvan verschijnt het als een groep schermen onder Systeem in de beheeromgeving.

Het is zelf een extensie (een component met de naam com_installer) en het is gemarkeerd als beschermd, zodat je het niet per ongeluk kunt verwijderen. Zonder dit component zou je niets anders kunnen toevoegen of bijwerken.

Als een scherm je een extensie laat toevoegen, bijwerken of verwijderen, dan kijk je naar com_installer.

1.2 Waar je het vindt

Alle installerschermen staan onder het menu Systeem, verdeeld over drie groepen:

Systeem
 ├─ Installeren
 │   └─ Extensies         (nieuwe toevoegen)
 ├─ Bijwerken
 │   └─ Extensies         (openstaande extensie-updates)
 └─ Beheren
     ├─ Extensies         (in-/uitschakelen / verwijderen, alle records zien)
     ├─ Updatesites       (waar updates vandaan komen)
     ├─ Detecteren        (bestanden registreren die al op de schijf staan)
     ├─ Database          (het schema controleren en herstellen)
     └─ Waarschuwingen    (problemen met de omgeving)

Elke regel is een andere weergave van hetzelfde component. De URL verraadt het: elk van deze schermen is index.php?option=com_installer&view=... in de beheeromgeving.

1.3 Wat het niet is

com_installer beheert extensies: de uitbreidingen die je aan Joomla vastmaakt. Het werkt de Joomla-core zelf niet bij. Dat is een apart component, com_joomlaupdate, te bereiken via Systeem → Bijwerken → Joomla. Mensen verwarren de twee vaak, dus houd het onderscheid in gedachten: com_installer voor je uitbreidingen, com_joomlaupdate voor het CMS.

3. Extensies installeren

3.1 De vier manieren om te installeren

De weergave install biedt vier tabbladen. Ze eindigen allemaal in dezelfde pijplijn; ze verschillen alleen in hoe het pakket de server bereikt.

"Installeren vanaf het web" is een app-store-ervaring die in de backend is ingebouwd. Het communiceert met de Joomla Extensions Directory (JED) via een aparte plugin, en je moet eenmalig de voorwaarden accepteren voordat het verschijnt.

3.2 Wat "installeren" eigenlijk doet

Welke methode je ook kiest, com_installer een pakket aanreiken start dezelfde vaste volgorde:

 1. Pak het pakket uit in een tijdelijke map
 2. Vind en verwerk het manifest    → lees type, files, sql, scriptfile
 3. Voer het script preflight() uit → kan de installatie afbreken
 4. Kopieer bestanden naar hun plek  → components/, modules/, plugins/, media/
 5. Voer de install-SQL uit          → CREATE TABLE #__example...
 6. Registreer de PSR-4-namespace
 7. Schrijf het #__extensions-record + manifest_cache
 8. Registreer eventuele updatesites uit het manifest
 9. Voer het script postflight() uit → basisdata, toon een bericht
10. Verwijder de tijdelijke map

Als een stap mislukt, draait com_installer het geheel terug. Je houdt nooit een half geinstalleerde extensie over die wel op de schijf staat maar in de database ontbreekt.

3.3 De maximale uploadgrootte

De meest voorkomende installatiefout heeft niets met Joomla te maken. Een grote .zip kan de PHP-instellingen upload_max_filesize of post_max_size overschrijden, en dan stopt de upload gewoon. Wanneer een groot pakket niet wil uploaden, gebruik dan Installeren vanuit map (upload de uitgepakte bestanden eerst via FTP) of Installeren vanaf URL. Het scherm Waarschuwingen, dat later aan bod komt, toont deze PHP-limieten zodat je ze in een oogopslag ziet.

5. Het scherm Beheren

5.1 Je bedieningspaneel

Systeem → Beheren → Extensies is de hoofdweergave van com_installer. Het toont elk record in de tabel #__extensions: core en van derden, in- en uitgeschakeld, elk type.

5.2 Beschermd en vergrendeld

Twee markeringen voorkomen dat je de site per ongeluk kapotmaakt:

• Beschermd (protected = 1) betekent dat de extensie niet kan worden verwijderd. Core-extensies zoals com_content dragen deze markering.
• Vergrendeld (locked = 1) betekent dat de extensie niet kan worden uitgeschakeld of bewerkt.

Daarom weigert het scherm Beheren je com_installer zelf te laten verwijderen of de standaardtaal uit te schakelen. De knoppen worden voor die records simpelweg niet aangeboden.

5.3 Filteren op core versus niet-core

Een verse Joomla 6-installatie wordt geleverd met ongeveer 150 extensies. Om je eigen uitbreidingen daartussen te vinden, stel je de locatie- en statusfilters in, of gebruik je het "core"-filter dat de API beschikbaar maakt (later beschreven). Het meeste dagelijkse werk gaat over de kleine set extensies die je zelf hebt toegevoegd.

7. Het scherm Database

7.1 Het schema synchroon houden

Beheren → Database vergelijkt de SQL-updatebestanden die in elke extensie worden meegeleverd met wat er werkelijk in je database staat. Wanneer een update nieuwe bestanden heeft gekopieerd maar de bijbehorende SQL nooit is uitgevoerd, raken de tabellen achter. Dit scherm vindt dat gat.

• Het toont elke extensie waarvan de databasestructuur verouderd is.
• Een knop Herstellen speelt de ontbrekende schemawijzigingen opnieuw af.
• Het is de oplossing voor de rode waarschuwing "Databaseschema is verouderd" op het dashboard.

7.2 Hoe het dit weet: #__schemas

De controle werkt via een kleine tabel, #__schemas, die de hoogste toegepaste schemaversie per extensie vastlegt.

#__schemas
 extension_id   | version_id
 27  (com_content)   | 6.0.0
 10000 (com_example) | 1.1.0

De updatemap van elke extensie bevat SQL-bestanden die naar versies zijn vernoemd, bijvoorbeeld sql/updates/mysql/1.1.0.sql. Na het uitvoeren ervan schrijft Joomla de hoogste toegepaste versie naar #__schemas. Dus #__extensions.manifest_cache bewaart de versie van het bestand, terwijl #__schemas de versie van de database bewaart. Wanneer de twee niet overeenkomen, is dat de waarschuwing, en Herstellen speelt de ontbrekende SQL opnieuw af om het gat te dichten.

9. Onder de motorkap (ontwikkelaarsblik)

9.1 De tabellen die com_installer raakt

9.2 De Installer-klasse en haar adapters

Geen van de schermen bevat de echte installatielogica. Ze roepen allemaal een framework-klasse aan, Joomla\CMS\Installer\Installer, die de hele volgorde regisseert: uitpakken, het manifest verwerken, bestanden kopieren, SQL uitvoeren, het record schrijven, events afvuren, opruimen.

Het slimme is dat Installer niet weet hoe een specifiek extensietype wordt geinstalleerd. Dat delegeert het aan een passende adapter. Elk extensietype heeft een eigen adapterklasse onder Joomla\CMS\Installer\Adapter:

Bij het installeren leest Installer het attribuut type uit het manifest, laadt de adapter met die naam en draagt het werk over. Daarom gaan een component, een plugin en een taalpakket allemaal door "de installer", maar belandt elk op een andere plek met andere databasewijzigingen. Ondersteuning voor een gloednieuw extensietype toevoegen zou betekenen dat je een nieuwe adapter schrijft, niet dat je Installer zelf wijzigt.

Nog twee klassen maken het plaatje compleet: InstallerAdapter is de gedeelde basis die elke adapter uitbreidt, en InstallerScript is de basis voor het eigen preflight/postflight-script van een extensie (behandeld in het extensies-artikel).

9.3 Installer-events: inhaken op installeren en bijwerken

com_installer vuurt events af rond elke installatie, update en verwijdering. Elke ingeschakelde plugin kan meeluisteren, waardoor deze kan reageren wanneer een andere extensie wordt geinstalleerd of bijgewerkt. Zo voegen commerciele leveranciers een downloadsleutel toe op het moment van bijwerken, zonder de core te wijzigen.

// Een leveranciersplugin voegt zijn abonnementssleutel toe aan de download-URL:
public function onInstallerBeforePackageDownload(&$url, &$headers)
{
    if (str_contains($url, 'example.org')) {
        $url .= '&key=' . $this->params->get('download_key');
    }
}

9.4 Programmatisch installeren

Je kunt de installer vanuit je eigen code aansturen met diezelfde Installer-klasse. Dit is wat scripts, migraties en de CLI onder de motorkap gebruiken; het kiest op basis van het manifest de juiste adapter voor je.

use Joomla\CMS\Installer\Installer;

$installer = new Installer();

// Installeren vanuit een al uitgepakte map:
if ($installer->install('/path/to/unzipped/extension')) {
    // gelukt
}

9.5 De beveiligingsgrens

Een extensie installeren betekent code kopieren en uitvoeren op je server, dus com_installer is een echte beveiligingsgrens. Het controleert bij elke installatie verschillende dingen:

• Toegangscontrole: het definieert eigen ACL-acties in access.xml, vooral core.manage (de schermen gebruiken) en core.admin (volledige controle). Beperk deze tot beheerders die je vertrouwt. Een gebruiker die extensies kan installeren, kan in feite elke code op je server uitvoeren.
• CSRF-tokens: elke installatie-, update- en verwijderaanvraag draagt een eenmalig token mee, zodat een aanvaller een ingelogde beheerder niet via een vervalste link iets kan laten installeren.
• Een schrijfbare tijdelijke map: pakketten worden uitgepakt in de tmp-map van Joomla voordat er iets wordt gekopieerd. Als die map ontbreekt of niet schrijfbaar is, mislukt de installatie vroegtijdig. Het scherm Waarschuwingen signaleert dit.

11. Web Services API

11.1 Extensies opvragen via REST

com_installer stelt zijn Beheren-lijst beschikbaar via de Joomla Web Services API. Met de API ingeschakeld en een token aangemaakt onder je gebruikersprofiel kun je de lijst met geinstalleerde extensies van buiten Joomla uitlezen. De route is:

GET /api/index.php/v1/extensions

curl -H "X-Joomla-Token: <token>" \
     "https://example.test/api/index.php/v1/extensions"

11.2 De lijst filteren

Het eindpunt accepteert queryparameters die overeenkomen met de schermfilters, zodat je het resultaat kunt beperken tot wat je nodig hebt:

curl -H "X-Joomla-Token: <token>" \
     "https://example.test/api/index.php/v1/extensions?core=false&type=plugin"

Dit is handig voor monitoring: een script kan de lijst met niet-core extensies over veel sites ophalen en alles markeren wat uitgeschakeld, verouderd of onverwacht is. Let op: de publieke API dekt het uitlezen van de lijst; installeren en bijwerken gebeurt nog steeds via de backendschermen of de CLI.

11.3 Het CLI-alternatief

Voor automatisering die dingen wijzigt, kan de Joomla-opdrachtregeltool controleren op core-updates en deze toepassen en geplande taken uitvoeren. Voor extensiebeheer blijven de backendschermen en de framework-klasse Installer de belangrijkste hulpmiddelen.

13. Veelgemaakte fouten en valkuilen

13.1 Extensie-updates verwarren met Joomla-update

Symptoom: Je voert trouw Systeem → Bijwerken → Joomla uit, maar extensies blijven verouderd.

Oplossing: Dit zijn twee componenten. Extensie-updates staan onder Systeem → Bijwerken → Extensies (com_installer); de core staat onder Bijwerken → Joomla (com_joomlaupdate). Controleer beide.

13.2 Een pakket dat niet wil uploaden

Symptoom: Een grote .zip mislukt of blijft hangen bij Pakketbestand uploaden.

Oplossing: Het bestand overschrijdt de PHP-instellingen upload_max_filesize of post_max_size. Controleer de limieten op het scherm Waarschuwingen en gebruik daarna Installeren vanuit map of Installeren vanaf URL.

13.3 Er verschijnt nooit een updatemelding

Symptoom: Een handmatig geinstalleerde extensie biedt nooit een update aan.

Oplossing: Waarschijnlijk heeft deze geen updatesite. Open Beheren → Updatesites, controleer of de site bestaat en is ingeschakeld, en gebruik Opnieuw opbouwen als de lijst er verkeerd uitziet.

13.4 De update lijkt laat

Symptoom: Er is een nieuwe versie uit, maar Joomla toont deze niet.

Oplossing: De updatecontrole is gecacht. Klik op Zoek updates om een verse controle te forceren, of verlaag Update-cachetijd in de Opties. Controleer ook of Minimale stabiliteit geen pre-release verbergt.

13.5 Bestanden kopieren zonder Detecteren

Symptoom: Je hebt de map van een extensie via FTP geupload, maar Joomla ziet deze niet.

Oplossing: Bestanden op de schijf zijn pas een geinstalleerde extensie als ze een #__extensions-record hebben. Voer Beheren → Detecteren uit om ze te registreren, of installeer de zip op de normale manier.

13.6 De schemawaarschuwing negeren

Symptoom: Een rode melding "Databaseschema is verouderd" die je steeds wegklikt.

Oplossing: Het betekent dat een SQL-migratie niet is uitgevoerd. Ga naar Beheren → Database en klik op Herstellen voordat er vreemde bugs verschijnen.

15. In het kort

INSTALLEREN   Systeem → Installeren → Extensies (Upload / Map / URL / Web)
BEHEREN       Systeem → Beheren → Extensies (in-/uitschakelen / verwijderen)
BIJWERKEN     Systeem → Bijwerken → Extensies (openstaande updates)
CORE-UPDATE   Systeem → Bijwerken → Joomla (com_joomlaupdate, apart)
UPDATESITES   Beheren → Updatesites (opnieuw opbouwen als updates verdwijnen)
DETECTEREN    Beheren → Detecteren (bestanden op de schijf registreren)
DATABASE      Beheren → Database (ontbrekende SQL opnieuw afspelen met Herstellen)
WAARSCHUWING  Beheren → Waarschuwingen (PHP-limieten, schrijfbare mappen)
OPTIES        cachetimeout (6u) . minimum_stability (Stabiel)
REST          GET /api/index.php/v1/extensions ?core= &type= &status=
TABELLEN      #__extensions . #__update_sites . #__updates . #__schemas