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

Mit RAD: Handler und Kernel-Overrides

Der Handler-Assistent schreibt einen Mail-Transport, der über eine Einstellung gewählt wird; der Assistent für Kernel-Overrides schreibt eine Kopie mit ihrer Herkunft und einer Abweichungsprüfung. Beides anhand echter…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/extension-development/part-3-extension-developer/tutorials/rad-handlers-and-kernel-overrides.md

On this page

This page is a translation. Read the English original

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

FeldWert
Name der Extensionmysite_mail
Aliasmysitelog
KlassennamemysiteLogMailTransport
TitelLog 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]=mysiteLogMailTransport
class 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 global

Warnung So wie erzeugt gibt sendMail() true zurück, ohne etwas zu senden. Sobald Transport den 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.php

Die 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

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