Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,090 of 9,090 pages
About the help in other languages
All help pages

Siteaccesses und Konfiguration

Wie Exponential konfiguriert wird - INI-Dateien, über eZINI gelesen, die Reihenfolge, in der sich Override-Verzeichnisse durchsetzen, Siteaccess-Zuordnung, Varianten je Umgebung mit EXP_ENV, Konfiguration, die die…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/software-engineers/siteaccesses-and-configuration.md

On this page

This page is a translation. Read the English original

Siteaccesses und Konfiguration

Diese Seite richtet sich an Ingenieure, die über Konfiguration nachdenken müssen: woher ein Wert kommt, warum er sich zwischen zwei Websites einer Installation unterscheidet und wie Geheimnisse und rechnerspezifische Werte aus der Versionsverwaltung herausbleiben. Die vollständige Referenz ist Die Kaskade der INI-Einstellungen und INI-Override-Verzeichnisse und Platzierungen.

Inhalt

  1. INI-Dateien und eZINI
  2. Die Reihenfolge der Kaskade
  3. Siteaccesses
  4. Umgebungen, Bereitstellungen und Geheimnisse
  5. Herausfinden, woher ein Wert kommt
  6. Regeln für Konfigurationsänderungen

INI-Dateien und eZINI

Die gesamte Konfiguration besteht aus INI-Dateien, die über eZINI (lib/ezutils/classes/ezini.php) gelesen werden. Die Standards werden in settings/<file>.ini mitgeliefert; Overrides heißen <file>.ini.append.php (das Suffix .php verhindert, dass sie als Text ausgeliefert werden). Code liest einen Wert so:

$value = eZINI::instance( 'site.ini' )->variable( 'SiteSettings', 'SiteName' );

Kein Code in kernel/, lib/ oder bin/ parst INI-Dateien selbst. Das zusammengeführte Ergebnis wird als PHP-Arrays im INI-Cache zwischengespeichert; leeren Sie ihn nach einer Einstellungsänderung mit dem Tag, der sowohl den INI-Cache je Siteaccess als auch den globalen abdeckt:

php bin/php/ezcache.php --clear-tag=ini --allow-root-user

Die Reihenfolge der Kaskade

Später gewinnt:

ReihenfolgeGeltungsbereichVerzeichnisse
0Standardssettings/<file>.ini
1sa-extensionextension/<ext>/settings/ der Erweiterungen in ActiveAccessExtensions[] des Siteaccess
2siteaccessVerzeichnisse je Siteaccess innerhalb von Erweiterungen (extension/<ext>/settings/siteaccess/<sa>/, settings/override__<group>/, settings/override/), danach settings/siteaccess/<sa>/
3extensionextension/<ext>/settings/ der Erweiterungen in ActiveExtensions[] (die zuerst genannte gewinnt)
4overridesettings/override/

Zwei Folgen, über die Ingenieure stolpern:

  • settings/ einer Erweiterung in ActiveExtensions[] setzt sich gegen settings/siteaccess/<sa>/ durch; das einer Erweiterung in ActiveAccessExtensions[] nicht.
  • settings/override/ setzt sich gegen alles durch.

Erweiterungen werden in site.ini [ExtensionSettings] ActiveExtensions[] (global) und ActiveAccessExtensions[] (je Siteaccess) eingeschaltet; diese beiden lassen sich nicht innerhalb einer Erweiterung setzen. Die Reihenfolge der Erweiterungen kann ihren deklarierten Abhängigkeiten folgen (Ladereihenfolge der Erweiterungen).

Siteaccesses

Ein Siteaccess ist eine benannte Konfiguration, die je Anfrage gewählt wird: eine öffentliche Website, die Administration, eine Sprachfassung. eZSiteAccess (kernel/classes/ezsiteaccess.php) ordnet ihn anhand von site.ini [SiteAccessSettings] zu:

EinstellungZweck
MatchOrderdie versuchten Zuordnungsarten, mitgeliefert uri;host;port
AvailableSiteAccessList[]nur diese Siteaccesses werden zugeordnet
RelatedSiteAccessList[]verwandte Siteaccesses mit derselben Datenbank
HostMatchMapItems[]Hostname zu Siteaccess
AnonymousAccessList[]Module oder Modul-Views, die auf einem Siteaccess, der sonst eine Anmeldung verlangt, keine brauchen (user/register, csp/report ...)

Code nimmt den aktuellen Siteaccess aus eZSiteAccess::current() und parst die URL nie selbst. Zuordnung nach Host und Sprache: Siteaccess-Zuordnung nach Host und Sprache.

Umgebungen, Bereitstellungen und Geheimnisse

BedarfMechanismus
Unterschiedliche Werte auf einem Entwicklerrechner, einer Testkopie und der Live-WebsiteEXP_ENV in config.env.php (aus config.env.php.example) und Variantendateien wie settings/override/site.ini.test.append.php (Einstellungen je Umgebung)
Konfiguration, die nur die Versionsverwaltung ändern darf[ConfigurationSettings] ManagedByDeployment=enabled je Siteaccess: Die Administration schreibt keine Einstellungen, Templates oder Pakete mehr auf dem Server (Konfiguration, die die Bereitstellung verwaltet)
Geheimnisse (Datenbankpasswörter, API-Schlüssel, Signaturschlüssel)settings/override/, das nie committet wird; config.env.php steht in .gitignore
Mehrere Websites in einer InstallationEinstellungen je Website innerhalb von Erweiterungen (Installationen mit mehreren Websites)

Herausfinden, woher ein Wert kommt

./console exp:ini where site.ini/SiteSettings/SiteName
./console exp:ini get site.ini/SiteSettings/SiteName

where listet jede Datei, die den Wert setzt, in Ladereihenfolge, und den geltenden Wert; exp:ini setzt, ergänzt und entfernt außerdem Werte in einem gewählten Geltungsbereich (exp:ini). Auf einer laufenden Installation zeigt die Administration die zusammengeführten Einstellungen unter Setup (Die Einstellungsseite).

Regeln für Konfigurationsänderungen

  • Eine neue Einstellung erhält ihren Standard in der mitgelieferten settings/<file>.ini mit einem Kommentar darüber, einem sicheren Standardwert, einem Abschnitt auf ihrer Funktionsseite und einer Zeile im Changelog.
  • Neue Schalter verwenden enabled/disabled.
  • Einstellungen werden mit ./console exp:ini oder eZINI::save() geschrieben, nie durch Zeichenersetzung in einem Skript.
  • Eine neue Klasse, auf die eine mitgelieferte INI-Datei verweist, sollte im Kernel mit class_exists() abgesichert werden, weil ein Velocity-Worker, der vor der Bereitstellung gestartet wurde, sie nicht kennt (Eine Änderung bereitstellen).

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