Standards für PHP, PHP-FIG und Composer #

Diese Seite richtet sich an Entwickler, die Code für Exponential schreiben oder Extensions dafür paketieren, und an Administratoren, die eine PHP-Version wählen oder mit Composer installieren. Sie beantwortet: Welche PHP-Versionen werden unterstützt und getestet, welche Standardempfehlungen der PHP-FIG (PSRs) befolgt der Code, wie werden Composer und Packagist genutzt, und wie verhalten sich die Versionsnummern von Exponential zu Semantic Versioning. Jede Aussage nennt die Datei, anhand derer sie geprüft wurde.

Zusammenfassung #

Unterstützte PHP-Versionen #

Was es ist. PHP wird von der PHP Group gepflegt; jede Minor-Version erhält zwei Jahre aktiven Support und ein oder zwei Jahre Sicherheitskorrekturen.

Wie Exponential es erfüllt.

• composer.json require: "php": "^7.4 || ^8.0 || ^8.1 || ^8.2 || ^8.3 || ^8.4 || ^8.5 || ^8.6 || ^8.7 || ^8.8". Die Bereiche für 8.6 bis 8.8 sind vorausschauend; diese Versionen gibt es noch nicht, und sie sind nicht getestet.
• PHP 7.4 ist ab 6.0.15 die älteste unterstützte Version, für Websites, die noch nicht auf PHP 8 umziehen können; PHP 8.0 ist wichtig, weil es das Standard-PHP von Red Hat Enterprise Linux 9 ist; siehe Warum Exponential PHP 7.4 unterstützt und Unterstützung für PHP 8.0. PHP-Funktionen, die neuer als 7.4 sind, kommen aus symfony/polyfill-php80 und symfony/polyfill-php81 sowie aus lib/phpcompat.php, das autoload.php nur lädt, wenn PHP_VERSION_ID < 80100. Composer wählt die Erweiterungspakete pro PHP-Version über das Metapaket se7enxweb/exponential-php-floor.
• Exponential Velocity, der Anwendungsserver, läuft ab seinem Release 0.0.4.54 auf PHP 8.0 bis 8.5 und steht mit ~0.0.4.57 in require (bis dahin brauchte es PHP 8.1 und stand nur in suggest).
• Erforderliche PHP-Erweiterungen in composer.json: dom, libxml, mbstring, pcre, json, iconv, reflection, session, spl, simplexml. Datenbank- und Bilderweiterungen stehen in suggest.

Wie es getestet wird (.github/workflows/):

Status: Erfüllt für PHP 8.0 bis 8.5 (PHP 7.4 ohne Support nutzbar).

Bekannte Lücken.

• PHPUnit läuft nicht unter PHP 8.0 (PHPUnit 10 und später brauchen 8.1); 8.0 wird nur durch Syntax, Installation und Bootvorgang abgedeckt.
• phpstan.neon.dist analysiert als PHP 8.1 (phpVersion: 80100), nicht als 8.0.
• Standardverteilung der Extensions gibt die PHP-Anforderung noch mit ^8.1 || ^8.2 ... an; composer.json sagt ^8.0.

Empfehlungen der PHP-FIG (PSRs) #

Was sie sind. Die PHP Framework Interop Group (PHP-FIG) veröffentlicht PHP Standard Recommendations. Der Kernel von Exponential wurde von eZ Publish 4 übernommen, das älter ist als die meisten von ihnen; das Projekt hat sich entschieden, den Codestil dieses Kernels beizubehalten und die Schnittstellen-PSRs nicht zu übernehmen. CONTRIBUTING.md sagt noch „Follow the PSR standards“; die tatsächlich geprüften Regeln sind die von phpcs.xml.dist (siehe Codierstandards).

PSR-1, Basic Coding Standard #

• Dateien beginnen mit dem vollständigen Tag <?php (Generic.PHP.DisallowShortOpenTag in phpcs.xml.dist) und sind UTF-8-kodiert.
• Klassendateien deklarieren Klassen und erzeugen keine Ausgabe; Skripte in bin/php/ sind davon getrennt.
• Klassennamen folgen nicht StudlyCaps: expHelpAudience, eZContentObject, ezpAutoloader beginnen mit einem kleingeschriebenen Präfix.
• Klassenkonstanten sind großgeschrieben (ExponentialSDK::VERSION_MAJOR in lib/version.php). Methoden sind camelCase.
• PSR-1 verlangt, dass Klassen für das Autoloading nach PSR-0 oder PSR-4 in einem Namespace liegen; die Kernel-Klassen sind global.

Status: Teilweise erfüllt.

PSR-2 (veraltet), PSR-12 und PER Coding Style #

phpcs.xml.dist erzwingt bei mehreren Regeln von PSR-12 absichtlich das Gegenteil: ein Leerzeichen innerhalb von Klammern (foo( $a ), if ( $a )), array( ... ) statt [ ... ], öffnende geschweifte Klammern von Funktionen in einer eigenen Zeile (das hat PSR-12 auch, aber zusätzlich für Klassen und nicht für Kontrollstrukturen) und keine Typdeklarationen. Es verwendet einen Sniff von PSR-2 (PSR2.ControlStructures.ControlStructureSpacing) mit geänderten Eigenschaften.

Status: Nicht erfüllt, beabsichtigt.

PSR-4, Autoloading Standard #

• Die composer.json im Wurzelverzeichnis hat keinen Abschnitt psr-4 oder psr-0; ihr autoload führt nur files: ["autoload.php"] auf.
• autoload.php bindet vendor/autoload.php von Composer ein, dessen Klassen-Maps die ezc*-Klassen der expcomponents laden (seit 6.0.15 der Fork der Zeta Components), und registriert ezpAutoloader (die Klassenzuordnungen des Kernels und der Erweiterungen); ezcBase::autoload wird nur registriert, wenn EZCBASE_ENABLED als true definiert ist, was eine Composer-Installation nicht tut.
• Die Klassenzuordnung des Kernels autoload/ezp_kernel.php und die Klassenzuordnung der Extensions (unter var/autoload/) werden von bin/php/ezpgenerateautoloads.php generiert; post-install-cmd und post-update-cmd von Composer führen es aus ("legacy-scripts" in composer.json).
• Etwa 390 Dateien in kernel/ und lib/ deklarieren einen Namespace (zum Beispiel Exponential\Command\Kernel, Exponential\View\Kernel\Content), aber ihre Pfade (etwa kernel/private/classes/commands/clusterpurge.php) bilden den Namespace nicht ab; auch sie werden über die Klassenzuordnung geladen.

Status: Nicht erfüllt. Klassenzuordnungen sind mit jeder Dateistruktur kompatibel, weshalb der Kernel sie verwendet.

Hinweis Führen Sie nach dem Hinzufügen oder Umbenennen einer Kernel-Klasse php bin/php/ezpgenerateautoloads.php -k aus, für eine Klasse einer Extension -e. Eine Klasse, die in der Zuordnung fehlt, wird nicht gefunden.

PSR-3, PSR-6, PSR-7, PSR-11, PSR-14, PSR-15, PSR-16, PSR-17, PSR-18 #

Eine Suche in kernel/, lib/, bin/ und den Extensions im Repository nach Psr\Log, Psr\Http, Psr\Container, Psr\Cache, Psr\SimpleCache, Psr\EventDispatcher, Psr\Clock und Psr\Link fand nichts.

vendor/psr/log ist nur als Abhängigkeit von mongodb/mongodb vorhanden.

Status: Nicht erfüllt (nicht verwendet). Das bedeutet, dass sich Exponential nicht direkt an PSR-basierte Bibliotheken anschließen lässt; dafür ist ein Adapter nötig.

Composer #

Was es ist. Composer ist der Abhängigkeitsmanager für PHP; composer.json folgt seinem veröffentlichten JSON-Schema.

Wie Exponential es erfüllt.

• composer validate --no-check-all --no-check-lock --no-check-publish gibt für das Repository ./composer.json is valid aus (für diese Seite ausgeführt).
• name: se7enxweb/exponential, type: ezpublish-legacy (der Typ, den das Legacy-Installer-Plugin versteht), license: GPL-2.0-or-later (ein SPDX-Bezeichner).
• require legt jede Extension se7enxweb/* mit einer Tilde-Beschränkung fest (~6.0.28, ~1.4.43, ~1.0.0.50): Die letzte Stelle ist variabel, die Stellen darüber nicht.
• require-dev: phpunit/phpunit ^9.6 || ^10.5 || ^11.5 || ^12.0 || ^13.4, sonst nichts.
• extra.branch-alias: "dev-main": "6.0.x-dev", sodass Pakete, die se7enxweb/exponential: ^6.0.14 verlangen, gegen main aufgelöst werden können. Die CI setzt aus demselben Grund COMPOSER_ROOT_VERSION=dev-main.
• config.allow-plugins erlaubt nur die Legacy-Installer-Plugins.
• composer.lock wird nicht committet (.gitignore); jede Installation löst aus den Beschränkungen auf.
• Die Entwicklungswerkzeuge (PHP_CodeSniffer, PHPCompatibility, PHPStan) stehen in einer separaten composer.dev.json und werden mit make devtools in .devtools/ installiert, nie in vendor/. Ihr config.platform.php ist 8.0.30.

Status: Erfüllt.

Packagist #

Was es ist. Packagist.org ist das öffentliche Standard-Repository von Composer.

Wie Exponential es erfüllt.

• Das Wurzelpaket se7enxweb/exponential ist auf Packagist gelistet (seine p2-Metadaten antworteten am 18.10.2026).
• Für das GitHub-Repository ist ein Packagist-Webhook konfiguriert, sodass ein gepushter Tag Packagist erreicht (am 18.10.2026 über die GitHub-API geprüft).
• Die Push-Prüfung kontrolliert, dass jede Beschränkung se7enxweb/* in composer.json zu einem Release passt, das Packagist bereits listet, bevor composer update in der CI daran scheitern würde (Continuous Integration, „Die lokalen Prüfungen und die CI“).

Status: Erfüllt.

Warnung Packagist liest einen Tag einmal. Ein Tag, der verschoben wird, nachdem Packagist ihn gelesen hat, erzeugt zwei verschiedene Pakete mit derselben Version. Siehe Versionsverwaltung und Releases.

Semantic Versioning #

Was es ist. Semantic Versioning 2.0.0 (semver.org) definiert MAJOR.MINOR.PATCH: genau drei Zahlen, mit der Bedeutung jeder Erhöhung.

Wie die Versionen von Exponential funktionieren.

• Der Kernel wird als 6.0.x versioniert: lib/version.php (ExponentialSDK, VERSION_MAJOR = 6, VERSION_MINOR = 0, VERSION_RELEASE = 15) und die Tags ab v6.0.0. 6.0.15 ist die aktuelle Linie (Changelog 6.0.15). Neue Funktionen landen in Patch-Releases der Linie 6.0, was nicht der Absicht von SemVer für PATCH entspricht.
• Extensions verwenden drei oder vier Stellen: exp_adminui ~1.0.0.50, bcgooglesitemaps ~1.1.6.6, expai ~0.0.1.18 und Exponential Velocity 0.0.4.x. Eine vierteilige Nummer ist kein gültiges SemVer 2.0.0, aber Composer akzeptiert bis zu vier numerische Stellen und vergleicht jede numerisch.
• Die letzte Stelle zählt weiter. Nach 0.0.4.9 kommt 0.0.4.10, nie 0.0.5.0 (Leitfaden zu Extensions, „Veröffentlichen“; Changelog von Velocity). Das Erhöhen einer höheren Stelle ist eine eigene Entscheidung darüber, was das Release bedeutet.
• Tags sind dauerhaft: Auf ein fehlerhaftes Release folgt ein neues, es wird nie neu erstellt.

Status: Teilweise erfüllt. Versionen sind geordnet und unveränderlich, und Composer behandelt sie korrekt, aber vierteilige Nummern und neue Funktionen in Patch-Releases liegen außerhalb von SemVer 2.0.0.

Hinweis Sortieren Sie Tags nach Version, nicht nach Name: git tag -l 'v*' --sort=version:refname. Nach Name sortiert steht 0.0.4.10 vor 0.0.4.8.

Bekannte Lücken #

1. Kein Autoloading nach PSR-4; neue Klassen brauchen den Autoload-Generator.
2. Keine Schnittstellen von PSR-3, PSR-7, PSR-11, PSR-14 oder den Caching-PSRs; die Integration einer PSR-basierten Bibliothek braucht einen Adapter.
3. CONTRIBUTING.md verlangt „the PSR standards“ und verlinkt CODING_STYLE.md, das im Repository nicht existiert.
4. PHPUnit läuft nicht unter PHP 8.0; PHPStan analysiert als PHP 8.1.
5. Vierteilige Versionsnummern sind kein SemVer 2.0.0.
6. Die Beschränkung php nennt PHP-Versionen (8.6 bis 8.8), die nicht getestet sein können.

Verwandte Seiten #

• Unterstützung für PHP 8.0
• Unterstützung für PHP 8
• Codierstandards
• Tests und Continuous Integration
• Versionsverwaltung und Releases
• Entwickeln mit Git