Spezifikation: die expcomponents-Pakete und wofür der Kernel sie verwendet #

Diese Seite ist die Referenz zu jeder Bibliothek der expcomponents, des Forks der Zeta Components durch Exponential (Apache License 2.0): was das Paket tut, welche Klassen, Dateien und Funktionen des Kernels es verwenden, welches Ursprungspaket es ersetzt und wo sein Repository ist. Überblick, Geschichte und Gründe für den Fork stehen auf der Funktionsseite Exponential Components (expcomponents); was ein Upgrade bedeutet, in den Upgrade-Hinweisen.

Die Listen der Verwendungen stammen aus dem eigenen Code des Kernels (kernel/, lib/, bin/, update/, index_webdav.php), durchsucht nach dem Klassenpräfix jeder Komponente, zum Beispiel grep -rlE '\bezcMail' --include=*.php kernel lib. Wiederholen Sie diese Suche, um eine Liste an Ihrem Release zu prüfen. Erweiterungen werden genannt, wo eine mitgelieferte Erweiterung von einer Komponente abhängt.

Inhalt #

1. Gemeinsame Regeln für jedes Paket
2. Übersichtstabelle
3. base
4. archive
5. authentication
6. cache
7. configuration
8. console-tools
9. database
10. debug
11. event-log
12. feed
13. image-analysis
14. image-conversion
15. mail
16. mvc-tools
17. persistent-object
18. signal-slot
19. system-information
20. webdav
21. Forks, die der Kernel nicht verlangt
22. Ursprungspakete, die nicht geforkt werden

Gemeinsame Regeln für jedes Paket #

Versionsstand: Jeder Fork auf dieser Seite wurde am 2026-11-06 veröffentlicht (ein Tag, ein GitHub-Release und die Version auf Packagist); archive 1.5.2 und webdav 1.2.2 erschienen einige Tage vorher. Jeder Fork verlangt die anderen mit ihren Fork-Namen (se7enxweb/expcomponents-base ~1.8, nicht zetacomponents/base).

Übersichtstabelle #

base #

• Zweck: die Infrastruktur, auf die sich jede Komponente stützt: die Basis-Ausnahmeklassen (ezcBaseException, ezcBaseValueException, ezcBasePropertyNotFoundException, ezcBaseFileNotFoundException ...), die Options-Basisklasse ezcBaseOptions, die Struct-Basisklasse, ezcBaseFile (rekursive Verzeichnisdurchläufe, relative Pfade) und der ursprüngliche Autoloader ezcBase::autoload.
• Verwendung im Kernel:
  • kernel/private/classes/ezautoloadgenerator.php, der Motor von php bin/php/ezpgenerateautoloads.php, durchläuft die Verzeichnisse mit ezcBaseFile::findRecursive() und walkRecursive() und berechnet Pfade mit calculateRelativePath();
  • lib/ezutils/classes/ezsys.php wirft ezcBasePropertyNotFoundException für unbekannte Eigenschaften;
  • Options- und Struct-Klassen in kernel/private/options/ und kernel/private/structs/, die Inhaltsklassen der öffentlichen API (kernel/private/api/content/), die Cluster-Ausnahmen (kernel/private/classes/exceptions/cluster/), das DFS-Backend für MySQLi, die OAuth-Module und die REST-Schicht (kernel/private/rest/classes/).
  • Die Prüfung setup.ini [ezcversion] des Setup-Assistenten (TestClass=ezcBaseFile, TestFunction=walkrecursive) prüft, dass die Bibliothek installiert ist.
• Hinweis zum Autoload: autoload.php registriert ezcBase::autoload nur, wenn EZCBASE_ENABLED als true definiert ist; mit Composer ist es weder nötig noch registriert.
• Fork: se7enxweb/expcomponents-base, Repository, ersetzt zetacomponents/base. Jeder andere Fork verlangt es unter diesem Namen (se7enxweb/expcomponents-base ~1.8).

archive #

• Zweck: tar-Archive (ustar, v7, pax, GNU) und zip-Archive erstellen, ändern und entpacken.
• Verwendung im Kernel:
  • kernel/classes/ezpackage.php: Der Export schreibt .ezpkg-Dateien mit ezcArchive::open( ..., ezcArchive::TAR_USTAR ) oder ezcArchive::ZIP; der Import entpackt sie;
  • kernel/classes/exppackagearchive.php und kernel/classes/exppackagearchivemodes.php: das Lesen von Paketarchiven und die Dateimodi ihrer Einträge;
  • kernel/classes/ezpackageuploadinspector.php: prüft ein hochgeladenes Paket vor dem Import;
  • kernel/classes/exppackagejson.php: das JSON-Paketformat liest dieselben Archive.
• Funktionen: Setup > Pakete (Import, Export, Upload), ezpm auf der Kommandozeile, die Installation von Site-Paketen.
• Fork: se7enxweb/expcomponents-archive, Repository, ersetzt zetacomponents/archive. Vom Kernel seit 2026-11-03 verlangt (~1.5.2, seit 2026-11-06 ~1.5.3). Release 1.5.2 (vom Original 1.5.1): keine Deprecations unter PHP 8.4 und 8.5, GNU-tar-Einträge mit langen Namen oder langen Links werden wieder entpackt, Tests auf PHP 7.4 bis 8.5.

authentication #

• Zweck: Benutzer mit Filtern für verschiedene Anmeldedaten und Anbieter identifizieren und authentifizieren.
• Verwendung im Kernel: die Authentifizierung der REST-Schicht: kernel/private/rest/classes/auth/ (die Basis der Authentifizierungsstile, der Filter für native Benutzer, der Passwortfilter, der API-Schlüssel-Filter und apikey_rest.php), die Stile in kernel/private/rest/classes/auth/styles/ (basic_auth.php, no_auth.php, oauth.php) und kernel/private/rest/classes/oauth/oauth_filter.php. Verwendete Klassen: ezcAuthentication, ezcAuthenticationFilter, ezcAuthenticationIdCredentials, ezcAuthenticationPasswordCredentials.
• Funktionen: die Anmeldung an REST-API v1 und v2, API-Schlüssel, OAuth.
• Fork: se7enxweb/expcomponents-authentication, Repository, ersetzt zetacomponents/authentication.

cache #

• Zweck: ein Cache-Manager mit mehreren Speicher-Backends (Dateien, Speicher, APC und andere).
• Verwendung im Kernel: der Cache der REST-Schicht: kernel/private/rest/classes/cache/ (object.php, storage.php, apc.php, cluster.php mit Optionen und Ausnahme, ein clusterfähiger Speicher von Exponential selbst), der Router (kernel/private/rest/classes/router.php) und der REST-Controller. Verwendete Klassen: ezcCacheManager, ezcCacheStorage, ezcCacheStorageFile, ezcCacheStorageMemory, ezcCacheStorageOptions, ezcCacheInvalidDataException.
• Funktionen: zwischengespeicherte REST-Routen und -Antworten.
• Fork: se7enxweb/expcomponents-cache, Repository, ersetzt zetacomponents/cache.

configuration #

• Zweck: Konfigurationsdateien in mehreren Formaten lesen (INI und array-basiert).
• Verwendung im Kernel: keine; der Kernel hat sein eigenes INI-System (eZINI). Das Paket bleibt verlangt, weil 7x SQLI Import 2.0.x eine seiner Ausnahmeklassen wirft (Verhaltensänderungen vom Oktober 2026).
• Fork: se7enxweb/expcomponents-configuration, Repository, ersetzt zetacomponents/configuration. Das Repository ist mit dem offiziellen Fork neu; erstes Fork-Release am 2026-11-06.

console-tools #

• Zweck: Eingaben auf der Kommandozeile (Optionen und Argumente), formatierte Ausgabe, Fortschrittsbalken, Statusleisten und Tabellen.
• Verwendung im Kernel:
  • kernel/private/classes/commands/ezpgenerateautoloads.php und kernel/private/classes/ezpautoloadclioutput.php: die Optionen und die Fortschrittsausgabe von php bin/php/ezpgenerateautoloads.php (ezcConsoleInput, ezcConsoleOption, ezcConsoleOutput, ezcConsoleProgressbar, ezcConsoleStatusbar);
  • kernel/classes/help/exphelpexamplesgenerator.php: der Beispielgenerator der Hilfe;
  • update/common/scripts/4.2/fixorphanimages.php: ein Update-Skript.
• Funktionen: die Erzeugung der Klassen-Maps (auch durch ./console exp:velocity deploy und die Post-Install-Hooks von Composer).
• Fork: se7enxweb/expcomponents-console-tools, Repository, ersetzt zetacomponents/console-tools. Das Repository ist mit dem offiziellen Fork neu; erstes Fork-Release am 2026-11-06.

database #

• Zweck: eine Datenbankschicht auf PDO mit einer Abfrage-Abstraktion, die Unterschiede zwischen SQL-Dialekten verbirgt.
• Verwendung im Kernel: kernel/private/rest/classes/lazy.php erzeugt die Datenbankverbindung der REST-Schicht mit ezcDbFactory und ezcDbInstance (einschließlich ezcDbHandlerSqlite); kernel/private/modules/oauthadmin/list.php listet OAuth-Clients mit ezcQuerySelect. Die eigene Datenbankschicht des Kernels (eZDB) verwendet es nicht.
• Funktionen: die Speicherung von REST und OAuth; persistent-object braucht es.
• Fork: se7enxweb/expcomponents-database, Repository, ersetzt zetacomponents/database.

debug #

• Zweck: Zeitmesser und strukturierte Debug-Ausgabe in mehreren Formaten.
• Verwendung im Kernel: kernel/private/rest/classes/debug/debug.php und kernel/private/rest/classes/debug/formatters/php_formatter.php: die Debug-Ausgabe der REST-Schicht (ezcDebug, ezcDebugStructure, ezcDebugOutputFormatter, ezcDebugStacktraceIterator, ezcDebugTimerStruct). Die Debug-Ausgabe der Seiten des Kernels (eZDebug, die Exp-Debug-Leiste) verwendet es nicht.
• Fork: se7enxweb/expcomponents-debug, Repository, ersetzt zetacomponents/debug. Das Repository ist mit dem offiziellen Fork neu; erstes Fork-Release am 2026-11-06.

event-log #

• Zweck: Ereignisse in Dateien oder andere Speicher protokollieren, mit Schweregraden (ezcLog::ERROR ...).
• Verwendung im Kernel: kernel/private/rest/classes/router.php und kernel/private/rest/classes/controllers/rest_controller.php protokollieren REST-Fehler mit den Schweregraden von ezcLog über die REST-Debug-Klasse. Die eigenen Logs des Kernels (eZLog, var/log/) verwenden es nicht.
• Fork: se7enxweb/expcomponents-event-log, Repository, ersetzt zetacomponents/event-log. Das Repository ist mit dem offiziellen Fork neu; erstes Fork-Release am 2026-11-06.

feed #

• Zweck: RSS-1.0-, RSS-2.0- und Atom-Feeds mit ihren Modulen (Dublin Core, content, iTunes ...) lesen und schreiben.
• Verwendung im Kernel:
  • kernel/classes/ezrssexport.php: rssXmlContent() schreibt RSS-1.0-, RSS-2.0- und Atom-Exporte über generateFeed(), das ein ezcFeed aufbaut; Apple Podcasts und OPML schreibt der eigene Code des Kernels;
  • kernel/private/rest/classes/views/feed_decorator.php: Feed-Views der REST-Schicht (ezcFeedEntryElement).
• Funktionen: RSS-Exporte unter /rss/feed/<adresse> (RSS-, Atom- und OPML-Feeds).
• Fork: se7enxweb/expcomponents-feed, Repository, ersetzt zetacomponents/feed. Das Repository ist mit dem offiziellen Fork neu; erstes Fork-Release am 2026-11-06.

image-analysis #

• Zweck: den MIME-Typ und Eigenschaften (Größe, EXIF bei JPEG und TIFF) einer Bilddatei ermitteln.
• Verwendung im Kernel: keine direkte. image-conversion verlangt es, und die Bildeditor-Erweiterung ezie verwendet es (extension/ezie/classes/image_analyzer.php).
• Fork: se7enxweb/expcomponents-image-analysis, Repository, ersetzt zetacomponents/image-analysis. Als Abhängigkeit des Forks von image-conversion installiert, nicht im require des Kernels aufgeführt.

image-conversion #

• Zweck: Filter auf Bilder anwenden (skalieren, zuschneiden, Farben, Effekte) über GD oder ImageMagick.
• Verwendung im Kernel: keine in kernel/ oder lib/; der Kernel verlangt es für ezie, den Bildeditor des Bearbeitungsformulars, der es selbst nicht angibt (extension/ezie/classes/image_converter.php, image_pre_action.php, image_tool_resize.php) (ezie). Die Bildvarianten des Kernels verwenden ihre eigenen Handler von eZImageManager, nicht diese Bibliothek.
• Fork: se7enxweb/expcomponents-image-conversion, Repository, ersetzt zetacomponents/image-conversion. Release 1.5.2 enthält die Änderung des Originals, ImageMagick über die Argumentlisten-Form von proc_open() aufzurufen (keine Shell wertet den Befehl aus), und behebt, was diese Änderung kaputt machte: Skalieren und Zuschneiden mit ImageMagick scheiterten mit „unrecognized option `-resize '“, weil die Filter Optionsnamen mit einem Leerzeichen am Ende übergaben. Die Korrektur ist dem Original als Pull-Request #9 von zetacomponents/ImageConversion angeboten. Das Release zeigt außerdem den Befehl in der Fehlermeldung eines gescheiterten ImageMagick-Aufrufs, scheitert sofort, wenn das Zielverzeichnis nicht beschreibbar ist, weist mit jedem GD-Build ein JPEG ab, für das libjpeg einen Fehler meldet, und gibt unter PHP 8.5 keine Deprecations aus.

mail #

• Zweck: E-Mails erstellen, auswerten und versenden: MIME-Teile, Anhänge, HTML-Mail, SMTP (mit STARTTLS und Authentifizierung), sendmail, IMAP, POP3 und mbox.
• Verwendung im Kernel:
  • lib/ezutils/classes/ezmail.php: eZMail baut jede Nachricht auf ezcMail, ezcMailAddress, ezcMailText und ezcMailPart auf;
  • lib/ezutils/classes/ezsmtptransport.php: eZSMTPTransport sendet über ezcMailSmtpTransport mit ezcMailSmtpTransportOptions; in dieser Bibliothek bedeutet tls STARTTLS;
  • lib/ezutils/classes/ezsendmailtransport.php: der sendmail-Transport;
  • kernel/private/classes/ezpmail.php, kernel/classes/mail/expmailtemplatebody.php (Inhalte aus Templates);
  • kernel/classes/mailpreferences/expmailgate.php (die E-Mail-Schranke) und expmailbouncereader.php (Bounces, aus einem Postfach gelesen mit ezcMailImapTransport oder ezcMailPop3Transport und ezcMailTools).
• Funktionen: jede E-Mail der Site: Benachrichtigungen, Registrierung, Passwort, Formulare, Newsletter über cjw_newsletter (das ezcMail in CjwNewsletterMailComposer erweitert), die E-Mail-Einstellungen und ihre Schranke.
• Fork: se7enxweb/expcomponents-mail, Repository, ersetzt zetacomponents/mail. Das Repository ist mit dem offiziellen Fork neu; erstes Fork-Release am 2026-11-06. Release 1.10.2 enthält die Änderungen des Originals nach 1.10.1, darunter den Schutz vor Header-Injection: Eine Adresse mit Leerraum oder einem der Zeichen < > , ; " wird abgewiesen, bevor ein Header geschrieben wird, Header-Werte, -Namen und Adressen können keine Header mehr hinzufügen, leere Header-Namen und leere Folgezeilen werden abgewiesen, ezcMailTools::validateEmailAddress() nimmt keinen abschließenden Zeilenumbruch mehr an, und Content-IDs sind zufällig. ezpMailMessageIdTest (MI-04, MI-05) prüft den Kernel damit.

mvc-tools #

• Zweck: Auswerten von Anfragen, Routing, Verteilen, Views und das Schreiben von Antworten für eine MVC-Anwendung.
• Verwendung im Kernel: die ganze REST-Schicht in kernel/private/rest/classes/ (Router, Routen, Anfrage-Parser, Controller, Statusobjekte, Views, Antwort-Schreiber, die Schnittstellen der Authentifizierungsstile) und die darauf gebauten REST-Endpunkte: GraphQL (kernel/classes/graphql/rest/), Hilfeinhalte (kernel/classes/help/content/rest/) und Migrationen (kernel/classes/migration/rest/). Die am häufigsten verwendeten Klassen: ezcMvcRequest, ezcMvcResult, ezcMvcRoutingInformation, ezcMvcInternalRedirect, ezcMvcController, ezcMvcResponseWriter, ezcMvcHttpResponseWriter.
• Funktionen: REST-API v1 und v2 mit der Erweiterung ezprestapi.
• Fork: se7enxweb/expcomponents-mvc-tools, Repository, ersetzt zetacomponents/mvc-tools. Das Repository ist mit dem offiziellen Fork neu; erstes Fork-Release am 2026-11-06.

persistent-object #

• Zweck: PHP-Objekte auf Datenbanktabellen abbilden und sie abrufen, speichern und löschen (auf der Datenbankkomponente).
• Verwendung im Kernel: der OAuth-Server: kernel/private/oauth/classes/ (restclient.php, restauthorizedclient.php und die Definitionen der persistenten Objekte in persistentobjects/), die REST-Token und Autorisierungscodes (kernel/private/rest/classes/models/, po_maps/, oauth/utility.php) und die OAuth-Module (kernel/private/modules/oauth/authorize.php, kernel/private/modules/oauthadmin/). Verwendete Klassen: ezcPersistentObjectDefinition, ezcPersistentObjectProperty, ezcPersistentObjectIdProperty. Das eigene eZPersistentObject des Kernels ist eine andere Klasse und verwendet es nicht.
• Fork: se7enxweb/expcomponents-persistent-object, Repository, ersetzt zetacomponents/persistent-object.

signal-slot #

• Zweck: Signale und Slots: Objekte senden benannte Signale, verbundene Callbacks laufen.
• Verwendung im Kernel: kernel/private/classes/ezpcontentpublishingqueue.php: ezpContentPublishingQueue hält eine ezcSignalCollection, verbindet die für die asynchrone Veröffentlichungswarteschlange eingestellten Hooks und sendet preQueue, bevor eine Version in die Warteschlange kommt.
• Fork: se7enxweb/expcomponents-signal-slot, Repository, ersetzt zetacomponents/signal-slot. Das Repository ist mit dem offiziellen Fork neu; erstes Fork-Release am 2026-11-06.

system-information #

• Zweck: Systemwerte lesen: CPU-Typ und -Takt, Speicher, das Betriebssystem, den PHP-Beschleuniger.
• Verwendung im Kernel: kernel/private/classes/views/setup/info.php: Setup > Systeminformationen (/setup/info) liest ezcSystemInfo::getInstance(); lässt sich das Betriebssystem nicht lesen (ezcSystemInfoReaderCantScanOSException), zeigt die Seite keine Systemwerte, und ein Debug-Hinweis wird geschrieben.
• Fork: se7enxweb/expcomponents-system-information, Repository, ersetzt zetacomponents/system-information. Das Repository ist mit dem offiziellen Fork neu; erstes Fork-Release am 2026-11-06.

webdav #

• Zweck: ein WebDAV-Server (RFC 2518 und RFC 4918) mit austauschbaren Backends, Sperren und Authentifizierung.
• Verwendung im Kernel: index_webdav.php im Wurzelverzeichnis der Installation führt ezcWebdavServer mit dem Inhalts-Backend kernel/private/classes/webdav/ezwebdavcontentbackend.php aus (eZWebDAVContentBackend extends ezcWebdavSimpleBackend implements ezcWebdavLockBackend), mit seiner Authentifizierung ezwebdavcontentbackendauth.php und der Pfad-Factory expwebdavpathfactory.php.
• Funktionen: Inhalte als Dateien über WebDAV bearbeiten (WebDAV und SOAP).
• Fork: se7enxweb/expcomponents-webdav, Repository, ersetzt zetacomponents/webdav und se7enxweb/zetacomponents-webdav. Vom Kernel seit 1.2.2 verlangt (~1.2.2, seit 2026-11-06 ~1.2.3). Release 1.2.1 erschien als se7enxweb/zetacomponents-webdav (WebDAV auf PHP 8); Release 1.2.2, das erste unter dem neuen Namen, hält Anfragepfade und das Ziel von COPY und MOVE innerhalb der Wurzel des Backends, folgt keinen symbolischen Links aus ihr heraus, weist Anfragekörper mit einer Dokumenttyp-Deklaration ab, vergleicht die Digest-Authentifizierung in konstanter Zeit und erzeugt zufällige Sperr-Token.

Forks, die der Kernel nicht verlangt #

Eine Erweiterung, die einen davon braucht, verlangt den Fork mit seinem Namen.

Ursprungspakete, die nicht geforkt werden #

Verwandte Seiten #

• Exponential Components (expcomponents)
• Upgrade-Hinweise: der Wechsel zu expcomponents
• Zu expcomponents beitragen
• APIs und Protokolle