Mit RAD: Handler und Kernel-Overrides
Tutorial 8. Zwei Assistenten ändern das Verhalten des Systems über Ihren eigenen Code hinaus: Der Handler-Assistent
(/setup/handlerextension/<kind>) schreibt eine Klasse, die das System statt seiner Voreinstellung verwendet, gewählt
über eine einzige Einstellung, und der Assistent für Kernel-Overrides (/setup/kerneloverride) schreibt das letzte
Mittel, einen Ersatz für eine Kernel-Klasse. Die Ausgabe unten wurde von den Generatoren der Assistenten erzeugt
(expHandlerWizard::files(), expKernelOverrideWizard::files()); jede PHP-Datei hat php -l bestanden.
Teil A: ein Mail-Transport
1. Das Formular
Öffnen Sie /setup/handlerextension/mail. Die Seite erklärt die Art anhand des Rezepts des Assistenten: „Wie E-Mails
das System verlassen. Standardmäßig wird E-Mail an PHP übergeben, das sie an den Rechner übergibt. Ein eigener Transport
kann sie über eine API versenden, in eine Warteschlange stellen oder auf einem Rechner, der nichts versenden darf, auf
die Festplatte schreiben.“ Sie nennt die Basisklasse (eZMailTransport, lib/ezutils/classes/ezmailtransport.php) und
die Einstellung (site.ini [MailSettings] TransportAlias).
| Feld | Wert |
|---|---|
| Name der Extension | mysite_mail |
| Alias | mysitelog |
| Klassenname | mysiteLogMailTransport |
| Titel | Log mail transport |
2. Die Dateien
.gitignore
LICENSE
README.md
classes/mysitelogmailtransport.php
composer.json
doc/examples.php
extension.xml
ezinfo.php
settings/site.ini.append.php[MailSettings]
TransportAlias[mysitelog]=mysiteLogMailTransportclass mysiteLogMailTransport extends eZMailTransport
{
/**
* Sends one mail and says whether it went. Returning false is how a
* failure is reported; nothing else is read.
*/
public function sendMail( eZMail $mail )
{
// Not written yet. Returning true keeps the system
// working the way it did before this handler was switched on.
return true;
}
}3. Schreiben, dann auswählen
Ersetzen Sie den Rumpf durch den protokollierenden Transport aus Handler, die über Einstellungen benannt werden. Der Rezepthinweis des Assistenten ist wichtig: „Setzen Sie Transport im selben Abschnitt auf den Alias, sonst wird weiterhin der Standard verwendet.“ Setzen Sie ihn nur auf dem Entwicklungsserver:
./console exp:ini set site.ini/MailSettings/Transport mysitelog globalWarnung So wie erzeugt gibt
sendMail()truezurück, ohne etwas zu senden. SobaldTransportden Alias nennt, wird jede E-Mail stillschweigend verworfen, bis Sie die Methode schreiben. Schreiben Sie sie, bevor Sie sie auswählen.
Teil B: ein Kernel-Override
1. Das Formular
Öffnen Sie /setup/kerneloverride. Nennen Sie die zu ersetzende Kernel-Klasse und, verpflichtend, den Grund: warum
nichts Leichteres funktioniert. Der Assistent lehnt eine Klasse ab, die bereits von etwas anderem überschrieben wird
(„Zwei Overrides einer Klasse lassen sich nicht kombinieren“).
2. Die Dateien
Für eZSection:
.gitignore
LICENSE
README.md
bin/checkdrift.php
composer.json
extension.xml
ezinfo.php
kernel_override/ezsection.phpDie Kopie beginnt mit einem Kopfbereich, der ihre Herkunft festhält:
* ## KERNEL OVERRIDE - this file replaces a kernel class ##
*
* eZSection, copied from
*
* kernel/classes/ezsection.php
* md5 <checksum of the kernel file when copied>
* copied <date>gefolgt vom Grund und von „What you have taken on“ (was Sie damit übernommen haben): „This is not a subclass. There is
no parent to call and nothing is inherited“ (dies ist keine Unterklasse; es gibt keine Elternklasse zum Aufrufen, und
nichts wird geerbt). bin/checkdrift.php vergleicht nach jedem Upgrade die Kernel-Datei mit dieser Prüfsumme.
3. Einschalten
Die erzeugte README führt die Schritte auf: die Erweiterung aktivieren; Overrides in config.php mit
define( 'EZP_AUTOLOAD_ALLOW_KERNEL_OVERRIDE', true ); erlauben; die Override-Zuordnung mit
php bin/php/ezpgenerateautoloads.php -o erzeugen; die Caches leeren. Führen Sie dann bei jedem Deployment die
Abweichungsprüfung aus.
Lesen Sie Kernel-Klassen-Overrides: das letzte Mittel, bevor Sie das verwenden.
Verwandte Seiten
- Zurück: Mit RAD: eine Erweiterung nur mit Einstellungen
- Weiter: Von Hand: die kleinste Erweiterung in fünf Minuten
- Handler, die über Einstellungen benannt werden
- 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.