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: einen Request einer Site zuordnen

Der Siteaccess ist das Konzept, das Framework-Entwickler am häufigsten übersehen - eine benannte Konfiguration, die pro Request anhand von URI, Host, Port oder Servervariable vor dem Routing ausgewählt wird - wie die…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/web-framework-developers/siteaccesses-hosts-and-tenants.md

On this page

This page is a translation. Read the English original

Siteaccesses: einen Request einer Site zuordnen

Diese Seite richtet sich an Entwickler, die eine Anwendung mit genau einer Konfiguration erwarten. Exponential beantwortet jeden Request im Kontext eines Siteaccess: einer benannten Konfiguration wie site, admin, ger oder eng, die vor dem Routing ausgewählt wird. Die Administration ist ein Siteaccess, jede Sprachversion einer Site ist in der Regel einer, und mehrere Sites auf einer Datenbank sind mehrere Siteaccesses.

Inhalt

  1. Was ein Siteaccess verändert
  2. Wie ein Request zugeordnet wird
  3. Die Zuordnungsarten
  4. Im Vergleich mit anderen Frameworks
  5. Den Siteaccess im Code auslesen
  6. Praktische Regeln

Was ein Siteaccess verändert

Ein Siteaccess hat ein eigenes Einstellungsverzeichnis, settings/siteaccess/<name>/, und jede Einstellung darin überschreibt für Requests dieses Siteaccess den globalen Standardwert (Konfiguration). Typische Unterschiede:

EinstellungBeispiel
Design und Template-Overridesdas öffentliche Design für site, ein Administrationsdesign für admin
Sprachensite.ini [RegionalSettings] mit den Sprachen der Site, sodass ger deutsche Inhalte zeigt
Inhaltswurzel und Baummenüwelcher Knoten die Startseite ist
Erweiterungensite.ini [ExtensionSettings] ActiveAccessExtensions[]: Erweiterungen, die nur für diesen Siteaccess aktiv sind
Anmeldung[SiteAccessSettings] RequireUserLogin: die Administration verlangt eine Anmeldung, eine öffentliche Site nicht
Caches und ProtokollePfade pro Site (Protokoll- und Cache-Pfade bei mehreren Sites)

Wie ein Request zugeordnet wird

site.ini [SiteAccessSettings] MatchOrder listet die Prüfungen auf, die der Reihe nach versucht werden; der ausgelieferte Wert ist uri;host;port. Die erste Prüfung, die einen in AvailableSiteAccessList[] aufgeführten Siteaccess ergibt, gewinnt. eZSiteAccess::match() erledigt das im Konstruktor des Kernels, und eZSiteAccess::change() wechselt zum Ergebnis (Der Request-Lebenszyklus).

# settings/override/site.ini.append.php (a sketch: hosts and names are examples)
<?php /*
[SiteAccessSettings]
AvailableSiteAccessList[]=site
AvailableSiteAccessList[]=admin
MatchOrder=host;uri
HostMatchType=map
HostMatchMapItems[]=www.example.com;site
HostMatchMapItems[]=admin.example.com;admin
*/ ?>

Die Zuordnungsarten

PrüfungEinstellungenOrdnet zu nach
uriURIMatchType (ausgeliefert element, map, text, regexp, disabled), URIMatchElement, URIMatchMapItems[]dem ersten Pfadsegment: example.com/admin/...
hostHostMatchType (ausgeliefert map, element, text, regexp), HostMatchMapItems[], HostMatchMethoddem Hostnamen: admin.example.com
host_uriHostUriMatchMapItems[]=host;uri;siteaccess[;method]Host und Pfad zusammen: example.com/ger
portdie Port-Einträge von [SiteAccessSettings]einer Portnummer
servervareine vom Webserver gesetzte Servervariableeinem Wert, den der Webserver bestimmt

Wenn keine Prüfung greift, kann DefaultHostUriMatchMapItems[] den Siteaccess anhand des Hosts und der vom Browser akzeptierten Sprachen auswählen, mit einer einzigen Weiterleitung auf die Sprachadresse (Host- und Sprachzuordnung von Siteaccesses).

Im Vergleich mit anderen Frameworks

FrameworkNächstes KonzeptUnterschied
SymfonyHost-Anforderungen an Routen, ein Request-Listener, der die Mandantenkonfiguration lädtein Siteaccess ändert die gesamte Konfiguration einschließlich Design und aktiver Erweiterungen, nicht nur die Routen
LaravelDomain-Routengruppen, Pakete für Mandantenfähigkeitin den Kernel und das Einstellungssystem eingebaut
Djangodas Sites-Framework (SITE_ID)pro Request gewählt, nicht pro Prozess
RailsConstraints an Routen, mehrere Engineseine Datenbank kann mehrere Siteaccesses gleichzeitig bedienen
SpringProfileein Profil gilt pro Prozess, ein Siteaccess pro Request

Siteaccesses sind keine Umgebungen: Die Umgebung der Maschine (Entwicklung, Test, Produktion) ist EXP_ENV (Umgebungen und Geheimnisse).

Den Siteaccess im Code auslesen

$access = eZSiteAccess::current();      // array with 'name' and the match details, or null
$name = $access ? $access['name'] : null;

Ermitteln Sie den aktuellen Siteaccess über eZSiteAccess::current(), statt die URL selbst zu zerlegen (Siteaccess). In Templates enthält $access_type.name den Namen. Links, die mit dem Operator ezurl erzeugt werden, erhalten bei URI-Zuordnung das Siteaccess-Präfix; schreiben Sie in Templates daher niemals absolute Pfade von Hand.

Praktische Regeln

  • Geben Sie jedem Siteaccess nur die Einstellungen, die sich unterscheiden; gemeinsame Einstellungen gehören in eine Erweiterung oder nach settings/override/.
  • Kommandozeilenskripte brauchen -s <siteaccess>, wenn sie von Siteaccess-Einstellungen oder Siteaccess-Erweiterungen abhängen.
  • Eine Einstellung, die nur für einen Siteaccess gelten soll, darf nicht im globalen Verzeichnis settings/ einer Erweiterung liegen: Einstellungen von Erweiterungen werden nach settings/siteaccess/ gelesen und haben Vorrang (Platzierung von INI-Overrides).

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