Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,110 of 9,110 pages
About the help in other languages
All help pages

Eine Erweiterung aktivieren

Eine Erweiterung für die ganze Installation oder für einen Siteaccess einschalten, was dabei geschrieben wird, und die Schritte, mit denen die laufende Website sie sieht - Autoloads, Caches, PHP-FPM und Velocity.

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/extension-development/part-3-extension-developer/activating-an-extension.md

On this page

This page is a translation. Read the English original

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])WoGeltungsbereich
ActiveExtensions[]settings/override/site.ini.append.phpjeder Siteaccess
ActiveAccessExtensions[]settings/siteaccess/<sa>/site.ini.append.phpnur 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 global

Für einen einzelnen Siteaccess:

./console exp:ini add 'site.ini/ExtensionSettings/ActiveAccessExtensions[]' mysite_hello siteaccess:admin

exp: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
  1. Autoloads: Ihre Klassen werden in var/autoload/ezp_extension.php aufgenommen. Erwartete Ausgabe: Found <n> classes, added <n> of them to the autoload array. (-n zeigt die Anzahl, ohne zu schreiben.)
  2. Caches: der INI-Cache (Ihre Einstellungen), die Caches für Template-Overrides und Designs (Ihre Templates), der Inhalts-Cache (zuvor erzeugte Seiten).
  3. 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 deploy

Er 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-ok

checkclasses.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

SymptomUrsache
Ein Modul der Erweiterung meldet "not found"Caches nicht geleert, oder ExtensionRepositories[] fehlt in ihrer module.ini.append.php
Class ... not foundAutoloads nicht neu erzeugt, oder die PHP-Prozesse führen noch alten Code aus
Funktioniert auf der Kommandozeile, nicht im BrowserPHP-FPM oder Velocity nicht neu geladen
Die Website bricht direkt nach der Aktivierung zusammeneine 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

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.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x