abstract class Web extends Assembly

Implementierung einer Web-Anwendung

Diese Klasse kapselt alle Informationen und Methoden einer Webanwendung. Die Klasse ist abstrakt und muss von einer konkreten Anwendung überschrieben werden.

Constants

DEFAULTSTORAGEHANDLER

Klassenname des Default-Handlers

DEFAULTSTORAGEINDEXHANDLER

Klassenname des Default-Handlers dex Indexers

UUID

Default UUID dieser Klasse

DEFAULT_NAME

Name der Default-Konfigurationsdatei

PLACEHOLDER_CONFIGPATH

Mapping der Methode Alvine\Application\Assembly::getPlaceholderMap

PLACEHOLDER_DEFAULTPATH

Mapping der Methode Alvine\Application\Assembly::getPlaceholderMap

PLACEHOLDER_ASSETSPATH

Mapping der Methode Alvine\Application\Assembly::getPlaceholderMap

PLACEHOLDER_BASEPATH

Mapping der Methode Alvine\Application\Assembly::getPlaceholderMap

PLACEHOLDER_LICENCEPATH

Mapping der Methode Alvine\Application\Assembly::getPlaceholderMap

PLACEHOLDER_DATAPATH

Mapping der Methode Alvine\Application\Assembly::getPlaceholderMap

PLACEHOLDER_CUSTOMISATIONPATH

Mapping der Methode Alvine\Application\Assembly::getPlaceholderMap

PLACEHOLDER_REPOSITORYPATH

Mapping der Methode Alvine\Application\Assembly::getPlaceholderMap

PLACEHOLDER_VENDORPATH

Mapping der Methode Alvine\Application\Assembly::getPlaceholderMap

PLACEHOLDER_RESOURCEPATH

Mapping der Methode Alvine\Application\Assembly::getPlaceholderMap

PLACEHOLDER_LOGPATH

Mapping der Methode Alvine\Application\Assembly::getPlaceholderMap

PLACEHOLDER_TEMPPATH

Mapping der Methode Alvine\Application\Assembly::getPlaceholderMap

PLACEHOLDER_APPLICATIONID

Mapping der Methode Alvine\Application\Assembly::getPlaceholderMap

PLACEHOLDER_LANGUAGE

Mapping der Methode Alvine\Application\Assembly::getPlaceholderMap

Properties

protected Facility $facility from Assembly
protected Node $configuration from Assembly
protected Directory $defaultPath Im default-Verzeichnis liegen die Standard-Konfigurationsdateien. from Assembly
protected Directory $basePath Der Basispfad der Anwendung from Assembly
protected Directory $vendorPath from Assembly
protected Directory $dataPath from Assembly
protected Directory $customisationPath from Assembly
protected Directory $assetPath Unter Assets werden Mediadateien wie Grafiken oder CSS-Dateien abgelegt. from Assembly
protected Directory $classPath Der Klassenpfad der Anwendung from Assembly
protected Directory $configPath Im config-Verzeichnis liegen die Konfigurationsdateien der Anwendung Dieser Pfad zeigt auf die Konfiguration der Facility. from Assembly
protected Directory $logPath from Assembly
protected Directory $licensePath Lizenzdateien from Assembly
protected Directory $repositoyPath Speicherort für Objekte from Assembly
protected Directory $resourcePath Resourcen from Assembly
static protected ObjectMap $instance Einzige Objektinstanz (singelton) der Anwendung from Assembly
static protected CacheManager $cacheManager from Assembly
protected View $view from Assembly
protected Examiner $cacheExaminer from Assembly
protected EventQueue> $eventQueues from Assembly
protected Locale $locale from Assembly
protected Manager $storageManager from Assembly
protected SMTPClient $defaultSmtpClient from Assembly
protected Session $session
protected Directory $webPath
protected Directory $errorPath
protected Directory $jsPath
protected Directory $themePath
protected Directory $publicVendorPath
protected Directory $w3cPath
protected URI $baseURI
protected Request $request
protected Route $router
protected Identity $identity
protected Authority> $authorities
protected Cookie> $cookies
protected string $requestID

Methods

__construct(Facility $facility)

Neues Anwendugs-Objekt erstellen.

__destruct()

Anwendung beenden

initEventQueues()

Eventqueues

from Assembly
EventQueue
getEventQueue(Event $class)

Eventqueue für Event holen und wenn noch nicht vorhanden anlegen

from Assembly
subscribeEvent(Subscriber $subscriber, string $eventClass)

Event abonnieren

from Assembly
unsubscribeEvent(Subscriber $subscriber, string $eventClass)

Abmelden

from Assembly
triggerEvent(Event $event)

Event Triggern

from Assembly
bool
shouldBeCached()

Soll die Anwendung cachen

from Assembly
Locale
getLocale()

Lokale der Anwendung

from Assembly
static Assembly
execute(Facility $facility)

Programm ausführen

from Assembly
static Assembly|null
getInstance(string $assemblyClass = null)

Instanz ermitteln. Wird keine Instanzklasse angegeben, so wird das aktuelle Objekt in der Instanz-Map verwendet.

from Assembly
boolean|Assembly
validateInstanceCache()

Meßwerte überprüfen

from Assembly
initCacheExaminer()

Instanzprüfung erweitern

boolean
isInstanceValide()

Gültigkeit prüfen

from Assembly
static 
refresh(string $assemblyClass)

Anwendungsklasse aktualisieren

from Assembly
static CacheManager
getCacheManager()

AppCache zur Beschleunigung von Anfragen

from Assembly
loadConfig()

Konfiguration laden

from Assembly
Map
getPlaceholderMap()

Standardplatzhalter der Anwendung

Directory
getCustomisationPath()

CustomisationPath

from Assembly
Directory
getDataPath()

Daten

from Assembly
string
replaceEnvironmentPlaceholder(string $string)

Standardplatzhalter der Anwendung

from Assembly
initDirectories()

Setzt den Basispfad und alle abgeleiteten Pfade

Assembly
initSMTPClient()

Mailclient initialisieren

from Assembly
SMTPClient|null
getDefaultSmtpClient()

SMTP-Client

from Assembly
Assembly
initLogger()

Logging initialisieren

from Assembly
getConfiguration()

Konfiguration zurückgeben

from Assembly
string
getConfigurationValue(string $key, string $default = null)

Diese Methode liest einen Konfigurationswert aus.

from Assembly
$this
initPersistenceManager()

Instanz des Storage-Manager holen und Referenz in der Anwendung speichern

from Assembly
initStorage()

Initialisiert die Struktur für den Objektspeicher.

from Assembly
initStorageIndex()

Initialisiert die Struktur für den StorageIndex.

from Assembly
registerStorage(string $className, ObjectStorage $storage)

Ein Storageobjekt registrieren.

from Assembly
unregisterStorage(string $className)

Registrierung für eine Klasse aufheben

from Assembly
Alvine
getObject(string $className, string $id)

Objekt aus dem Storage auslesen

from Assembly
Subset
findObject(string $className, Query $query)

Nach einem Objekt suchen

from Assembly
ObjectStorage
getPersistenceHandler(string $className, string $mode)

Handler für den entsprechenden Speichertyp

from Assembly
Manager
getStorageManager()

Storage-Manager

from Assembly
deleteObject(Alvine $object)

Objekt aus dem Storage löschen

from Assembly
writeObject(Alvine $object)

Objekt in den definierten Speicher schreiben

from Assembly
string
getHashCode()

Diese Methode berechnet einen eindeutigen Wert für eine Anwendung. Da jede Anwendung nur eine Instanz haben kann, muss dieser Wert nur zu Klasse hin eindeutig sein.

from Assembly
init()

Initialisierung der Anwendung

finalize()

Finalisierung

Application
handleTasks()

Abarbeiten der in der Config definierten Tasks

from Assembly
Application
setView(View $view)

Neues View setzen

getView()

View

from Assembly
Directory
getRepositoyPath()

Speicherort für Daten

from Assembly
Directory
getVendorPath()

Verzeichnis für Fremdanbieterdateien aus dem Backend

from Assembly
Directory
getLicensePath()

Verzeichnis mit Lizenzen

from Assembly
Directory
getDefaultPath()

Verzeichnis der Konfigurationsdateien

from Assembly
Directory
getConfigPath()

Verzeichnis der Konfigurationsdateien

from Assembly
Directory
getAssetPath()

Assets-Verzeichnis

from Assembly
Directory
getBasePath()

Basisverzeichnis

from Assembly
Directory
getClassPath()

Code-Verzeichnis

from Assembly
Directory
getResourcePath()

Verzeichnis mit Resourcen

from Assembly
File
getResourceFile(string $filename)

Resourcen-Datei-Objekt zurückgeben

from Assembly
Directory
getLogPath()

Verzeichnis für Logdateien

from Assembly
Web
initLocaleFromHeader(array $localeArray)

Versuchen die Lokale über den Header zu setzen

Web
initLocaleFromQuery(array $localeArray)

Versuchen die Lokale über den Request zu setzen

Web
initLocaleFromRequest(array $localeArray, string $localeString)

Locale initialisieren

Web
initLocaleFromCookie(array $localeArray)

Versuchen die Lokale über ein Cookie zu setzen

initLocale()

Lokale initialisieren

string
getRequestID()

ID des aktuellen Aufrufs (wird von Ignition initialisiert)

Assembly
setBaseURI(URI $uri)

Basis-URI der Webseite setzen

Router|null
getRouter()

Router der Anwendung

Web
initRouter()

Router initialisieren

Request
getRequest()

Request

Web
initRequest()

Request initialisieren

User
validateIdentityAgainstAuthorities(string $username, string $password)

Überprüfen des Benutzernamens und des Passwortes

Identity|null
getIdentityFromRequest()

Identität aus Request ermitteln. Es wird nach den POST-Variablen username und password gesucht. Akternativ können diese in der Konfiguration mittels der Eigenschaften

null|Identity
getIdentityFromRequestBody(string $userNameKey, string $passwordKey)

Identität aus dem Body holen

null|Identity
getIdentityFromWWWAuthentification()

Authentifiaction von WWW-Authentification

Web
authenticate()

Diese Methode liest entweder aus der Session oder aus der POST-Variable username den Namen der angefragten Identität aus.

Authority
getAuthority(string $name)

Authority

Authority>
getAuthorities()

Authorities

Web
initAuthority()

Autorität initialisieren

Web
route()

Diese Methode wird im Rahmen der Task-Bearbeitung (wenn nicht anders konfiguriert) aufgerufen und übergibt den Request an die im Routing definierten Presenter.

Web
executeRoute(string $destination)

Ausführen eines Routings

Web
setCookie(Cookie $cookie)

Cookies für den Versand vormerken.

Identity
getIdentity()

Identität der Anwendung

Directory
getWebPath()

Verzeichnis der Webdateien

Directory
getErrorPath()

Verzeichnis der Fehlerdateien

Directory
getJSPath()

Verzeichnis fürJavascript

Directory
getThemePath()

Verzeichnis der Themes

Directory
getPublicVendorPath()

Verzeichnis für Fremdanbieterdateien Frontend

Directory
getW3CPath()

Verzeichnis mit P2P Datei

URI
getBaseURI()

Basis-URI

boolean
existsSession()

Prüft ob im Request eine Session gesetzt ist.

array
getSessionDefinition()

Session Definition

Session|null
getSession()

Session

Web
initSession()

Lädt eine Session oder erstellt diese neu. Der Name der Klasse und der Name des Cookies, in dem die Session-ID gespeichert wird, kann über die Konfiguration gesteuert werden.

Session
loadSession(string $sessionClass, string $id)

Diese interne Methode wird von Web::initSession() aufgerufen und lädt eine Session aus dem gegebenen Storagesystem. Für andere Storagesysteme muss diese Methode überschrieben werden.

Web
writeSession()

Session schreiben. Für andere Storagesysteme muss diese Methode überschrieben werden.

Details

at line 133
protected __construct(Facility $facility)

Neues Anwendugs-Objekt erstellen.

Der Konstruktor erstellt ein neues Objekt und initialisiert die Systeminstanzen für Environment, Encoding, System und Math. Außerdem wird der Anwendung ein SystemLogger und ein Mailserver zugewiesen.

Parameters

Facility $facility

Exceptions

ConfigurationException

at line 144
__destruct()

Anwendung beenden

in Assembly at line 339
protected Assembly initEventQueues()

Eventqueues

Return Value

Assembly

in Assembly at line 354
protected EventQueue getEventQueue(Event $class)

Eventqueue für Event holen und wenn noch nicht vorhanden anlegen

Parameters

Event $class

Return Value

EventQueue

Exceptions

TypeException

in Assembly at line 377
Assembly subscribeEvent(Subscriber $subscriber, string $eventClass)

Event abonnieren

Parameters

Subscriber $subscriber
string $eventClass

Return Value

Assembly

in Assembly at line 390
Assembly unsubscribeEvent(Subscriber $subscriber, string $eventClass)

Abmelden

Parameters

Subscriber $subscriber
string $eventClass

Return Value

Assembly

in Assembly at line 402
Assembly triggerEvent(Event $event)

Event Triggern

Parameters

Event $event

Return Value

Assembly

in Assembly at line 412
bool shouldBeCached()

Soll die Anwendung cachen

Return Value

bool

in Assembly at line 421
Locale getLocale()

Lokale der Anwendung

Return Value

Locale

in Assembly at line 456
static Assembly execute(Facility $facility)

Programm ausführen

Die execute-Methode sucht nach der gewünschten Anwendung, erstellt ein Objekt der Anwendung, initiert dadurch die Konfiguration und ruft im Anschluß den Taskhandler auf.

Über die optinalen Parameter $namespace und $path können im ersten Aufruf die Anwendungsklassen inititalisiert werden. Bei weiteren Aufrufen, muss dies nicht mehr erfolgen. Der Namespace kann aber auch normal im AutoLoader registriert werden.

Der Task-Handler sorgt dafür, das die in der Konfiguration aufgeführten Task der Reihe nach ausgeführt werden. Durch die Flexibilität der Tasks, können in der konkreten Anwendung unterschiedliche Szenarien implementiert werden.

application.task=init application.task=render

Über den Anwendungsmodus können bestimmte Regeln definiert werden. So wird der Anwendungscache nur im Produktivsystem aktiviert.

Parameters

Facility $facility

Return Value

Assembly Instanz der Anwendung

Exceptions

AssemblyNotFoundException
InvalidArgumentException

in Assembly at line 534
static Assembly|null getInstance(string $assemblyClass = null)

Instanz ermitteln. Wird keine Instanzklasse angegeben, so wird das aktuelle Objekt in der Instanz-Map verwendet.

Wird kein Assembly gefunden, so wird null zurückgegeben.

Parameters

string $assemblyClass

Return Value

Assembly|null

in Assembly at line 554
boolean|Assembly validateInstanceCache()

Meßwerte überprüfen

Mit dieser Methode kann die Anwendung prüfen, ob die zwischengespeicherte Anwendung noch aktuell ist. Abgeleitetet Anwendungen müssen die Methode Application::initCacheExaminer() um die Werte erweitern, die für einen aktuelle Anwendung wichtig sind.

Return Value

boolean|Assembly

Exceptions

InvalidProbeException

at line 337
protected Assembly initCacheExaminer()

Instanzprüfung erweitern

Die Webklasse überwacht im Standard zusätzlich zur Anwendungskonfiguration noch das routing-Verzeichnis.

Ist ein anderes Verhalten gewünscht, oder wird der Default-Router nicht verwendet, so muss diese Methode von der konkreten Klasse überschrieben werden.

Return Value

Assembly Dieses Objekt

in Assembly at line 598
boolean isInstanceValide()

Gültigkeit prüfen

Prüfen ob die Daten der Instanz noch gültig sind.

Return Value

boolean Ergebnis

in Assembly at line 613
static refresh(string $assemblyClass)

Anwendungsklasse aktualisieren

Mit dieser Methode wird der Zwischenspeicher der Anwendungsklasse geleert. Beim nächsten Aufruf von Assembly::execute wird das Objekt für diese Klasse neu erstellt.

Parameters

string $assemblyClass Klassenname und Namespace der Anwendung

in Assembly at line 652
static CacheManager getCacheManager()

AppCache zur Beschleunigung von Anfragen

Diese Methode gibt den Anwendungscache zurück. Im Standard ist das temporäre Verzeichnis definiert. Dies sollte in der abgeleiteten Klasse durch eine schnellere Variante (z.B. Memcache) ersetzt werden.

Für Testzwecke und während der Entwicklung einer Anwendung kann diese Methode null zurückgeben. In diesem Fall wird kein Anwendungscache verwendet.

Return Value

CacheManager CacheManager

in Assembly at line 675
protected Assembly loadConfig()

Konfiguration laden

Diese Methode lädt die Konfiguration der Anwendung. Je nach Dateierweiterung wird eine von \Alvine\Types\Properties abgeleitete Klasse geladen. Für die Erweiterung .properties wird ein Objekt der Klasse \Alvine\Application\Configuration\Properties erstellt, für eine Endung .txt würde die Klasse \Alvine\Application\Configuration\Text initiert werden.

Return Value

Assembly

Exceptions

ConfigurationException
NotFoundException

at line 298
Map getPlaceholderMap()

Standardplatzhalter der Anwendung

Return Value

Map Systemplatzhalter

in Assembly at line 773
Directory getCustomisationPath()

CustomisationPath

Return Value

Directory

in Assembly at line 782
Directory getDataPath()

Daten

Return Value

Directory

in Assembly at line 793
string replaceEnvironmentPlaceholder(string $string)

Standardplatzhalter der Anwendung

Parameters

string $string Inhalt

Return Value

string Inhalt mit ersetzten Platzhaltern

at line 351
protected initDirectories()

Setzt den Basispfad und alle abgeleiteten Pfade

Diese Methode initialisiert die Pfade für die Assets, die Classes, Config, Vendors, Ressources und Views.

in Assembly at line 902
protected Assembly initSMTPClient()

Mailclient initialisieren

Initialisierung des Standard-Mail-Clients. Die Konfiguration erfolgt über die Eigenschaften application.mail.delivery.** (siehe auch assembly.config)

application.mail.delivery.default.class Klasse, die den Versand übernimmt (von SMTPClient abgeleitet) application.mail.delivery.default.server IP, oder Hostname des Mailservers (Standard ist localhost) application.mail.delivery.default.port IP-Port des SMTP-Servers (Standard ist 25)

Return Value

Assembly Dieses Objekt

in Assembly at line 952
SMTPClient|null getDefaultSmtpClient()

SMTP-Client

Return Value

SMTPClient|null

in Assembly at line 966
protected Assembly initLogger()

Logging initialisieren

Inititalisierung des Standardloggers für das Logging. Die Konfiguration erfolgt über die Eigenschaften application.logging.**. Der Logger muß von der Klasse \Alvine\Util\Logging\Logger abgeleitet sein. Für die Verarbeitung können die Handler über die Konfigurationsschlüssel

Return Value

Assembly Dieses Objekt

in Assembly at line 1019
Properties getConfiguration()

Konfiguration zurückgeben

Liefert eine Kopie der Konfigurations. Änderungen in dem Objekt haben keine Auswirkungen auf die Anwenndung.

Return Value

Properties

in Assembly at line 1036
string getConfigurationValue(string $key, string $default = null)

Diese Methode liest einen Konfigurationswert aus.

Ist der Schlüssel nicht angegeben, so wird der Default-Wert zurückgegeben.

Wird ein Teilschlüssel angegeben, so wird ebenfalls der Defaultwert zurückgegeben.

Parameters

string $key Schlüssel
string $default Wert

Return Value

string Konfigurationswert

in Assembly at line 1072
protected $this initPersistenceManager()

Instanz des Storage-Manager holen und Referenz in der Anwendung speichern

Return Value

$this

in Assembly at line 1082
protected Assembly initStorage()

Initialisiert die Struktur für den Objektspeicher.

Return Value

Assembly

in Assembly at line 1100
Assembly initStorageIndex()

Initialisiert die Struktur für den StorageIndex.

Return Value

Assembly

in Assembly at line 1126
Assembly registerStorage(string $className, ObjectStorage $storage)

Ein Storageobjekt registrieren.

Parameters

string $className Für diese Klasse oder das Interface gilt das Storageobjekt
ObjectStorage $storage Storageobjekt

Return Value

Assembly Dieses Objekt

in Assembly at line 1138
Assembly unregisterStorage(string $className)

Registrierung für eine Klasse aufheben

Parameters

string $className Name der Klasse

Return Value

Assembly Dieses Objekt

in Assembly at line 1159
Alvine getObject(string $className, string $id)

Objekt aus dem Storage auslesen

Diese Methode liest ein Objekt aus dem in der Konfiguration definierten Speicher aus. Der Klassenname muss mit führendem \ und vollem Namensraum angegeben werden.

Parameters

string $className Name der Klasse
string $id ID des Objektes

Return Value

Alvine Gespeicherte Klasse

in Assembly at line 1179
Subset findObject(string $className, Query $query)

Nach einem Objekt suchen

Die Suche erfolgt in dem in der Konfiguration definierten Indexer. Der Indexer gibt eine Ergebnismenge zurück. Diese Methode holt sich die ID des Ergebnisses und verwendet die Methode getObject um das echte Objekt zu laden.

Parameters

string $className Klassenname
Query $query Query

Return Value

Subset Ergebnismenge

Exceptions

NullException Es wurde kein Handler für den Typ gefunden
FindException Im Ergebnis wurde ein Eintrag ohne UUID oder Type gefunden. Wahrscheinlich ist der Index nicht mehr konsistent.

in Assembly at line 1193
protected ObjectStorage getPersistenceHandler(string $className, string $mode)

Handler für den entsprechenden Speichertyp

Parameters

string $className Klassenname
string $mode Mode für die Exception

Return Value

ObjectStorage

Exceptions

NullException Nicht gefunden

in Assembly at line 1202
Manager getStorageManager()

Storage-Manager

Return Value

Manager

in Assembly at line 1216
Assembly deleteObject(Alvine $object)

Objekt aus dem Storage löschen

Diese Methode löscht ein Objekt aus dem in der Konfiguration definierten Speicher.

Parameters

Alvine $object zu löschende Objekt

Return Value

Assembly Dieses Objekt

in Assembly at line 1231
Assembly writeObject(Alvine $object)

Objekt in den definierten Speicher schreiben

Das übergebene Objekt wird serialisierten und in den angegebenen Speicher geschrieben.

Parameters

Alvine $object zu speicherndes Objekt

Return Value

Assembly Dieses Objekt

in Assembly at line 1246
string getHashCode()

Diese Methode berechnet einen eindeutigen Wert für eine Anwendung. Da jede Anwendung nur eine Instanz haben kann, muss dieser Wert nur zu Klasse hin eindeutig sein.

Der Anwendungscache verwendet die ID um die Instanz der Anwendung zwischenzuspeichern. Diese Methode sollte deshalb von abgeleiteten Klassen nicht überschrieben werden.

Return Value

string Hashwert des Objektes

at line 439
protected Assembly init()

Initialisierung der Anwendung

Diese Methode wird im Rahmen der Task-Bearbeitung (wenn nicht anders konfiguriert) aufgerufen und initialisiert die Anwendung

Return Value

Assembly

at line 744
protected Assembly finalize()

Finalisierung

Diese Methode wird im Rahmen der Task-Bearbeitung (wenn nicht anders konfiguriert) aufgerufen und schließt die Bearbeitung ab und übergibt alle notwendigen Daten zurück an die PHP-Engine

Return Value

Assembly Dieses Objekt

in Assembly at line 1279
protected Application handleTasks()

Abarbeiten der in der Config definierten Tasks

Return Value

Application Dieses Objekt

Exceptions

TaskNotFoundException Der Task wurde nicht gefunden.

at line 841
Application setView(View $view)

Neues View setzen

Parameters

View $view View

Return Value

Application Dieses Objekt

in Assembly at line 1322
View getView()

View

Return Value

View View

in Assembly at line 1331
Directory getRepositoyPath()

Speicherort für Daten

Return Value

Directory Verzeichnis

in Assembly at line 1340
Directory getVendorPath()

Verzeichnis für Fremdanbieterdateien aus dem Backend

Return Value

Directory Verzeichnis

in Assembly at line 1349
Directory getLicensePath()

Verzeichnis mit Lizenzen

Return Value

Directory Verzeichnis

in Assembly at line 1358
Directory getDefaultPath()

Verzeichnis der Konfigurationsdateien

Return Value

Directory Verzeichnis

in Assembly at line 1367
Directory getConfigPath()

Verzeichnis der Konfigurationsdateien

Return Value

Directory Verzeichnis

in Assembly at line 1376
Directory getAssetPath()

Assets-Verzeichnis

Return Value

Directory Verzeichnis

in Assembly at line 1385
Directory getBasePath()

Basisverzeichnis

Return Value

Directory Verzeichnis

in Assembly at line 1394
Directory getClassPath()

Code-Verzeichnis

Return Value

Directory Verzeichnis

in Assembly at line 1403
Directory getResourcePath()

Verzeichnis mit Resourcen

Return Value

Directory Verzeichnis

in Assembly at line 1430
File getResourceFile(string $filename)

Resourcen-Datei-Objekt zurückgeben

Die Methode sucht entweder im Resourcen-Verzeichnis der Anwendung oder im Absoluten-Pfad nach der Resourcen-Datei. Ist der Dateiname eine http-Resource so wird die Datei geladen und in eine temporäre Datei gespeichert. Dieses Dateiobjekt wird zurückgegeben.

// Temporäre Datei mit dme Inhalt von www.example.com $this->getResourceFile('http://www.example.com/'); // Absolute Datei auf einem Windows-System $this->getResourceFile('file://c:\temp\myfile.txt'); // Absolute Datei auf einem Unix-System (ohne file://) $this->getResourceFile('/tmp/myfile.txt'); // Absolute Datei auf einem Unix-System (mit file://) $this->getResourceFile('file:///tmp/myfile.txt');

Parameters

string $filename Dateiname oder URI

Return Value

File

in Assembly at line 1453
Directory getLogPath()

Verzeichnis für Logdateien

Return Value

Directory Verzeichnis

at line 159
protected Web initLocaleFromHeader(array $localeArray)

Versuchen die Lokale über den Header zu setzen

Parameters

array $localeArray

Return Value

Web

at line 184
protected Web initLocaleFromQuery(array $localeArray)

Versuchen die Lokale über den Request zu setzen

Parameters

array $localeArray

Return Value

Web

at line 209
protected Web initLocaleFromRequest(array $localeArray, string $localeString)

Locale initialisieren

Parameters

array $localeArray
string $localeString Sprache

Return Value

Web

at line 224
protected Web initLocaleFromCookie(array $localeArray)

Versuchen die Lokale über ein Cookie zu setzen

Parameters

array $localeArray

Return Value

Web

at line 254
Assembly initLocale()

Lokale initialisieren

Die Lokale kommt aus dem Request. Wird keine passende Locale gefunden, so wird eine ConfigurationException geworfen.

In der Anwendungskonfiguration muss application.locale.languages definirt sein. Über den Schlüssel application.locale.language.requestkey kann ein Parameter definiert werden, der für die Sprache zuständig ist.

kommagetrennte Liste mit den unterstützen Sprachen

application.locale.languages=de,de_CH,en

Schlüssel für das Setzen der Lokale über einen Parameter

application.locale.language.parameterkey=language

Auswertereihenfolge: Query -> Cookie -> Header

Return Value

Assembly Dieses Objekt

Exceptions

ConfigurationException

at line 318
string getRequestID()

ID des aktuellen Aufrufs (wird von Ignition initialisiert)

Return Value

string

at line 376
Assembly setBaseURI(URI $uri)

Basis-URI der Webseite setzen

Parameters

URI $uri

Return Value

Assembly

at line 389
Router|null getRouter()

Router der Anwendung

Vor dem Aufruf von getRouter muss Web::initRouter() aufgerufen werden. Web::initRouter() wird in der Regel von Web::init() aufgerufen.

Return Value

Router|null null, wenn noch nicht initialisiert

at line 400
protected Web initRouter()

Router initialisieren

Return Value

Web Dieses Objekt

Exceptions

ConfigurationException Kein Router definiert

at line 426
Request getRequest()

Request

Rückgabe des von der PHP-Enging übergebenen Daten in Form eines Request-Objektes

Return Value

Request Request

at line 474
Web initRequest()

Request initialisieren

Initialisieren eines Requests

Return Value

Web Dieses Objekt

at line 487
protected User validateIdentityAgainstAuthorities(string $username, string $password)

Überprüfen des Benutzernamens und des Passwortes

Parameters

string $username
string $password

Return Value

User

at line 520
Identity|null getIdentityFromRequest()

Identität aus Request ermitteln. Es wird nach den POST-Variablen username und password gesucht. Akternativ können diese in der Konfiguration mittels der Eigenschaften

  • application.web.authentication.identity.key und
  • application.web.authentication.identity.password

überschrieben werden.

Return Value

Identity|null

at line 557
protected null|Identity getIdentityFromRequestBody(string $userNameKey, string $passwordKey)

Identität aus dem Body holen

Parameters

string $userNameKey
string $passwordKey

Return Value

null|Identity

at line 572
protected null|Identity getIdentityFromWWWAuthentification()

Authentifiaction von WWW-Authentification

Return Value

null|Identity

See also

http://php.net/manual/de/features.http-auth.php

at line 597
protected Web authenticate()

Diese Methode liest entweder aus der Session oder aus der POST-Variable username den Namen der angefragten Identität aus.

Der Schlüssel für die verwendete POST-Variable kann über die Konfigurationseinstellung application.web.authentication.identity.key definiert werden. Wurden keine Werte definiert, so wird username und password verwendet.

Wurde keine Identität angegeben, so wird ein Anonymous-Objekt vom Typ \Alvine\Security\Authentication\Anonymous inititalisiert.

Return Value

Web Dieses Objekt

at line 634
Authority getAuthority(string $name)

Authority

Parameters

string $name

Return Value

Authority

at line 643
Authority> getAuthorities()

Authorities

Return Value

Authority>

at line 661
Web initAuthority()

Autorität initialisieren

Konfigurationsvariable: application.web.authentication.authority

Hinweis: Die Identität der Anwendung wird nicht zwangsläufig in der Session gespeichert. Einfache GET-Request brauchen nur die Authorisation und nicht eine Session!

Return Value

Web Dieses Objekt

Exceptions

ConfigurationException Keine Konfiguration gefunden

at line 692
protected Web route()

Diese Methode wird im Rahmen der Task-Bearbeitung (wenn nicht anders konfiguriert) aufgerufen und übergibt den Request an die im Routing definierten Presenter.

Wurde das Routing bereits durchgeführt, z.B. durch einen Authentifikationsfehler, so wird kein neues Routing gestartet.

Return Value

Web Dieses Objekt

Exceptions

RouteNotFoundException Wenn kein zutreffendes Routing gefunden wurde

at line 724
Web executeRoute(string $destination)

Ausführen eines Routings

Parameters

string $destination Name der Route

Return Value

Web Dieses Objekte

at line 811
Web setCookie(Cookie $cookie)

Cookies für den Versand vormerken.

Parameters

Cookie $cookie Cookie

Return Value

Web

at line 829
Identity getIdentity()

Identität der Anwendung

Hinweis: Die Identität der Anwendung wird nicht zwangsläufig in der Session gespeichert. Diese Zuweisung erfolgt zum Beispiel über den Authentication-Presenter.

Der Grund für diese gesonderte Zuweisung ist, das nicht jeder Request eine Session benötigt und bekommt. Ein einfacher Request kommt ohne Session aus und spart somit Resourcen.

Return Value

Identity Identität

at line 851
Directory getWebPath()

Verzeichnis der Webdateien

Return Value

Directory Verzeichnis

at line 860
Directory getErrorPath()

Verzeichnis der Fehlerdateien

Return Value

Directory Verzeichnis

at line 869
Directory getJSPath()

Verzeichnis fürJavascript

Return Value

Directory Verzeichnis

at line 878
Directory getThemePath()

Verzeichnis der Themes

Return Value

Directory Verzeichnis

at line 887
Directory getPublicVendorPath()

Verzeichnis für Fremdanbieterdateien Frontend

Return Value

Directory Verzeichnis

at line 896
Directory getW3CPath()

Verzeichnis mit P2P Datei

Return Value

Directory Verzeichnis

at line 905
URI getBaseURI()

Basis-URI

Return Value

URI URI

at line 916
boolean existsSession()

Prüft ob im Request eine Session gesetzt ist.

Return Value

boolean true, wenn eine Session gesetzt ist.

at line 928
arraygetSessionDefinition()

Session Definition

Nur zur internen Verwendung in dieser Klasse Der Aufbau der Struktur kann sich jederzeit ändern.

Return Value

array string, string, string> Definition einer Session (Name, Klasse, Domain, Pfad)

at line 954
Session|null getSession()

Session

Return Value

Session|null Session

at line 974
Web initSession()

Lädt eine Session oder erstellt diese neu. Der Name der Klasse und der Name des Cookies, in dem die Session-ID gespeichert wird, kann über die Konfiguration gesteuert werden.

Werden keie Konfigurationswerte verwendet, so wird die Klasse \Alvine\Net\Session\Session, der Cookie-Name sid und eine Gültigkeit von einer Stunde verwendet.

Die Session wird aus dem in der Anwendung definierten Speicher abgelegt und aus diesem geladen. Ist keine Session verfügbar, so wird eine neue Session erstellt.

Return Value

Web Dieses Objekt

at line 1035
protected Session loadSession(string $sessionClass, string $id)

Diese interne Methode wird von Web::initSession() aufgerufen und lädt eine Session aus dem gegebenen Storagesystem. Für andere Storagesysteme muss diese Methode überschrieben werden.

Parameters

string $sessionClass
string $id

Return Value

Session

at line 1052
protected Web writeSession()

Session schreiben. Für andere Storagesysteme muss diese Methode überschrieben werden.

Hinweis: Die Identität der Anwendung wird nicht zwangsläufig in der Session gespeichert. Diese Zuweisung muss gesondert erfolgen (zum Beispiel über den Authentifcator-Presenter).

Der Grund für diese gesonderte Zuweisung ist, das nicht jeder Request eine Session benötigt und nicht jede Session die Indentitäts-Informationen benötigt.

Return Value

Web