Eine Erweiterung aktivieren
Teil 3, Kapitel 4. Eine Erweiterung auf der Festplatte bewirkt nichts, solange sie nicht aktiv ist. Dieses Kapitel zeigt die zwei Wege, eine Erweiterung zu aktivieren, was jeder davon schreibt, und die Schritte nach der Aktivierung, mit denen die laufende Website Ihren Code sieht. Benutzer der Administration finden dasselbe unter Die Seite Extensions.
Für die ganze Installation oder für einen Siteaccess
Einstellung (site.ini [ExtensionSettings]) | Wo | Geltungsbereich |
|---|---|---|
ActiveExtensions[] | settings/override/site.ini.append.php | jeder Siteaccess |
ActiveAccessExtensions[] | settings/siteaccess/<sa>/site.ini.append.php | nur dieser Siteaccess |
Verwenden Sie ActiveAccessExtensions[] für eine Erweiterung, die nur zu einem Gesicht der Website gehört: ein
Werkzeug der Administration, das Design einer einzelnen Website. Alles andere gilt für die ganze Installation.
Im Browser
Setup > Extensions: Drücken Sie Aktivieren auf der Karte, dann Änderungen prüfen (die Seite zeigt die Risiken und die entstehenden Zeilen) und Änderungen anwenden. Die Seite schreibt die Override-Datei als Text, behält Kommentare bei, legt eine Sicherungskopie an und leert die Caches, die von der Liste abhängen.
Auf der Kommandozeile
./console exp:ini add 'site.ini/ExtensionSettings/ActiveExtensions[]' mysite_hello global --dry-run
./console exp:ini add 'site.ini/ExtensionSettings/ActiveExtensions[]' mysite_hello globalFür einen einzelnen Siteaccess:
./console exp:ini add 'site.ini/ExtensionSettings/ActiveAccessExtensions[]' mysite_hello siteaccess:adminexp:ini add hängt den Eintrag an das Ende der Liste an. Wo in der Liste eine Erweiterung steht, ist wichtig; siehe
Ladereihenfolge der Erweiterungen.
Nach dem Aktivieren: dafür sorgen, dass das System sie sieht
php bin/php/ezpgenerateautoloads.php -e
php bin/php/ezcache.php --clear-all- Autoloads: Ihre Klassen werden in
var/autoload/ezp_extension.phpaufgenommen. Erwartete Ausgabe:Found <n> classes, added <n> of them to the autoload array.(-nzeigt die Anzahl, ohne zu schreiben.) - Caches: der INI-Cache (Ihre Einstellungen), die Caches für Template-Overrides und Designs (Ihre Templates), der Inhalts-Cache (zuvor erzeugte Seiten).
- Die PHP-Prozesse: PHP-FPM-Worker mit OPcache können alte Dateien noch einige Sekunden behalten; Velocity-Worker behalten die Klassen und einige Einstellungen, die sie beim Start geladen haben, und brauchen einen Neustart.
Auf einer Installation, die von Velocity ausgeliefert wird, erledigt ein einziger Befehl all das in der richtigen Reihenfolge:
./console exp:velocity deployEr erzeugt die Autoloads der Erweiterungen neu, leert die Caches für INI, Templates, Overrides, Übersetzungen und Designs, sorgt dafür, dass PHP-FPM den neuen Code sieht, startet Velocity neu, leert dann den Inhalts- und den HTTP-Cache und gibt für jeden Schritt PASS oder FAIL aus. Siehe Bereitstellung.
Prüfen, ob sie aktiv ist
./console exp:ini get site.ini/ExtensionSettings/ActiveExtensions
php bin/php/checkclasses.php --quiet-okcheckclasses.php lädt jede Klasse der Installation und listet die auf, die PHP ablehnt; keine Ausgabe ist ein gutes
Zeichen. Die RAD-Zustandsprüfung unter /setup/rad listet Einstellungen Ihrer Erweiterung auf, die eine Klasse
nennen, die sich nicht laden lässt.
Deaktivieren
Entfernen Sie die Zeile (exp:ini rem 'site.ini/ExtensionSettings/ActiveExtensions[]' mysite_hello global) oder
drücken Sie Deaktivieren, erzeugen Sie dann die Autoloads neu und leeren Sie die Caches wie oben. Das Deaktivieren
entfernt weder die Datenbanktabellen noch die Inhaltsklassen oder Inhalte der Erweiterung: Eine Erweiterung, die sie
angelegt hat, sollte dokumentieren, wie man sie entfernt.
Was schiefgehen kann
| Symptom | Ursache |
|---|---|
| Ein Modul der Erweiterung meldet "not found" | Caches nicht geleert, oder ExtensionRepositories[] fehlt in ihrer module.ini.append.php |
Class ... not found | Autoloads nicht neu erzeugt, oder die PHP-Prozesse führen noch alten Code aus |
| Funktioniert auf der Kommandozeile, nicht im Browser | PHP-FPM oder Velocity nicht neu geladen |
| Die Website bricht direkt nach der Aktivierung zusammen | eine Klasse, die sich unter PHP 8 nicht laden lässt; führen Sie checkclasses.php aus, deaktivieren Sie die Erweiterung, beheben Sie den Fehler (Teil 4) |
Verwandte Seiten
- Zurück: extension.xml: Metadaten und Abhängigkeiten
- Weiter: Ladereihenfolge der Erweiterungen
- Die Seite Extensions, Bereitstellung
- Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.
Werden Sie Exponential-Partner
Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.