Lektion 7.3: Autoloads und Aktivierung
Zwischen dem Code einer Erweiterung und einer funktionierenden Website stehen zwei Dinge: Der Kernel muss ihre Klassen finden, und die Erweiterung muss eingeschaltet sein. Diese Lektion behandelt beides: das Autoload-Array und wann es neu erzeugt werden muss, die beiden Aktivierungseinstellungen, die Seite Extensions der Administration und was zu tun ist, wenn eine Klasse nicht gefunden wird.
Auf einen Blick
| Kurs | Entwickler |
| Modul | Modul 7: Erweiterungen |
| Dauer | 45 Minuten (15 Präsentation, 30 Übung) |
| Niveau | Fortgeschrittene |
| Zielgruppe | Entwickler und Administratoren |
| Voraussetzungen | Lektion 7.2 |
Lernziele
Nach dieser Lektion können die Teilnehmenden:
- die Autoloads der Erweiterungen mit
php bin/php/ezpgenerateautoloads.php -eneu erzeugen und sagen, wann das nötig ist; - eine Klasse im erzeugten Autoload-Array finden;
- eine Erweiterung mit
ActiveExtensions[]oder für einen Siteaccess mitActiveAccessExtensions[]einschalten; - unter Setup > Extensions aktivieren, deaktivieren und Änderungen prüfen;
- die Ursache einer nicht gefundenen Klasse mit den Autoloads,
checkclasses.phpund den Caches finden.
Hinweise für Trainer
So präsentieren Sie es
Quellen: Erweiterungen: finden, installieren, konfigurieren, bauen und veröffentlichen,
Die Seite Extensions und RAD-Werkzeuge
(die Zustandsprüfung und checkclasses.php).
- Autoloads (4 Minuten). Der Kernel durchsucht zur Laufzeit keine Ordner nach Klassen; er liest erzeugte
Zuordnungen in
autoload/.php bin/php/ezpgenerateautoloads.php -edurchsucht die Erweiterungen,-kden Kernel,-odie Kernel-Overrides. Führen Sie-eaus, nachdem Sie in einer Erweiterung eine Klasse hinzugefügt, umbenannt oder verschoben haben. - Aktivierung (3 Minuten).
site.ini [ExtensionSettings] ActiveExtensions[]insettings/override/schaltet eine Erweiterung überall ein;ActiveAccessExtensions[]in den Einstellungen eines Siteaccess schaltet sie für diesen Siteaccess ein. - Die Seite Extensions (5 Minuten). Setup > Extensions: eine Liste in Ladereihenfolge, die
Schaltflächen Aktivieren und Deaktivieren auf den Karten, Änderungen prüfen zeigt den Plan und die
Risiken, bevor etwas geschrieben wird, und Autoload-Arrays neu erzeugen erledigt den Lauf mit
-eaus dem Browser. - Wenn eine Klasse nicht gefunden wird (3 Minuten). Der Reihe nach: Liegt die Datei in
classes/(oder einem anderen Ordner, den der Generator durchsucht)? Lief-e? Ist die Erweiterung aktiv? Wurden die Caches geleert und auf einem Server, der PHP im Speicher hält, die Worker neu geladen (Lektion 13.2)?php bin/php/checkclasses.phplistet jede deklarierte Klasse auf, die PHP nicht laden will.
Häufige Fragen
Committe ich die Autoload-Dateien? Das Autoload-Array der Erweiterungen wird pro Installation erzeugt; das Repository Ihrer Erweiterung enthält die Klassen, nicht die erzeugte Zuordnung.
Warum erscheint eine deaktivierte Erweiterung trotzdem in den Autoloads? Der Generator erfasst die Klassen der Erweiterungen auf der Festplatte; die Aktivierung entscheidet, ob Einstellungen, Designs und Module verwendet werden.
Kann eine Aktivierung eine Website lahmlegen? Ja, eine fehlerhafte Erweiterung kann jede Seite anhalten. Aktivieren Sie zuerst auf der Entwicklungsinstallation; Änderungen prüfen warnt vor bekannten Risiken.
Stolperfallen
-enach einer neuen Klasse vergessen. Die häufigste Ursache für „Klasse nicht gefunden“.- Ein doppelt verwendeter Klassenname. Zwei Erweiterungen mit demselben Klassennamen: Nur eine davon lässt sich laden; geben Sie Ihren Klassen ein eigenes Präfix.
- Zuerst auf der Live-Website aktivieren. Immer erst in der Entwicklung, dann deployen.
Praktische Übung
Auf der Entwicklungsinstallation.
Erzeugen Sie die Autoloads der Erweiterungen neu:
php bin/php/ezpgenerateautoloads.php -e.Suchen Sie die Klasse Ihrer Fetch-Funktion in der erzeugten Zuordnung:
grep -rn "mysiteHelloFunctionCollection" autoload/.Benennen Sie die Klassendatei
classes/mysitehellofunctioncollection.phpinclasses/mysite_fetch.phpum, laden Sie den Spielplatz aus Lektion 5.4 neu, ohne neu zu erzeugen, und lesen Sie den Fehler. Erzeugen Sie mit-eneu und führen Sie ihn erneut aus.Prüfen Sie, dass jede Klasse der Installation geladen wird:
php bin/php/checkclasses.php --quiet-ok.Öffnen Sie in der Administration Setup > Extensions und suchen Sie die Karte von
mysite_hello. Lesen Sie, an welcher Stelle sie geladen wird.Klicken Sie bei
mysite_helloauf Deaktivieren, dann auf Änderungen prüfen, lesen Sie den Plan und verlassen Sie die Seite, ohne ihn anzuwenden (oder verwerfen Sie die Änderungen).Machen Sie
mysite_hellomit der Konsole nur für Ihren öffentlichen Siteaccess aktiv (und wieder zurück):php bin/php/console exp:ini add site.ini/ExtensionSettings/ActiveAccessExtensions mysite_hello siteaccess:<sa> --dry-runLesen Sie den Probelauf; führen Sie den Befehl nicht ohne
--dry-runaus, sofern Ihr Trainer nicht darum bittet.Committen Sie die umbenannte Klassendatei im Repository der Erweiterung.
Erwartetes Ergebnis
- Schritt 2: eine Zeile, die die Klasse ihrer Datei unter
extension/mysite_hello/classes/zuordnet. - Schritt 3: Vor dem Neuerzeugen schlägt der Fetch fehl (die Debug-Ausgabe nennt die fehlende Klasse); nach
-efunktioniert er. - Schritt 4 gibt nichts aus, wenn jede Klasse geladen wird.
- Schritt 6: Die Prüfung listet die Deaktivierung von
mysite_helloauf und was davon abhängt. - Der Trainer fragt alle Teilnehmenden nach den vier Prüfungen bei „Klasse nicht gefunden“.
Quiz
- Welche Option von
ezpgenerateautoloads.phpdurchsucht die Erweiterungen? A.-kB.-oC.-eD.--all - Wo steht die Einstellung, die eine Erweiterung für die ganze Installation aktiviert?
- Was macht Änderungen prüfen auf der Seite Extensions?
- Nennen Sie die vier Prüfungen, wenn eine Klasse Ihrer Erweiterung nicht gefunden wird.
- Welches Skript listet jede deklarierte Klasse auf, die PHP nicht laden will?
Antworten
- C.
-e. site.ini [ExtensionSettings] ActiveExtensions[], insettings/override/site.ini.append.php.- Sie zeigt, was sich ändern würde, mit den Risiken, bevor etwas geschrieben wird.
- Die Datei liegt in einem durchsuchten Ordner;
-elief; die Erweiterung ist aktiv; die Caches wurden geleert und die PHP-Worker neu geladen. php bin/php/checkclasses.php.
Weiterführende Literatur
- Die Seite Extensions: Aktivierung, Reihenfolge, Prüfen und Anwenden.
- Autoloads und Klassenbenennung.
- Zusätzliche Erweiterungsverzeichnisse.
Verwandte Seiten
- Modul 7: Erweiterungen
- Entwickler: Kursüberblick
- Trainer: hier beginnen
- 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.