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

Ein Rundgang durch den Quellbaum

Jedes Verzeichnis der obersten Ebene und jeder Einstiegspunkt eines Exponential-Checkouts aus der Sicht eines PHP-Entwicklers - wo der Kernel, die Bibliotheken, die Befehle, die Einstellungen, die Tests und die…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/php-developers/a-tour-of-the-source-tree.md

On this page

This page is a translation. Read the English original

Ein Rundgang durch den Quellbaum

Diese Seite richtet sich an PHP-Entwickler, die zum ersten Mal einen Exponential-Checkout öffnen. Sie geht die Verzeichnisse und Einstiegspunkte im Wurzelverzeichnis durch, sagt, was wo liegt und welche Orte generiert werden oder zur Installation statt zum Code gehören.

Warnung .htaccess bremst jede Anfrage. Sind .htaccess-Dateien erlaubt (AllowOverride alles außer None), geschweige denn genutzt, sucht Apache sie bei jeder Anfrage in jedem Verzeichnis des Pfads und liest und wertet sie aus, und die Ladezeiten der Seiten steigen drastisch (gemessen). Die einzige wirkliche Abhilfe ist, die Funktion für den virtuellen Host abzuschalten: AllowOverride None im virtuellen HTTPS-Host, und die Regeln in der Konfiguration des virtuellen Hosts selbst als mod_rewrite-Regeln. Das ist in Geschwindigkeitstests im Produktivbetrieb weit schneller und die Zeit für die Optimierung einer Produktivkonfiguration unbedingt wert. Stellen Sie sofort um: Übernehmen Sie die Regeln des Beispiels für einen virtuellen HTTPS-Host in Ihren virtuellen Host (mit dem statischen Cache auch staticcache_offload.conf), setzen Sie AllowOverride None, führen Sie apachectl configtest aus, laden Sie Apache neu und testen Sie die Website. Dieselben Regeln für andere Server: nginx, LiteSpeed, Caddy, IIS, Velocity (eingebaut); wohin Regeln für virtuelle Hosts in einem Control Panel gehören: Plesk, cPanel, DirectAdmin, ISPConfig. Unter LiteSpeed oder OpenLiteSpeed kann zusätzlich der Seiten-Cache des Servers anonyme Besucher und Crawler ohne PHP bedienen: Seiten-Caching mit LiteSpeed und OpenLiteSpeed.

Inhalt

  1. Die Einstiegspunkte
  2. Code-Verzeichnisse
  3. In kernel/
  4. In lib/
  5. Konfiguration und generierte Dateien
  6. Qualität und Tests
  7. Was Sie ändern und was Sie in Ruhe lassen

Die Einstiegspunkte

DateiFührt aus
index.phpjede Webseite: Wartungsprüfung, autoload.php, dann new ezpKernel( new ezpKernelWeb() ) und run()
index_rest.phpdie REST-API
index_treemenu.phpdas Inhaltsbaum-Menü der Administration
index_cluster.phpdie Auslieferung geclusterter Binärdateien
bin/php/*.phpKommandozeilenskripte; ein Dispatcher, bin/php/console, führt sie alle als exp:<name> aus
runcronjobs.phpCronjob-Teile (php runcronjobs.php frequent)
index_soap.php, index_webdav.phpdie SOAP- und WebDAV-Server (soap.php und webdav.php leiten nur dorthin weiter, bis zu einer späteren Hauptversion)

Jeder PHP-Einstiegspunkt beginnt mit autoload.php. Es definiert EXP_ROOT_DIR (das Wurzelverzeichnis der Installation, ein absoluter Pfad), lädt unter PHP älter als 8.1 lib/phpcompat.php, entscheidet über das Engine-Archiv und registriert den Klassen-Map-Autoloader (Wie eine Anfrage in PHP abläuft).

Ein Beispiel dafür, wie ein Konsolenbefehl aus diesen Teilen gebaut ist: die Befehle, die .htaccess und config.php an ihren Platz bringen (.htaccess und config.php von der Konsole aus einrichten).

DateiRolle
bin/php/setupfiles.php, bin/php/configphp.phpdie Skripte hinter exp:setupfiles (exp:setup:status, exp:setup:htaccess, exp:setup:config) und exp:configphp (exp:config:list, get, set, unset); sie laufen auch ohne die Konsole
kernel/private/classes/commands/setupfiles.php, configphp.phpdie Klassen der Konsolenbefehle
kernel/classes/expsetupfilecopy.phpdas sichere Kopieren: Probelauf, Diff, Sicherung nach var/backup/, atomares Schreiben, Modus und Eigentümer
kernel/classes/expconfigphpeditor.phpliest config.php als PHP-Tokens und ändert ein define() nach dem anderen, geprüft mit php -l
kernel/classes/expconfigphpcatalogue.phpdie Liste der beschriebenen Einstellungen, gelesen aus den Kommentaren von config.php-RECOMMENDED
tests/tests/kernel/private/classes/commands/expSetupFilesAndConfigPhpCommandsTest.phpihre Tests

Code-Verzeichnisse

VerzeichnisEnthältNamespaces und Präfixe
kernel/das CMS: Module, Inhaltsmodell, Benutzer, Rollen, Workflows, Setup, den Anfrage-KernelKlassen eZ*, ezp*, exp*; Exponential\... für Runnables
lib/allgemeine Bibliotheken, auf denen der Kernel aufbauteZ*, ezp*, exp*
extension/mitgelieferte Erweiterungen und Ihre eigenendas eigene Präfix jeder Erweiterung
cronjobs/die Cronjob-Teil-Dateien des Kernels (cronjobs/workflow.php ...)schlanke Dateien, die Exponential\Cronjob\Kernel\... aufrufen
design/die Designs des Kernels: standard, base, admin, admin3, admin4, admin4l, editor, plain ...Templates, Stylesheets, Bilder
update/Datenbank-Update-Skripte und SQL je Engine (update/database/sqlite/, postgresql/, mysql/)
share/share/filelist.md5 und andere mitgelieferte Daten
schemas/, templates/, support/XML-Schemata, mitgelieferte Templates für Pakete, Hilfsdateien

In kernel/

Die meisten Verzeichnisse der obersten Ebene von kernel/ sind Module: kernel/content/, kernel/user/, kernel/setup/, kernel/role/, kernel/workflow/, kernel/shop/ und weitere. Jedes enthält eine module.php, seine Views und oft eine function_definition.php für Fetch-Funktionen. Zwei Verzeichnisse sind keine Module:

VerzeichnisEnthält
kernel/classes/das Inhaltsmodell und die Dienste: eZContentObject, eZContentObjectTreeNode, eZPersistentObject, eZDataType und die Datentypen in kernel/classes/datatypes/, Workflow-Typen, das Hilfesystem (kernel/classes/help/), die Debug-Leiste (kernel/classes/debugbar/)
kernel/private/classes/den Anfrage-Kernel (ezpkernel.php, ezpkernelweb.php), ezpEvent und die Runnable-Klassen: commands/, cronjobs/, views/, services/, runnable/
kernel/common/gemeinsame Hilfsmittel, zum Beispiel ezpI18n und überall genutzte Template-Operatoren
kernel/sql/das Datenbankschema des Kernels je Engine

In lib/

BibliothekHauptklassen
lib/ezutils/eZINI, eZDebug, eZDebugSetting, eZSys, eZHTTPTool, eZExecution, eZCLI, eZURI, eZExtension, der Bericht der Debug-Leiste
lib/ezdb/eZDB und die Treiber (eZSQLite3DB, eZPostgreSQLDB, eZMySQLiDB, expMongoDB), der SQL-Abfrage-Cache
lib/eztemplate/die Template-Engine (eZTemplate), ihr Compiler und die eingebauten Operatoren
lib/ezfile/Dateien, Verzeichnisse, eZLog
lib/ezi18n/, lib/ezlocale/Übersetzung und Gebietsschema
lib/ezdbschema/Schemabehandlung und .dba-Dateien
lib/ezsession/Sitzungen
lib/phpcompat.phpFunktionen, die neuer als PHP 8.0 sind, nur definiert, wenn PHP sie nicht hat
lib/version.phpdie Release-Nummer

Konfiguration und generierte Dateien

PfadWas es istIn git
settings/*.inidie Standardeinstellungen des Kernelsja
settings/override/, settings/siteaccess/die eigenen Einstellungen der Installation; können Geheimnisse enthaltennein (Installation)
config.phpKonstanten für diese Installation (aus config.php-RECOMMENDED; exp:setup:config kopiert sie, exp:config:* bearbeitet sie)nein
.htaccessdie Regeln für Apache und LiteSpeed (aus .htaccess_root oder .htaccess_root_static; exp:setup:htaccess kopiert sie)nein (Installation)
var/backup/setup/, var/backup/config/die Kopien, die exp:setup:* und exp:config:* von jeder Datei aufbewahren, die sie ersetzen oder bearbeitennein
config.env.phpEXP_ENV, der Umgebungsname dieser Maschine (aus config.env.php.example)nein
autoload/ezp_kernel.phpdie Klassen-Map des Kernelsja
var/autoload/ezp_extension.php, ezp_override.php, ezp_tests.phpgenerierte Klassen-Mapsnein
var/cache/, var/log/, var/<site>/Caches, Logs, Speichernein
vendor/Composer-Paketenein
dist/engine.phardas optionale Engine-Archivnein (dist/ wird ignoriert)

Qualität und Tests

PfadZweck
phpunit.xml, tests/bootstrap.php, tests/tests/PHPUnit-Konfiguration, Bootstrap und die Tests
tests/test-map.jsonwelche Tests welche Quelldateien abdecken
tests/runtests.phpder ältere Runner für Datenbanktests (--dsn ... --db-per-test)
tests/bin/bootsmoke.phpder Boot-Smoke-Test, den die CI unter PHP 8.0 ausführt
phpcs.xml.dist, bin/phpcs/der Code-Stil und die eigenen Sniffs des Projekts
phpstan.neon.dist, phpstan-baseline.neonstatische Analyse auf Level 1 mit ihrer Baseline
Makefile, .githooks/, composer.dev.jsondie make-Ziele, die Git-Hooks und die Entwicklungswerkzeuge
.github/workflows/CI: Quality, PHPUnit, Performance, CI health

Was Sie ändern und was Sie in Ruhe lassen

  • Ihre Arbeit gehört in fast jedem Fall in eine Erweiterung. Der Kernel wird nur für Kernel-Korrekturen und Funktionen geändert, die Sie zurückgeben (PHP-Änderungen beitragen).
  • Bearbeiten Sie niemals generierte Dateien (var/autoload/*, Caches); generieren Sie sie neu.
  • Committen Sie niemals Installationsdateien: settings/override/, config.php, config.env.php, var/. Tragen Sie in einem eigenen Projekt-Repository /config.php in dessen .gitignore ein: Die Datei kann das Passwort der Cluster-Datenbank enthalten.
  • Bearbeiten Sie niemals vendor/; von Composer installierte Erweiterungen können in manchen Installationen lebendige Git-Checkouts sein, und Composer würde sie ersetzen.

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