Der Rundgang durch die RAD-Werkzeuge: Setup > RAD
Tutorial 1. Setup > RAD (/setup/rad, Richtlinie setup/setup) ist der Werkzeugkasten der Administration für
Erweiterungsentwickler. Er besteht aus drei Dingen: einem Katalog aller Stellen, an denen das System erweitert werden
kann, einer Übersicht dessen, was diese Installation tatsächlich anbietet, und einer Reihe von Assistenten, die
funktionierende Erweiterungen schreiben. Dieser Rundgang zeigt jedes davon; die Angaben stammen aus
kernel/setup/expradcatalogue.php, expradsurvey.php, expradhealth.php und den Assistentenklassen daneben.
1. Der Katalog
Öffnen Sie /setup/rad. Die Seite trägt den Titel „Werkzeuge zur schnellen Anwendungs-Entwicklung“ und sagt, was sie
ist: „Unten ist jeder Punkt aufgeführt, an dem dieses System erweitert werden kann: wofür er gedacht ist, wohin der Code
gehört und was ihn registriert.“
Jeder Eintrag zeigt:
| Feld | Bedeutung |
|---|---|
| Code | wohin der Code in Ihrer Erweiterung gehört |
| Registriert durch | die Einstellung oder Konvention, die ihn anschließt |
| Vertrag | die zu erweiternde Klasse oder die zu implementierende Schnittstelle |
| Kernel | die Kernel-Datei, in der der Mechanismus liegt |
| Werkzeug verfügbar / noch kein Werkzeug | ob ein Assistent ihn schreibt |
Die Einträge stehen in sieben Gruppen: Inhalt; Templates und Design; Module und Views; Workflow, Ereignisse und Jobs;
Speicherung und Infrastruktur; Pakete und Shop; Benutzer, Zugriff und Sprache. Drei Filter (aus
expRADCatalogue::filters()):
| Filter | Adresse |
|---|---|
| Alles | /setup/rad |
| Mit einem Werkzeug | /setup/rad/(show)/tools |
| Nur Dokumentation | /setup/rad/(show)/docs |
Das Feld Suchen grenzt die Liste beim Tippen ein (ein Name, eine Einstellung, eine Klasse, eine Datei). Derselbe Katalog als Text ist Erweiterungspunkte.
2. Die Übersicht
Der Katalog ist von Hand geschrieben; die Übersicht der Erweiterungspunkte (/setup/radsurvey) wird bei jeder
Anfrage von der Festplatte gelesen. Sie zählt, mit einem Link zu den Einträgen hinter jeder Zahl:
| Gruppe | Was sie auflistet |
|---|---|
| Einstellungen, die eine Klasse benennen | jeden INI-Wert, der eine Klasse nennt, über alle INI-Dateien hinweg |
| Orte, an denen der Kernel sucht | Verzeichnisse, in denen nach Handlern, Datentypen, Ereignissen ... gesucht wird |
| Schnittstellen und abstrakte Klassen | die Verträge |
| Module und ihre Views, Einschränkungen von Richtlinien | jede View und jede Einschränkung |
| Was ein Template aufrufen kann | alles, was ein Template aufrufen kann (Operatoren und Funktionen) |
| Ereignisse, auf die etwas hören kann | alles, was ein Ereignis ankündigt |
| Bereits ersetzte Templates | jede Override-Regel |
| Vollständig ersetzte Kernel-Klassen | wirksame Kernel-Overrides |
| Kommandos, Cronjob-Teile und Views als Klassen | die ausführbaren Klassen, die eine Unterklasse ersetzen kann |
| Registries | Einträge der in rad.ini deklarierten Registries |
Verwenden Sie sie, um die Frage „Gibt es dafür schon einen Anknüpfungspunkt?“ zu beantworten, bevor Sie einen
schreiben. Ein Abschnitt lässt sich verlinken: /setup/radsurvey/(show)/<section>. Die erzeugte Referenz ist
Die Erweiterungsoberfläche.
3. Die Zustandsprüfung
Die RAD-Seite führt außerdem expRADHealth::findings() aus: Einstellungen, die eine Klasse nennen, die sich nicht laden
lässt, ein durchsuchtes Verzeichnis, das nicht vorhanden ist, eine Design-Extension ohne Design, eine View ohne Skript,
ein angebotener, aber nicht gefundener Datentyp und mehr, jeweils mit dem Weg zur Behebung. Lesen Sie sie, nachdem Sie
eine Erweiterung installiert oder geschrieben haben.
4. Wie jeder Assistent funktioniert
Alle Assistenten folgen demselben Ablauf (kernel/setup/expextensionwizard.php):
- Die Extension: Name der Extension, Klassenname, Titel, Zusammenfassung, Autor, Composer-Vendor, Version, Lizenz.
- Was hineinkommt: die zu schreibenden Teile (für einen Datentyp: Bearbeiten, Klasseneinstellungen, Standardwert, Objekte benennen, Durchsuchbar, Sortierbar, Text ein und aus, Informationssammler, Dateien, Pakete, Unterschiede zwischen Versionen, Beim Veröffentlichen und mehr; jeder Teil ist eine Gruppe von Methoden, die nur zusammen sinnvoll sind).
- Was geschrieben wird: die Methoden oder Templates, jeweils mit einem Hinweis, wofür der Kernel sie aufruft.
- Einschalten: die genauen Zeilen, die Sie in
settings/override/site.ini.append.phpeintragen, und Dann (die Autoloads neu erzeugen, die Caches leeren). - Jede Datei, bevor sie geschrieben wird: der vollständige Inhalt jeder Datei, mit Zeilen- und Byteanzahl. Vorschau aktualisieren nach einer Änderung.
- In extension/ anlegen schreibt die Dateien, oder Als ZIP herunterladen gibt Ihnen dieselben Dateien als
Archiv. Wenn der Webserver nicht in
extension/schreiben kann, sagt die Seite das und bietet nur das Archiv an.
Schutzmechanismen, auf die Sie sich verlassen können
(RAD-Werkzeuge: Sicherheit): Nichts wird außerhalb von
extension/<name> geschrieben, eine vorhandene Erweiterung wird nie überschrieben, eingegebene Werte können nicht aus
Kommentaren oder INI-Zeilen ausbrechen, erzeugte Templates maskieren die Ausgabe, und erzeugte Views prüfen die
Eingabe.
5. Die Assistenten
| Assistent | Adresse | Tutorial |
|---|---|---|
| Assistent für Template-Extensions | /setup/templateoperator | Ein Template-Operator in fünf Minuten |
| Datentyp-Assistent | /setup/datatype | Ein Datentyp |
| Modul-Assistent / Modul über vorhandenen Tabellen | /setup/modulewizard, /setup/moduleextension | Ein Modul mit Views |
| Assistent für Workflow-Ereignisse | /setup/workflowevent | Ein Workflow-Ereignis |
| Assistent für Design-Extensions | /setup/designextension | Eine Design-Erweiterung |
| Assistent für Einstellungs-Extensions | /setup/settingsextension | Eine Erweiterung nur mit Einstellungen |
| Assistent für Content-Extensions | /setup/contentextension | eine Inhaltsklasse als Installationsskript |
| Handler-Assistent | /setup/handlerextension/<kind> | Handler und Kernel-Overrides |
| Assistent für Kernel-Overrides | /setup/kerneloverride | Handler und Kernel-Overrides |
6. Nach jedem Assistenten
./console exp:ini add 'site.ini/ExtensionSettings/ActiveExtensions[]' <name> global
php bin/php/ezpgenerateautoloads.php -e
php bin/php/ezcache.php --clear-all
php bin/php/checkclasses.php --quiet-okLesen Sie dann die erzeugte README.md: Jeder Assistent schreibt eine, die beschreibt, was er geschrieben hat und wie
es weitergeht, dazu doc/examples.php mit sofort ausführbaren Beispielen für die meisten Arten.
Verwandte Seiten
- Zurück: Tutorials: echte Erweiterungen Schritt für Schritt bauen
- Weiter: Mit RAD: ein Template-Operator in fünf Minuten
- RAD-Werkzeuge
- 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.