Documentation

RequestHeader extends RequestHeader
in package

Die Spezialisierung für den Request erweitert die Headerklasse um Methode, Protokoll und URI.

Die Werte werden erst dann aus den entsprechenden globalen Variablen ausgelesen, wenn diese benötigt werden. Danach werden diese gespeichert.

$_SERVER['SERVER_PROTOCOL']='HTTP/1.0';
echo $request->getProtocol(); // HTTP/1.0
$_SERVER['SERVER_PROTOCOL']='HTTP/1.1';
echo $request->getProtocol(); // weiterhin => HTTP/1.0 und nicht HTTP/1.1
Tags
category

Framework

author

schukai GmbH [email protected]

license

http://alvine.io/license/ Licence

link

Alvine
link
http://de.wikipedia.org/wiki/Liste_der_HTTP-Headerfelder
since
20110904

Table of Contents

Constants

ACCEPT  = 'Accept'
Welche Dateitypen der Browser verarbeiten kann.
ACCEPT_CHARSET  = 'Accept-Charset'
Welche Zeichensätze der Browser anzeigen kann und somit empfangen möchte
ACCEPT_DATETIME  = 'Accept-Datetime'
Akzeptierte Dateiversion bis zum Datum X
ACCEPT_ENCODING  = 'Accept-Encoding'
Welche komprimierten Formate der Browser unterstützt
ACCEPT_LANGUAGE  = 'Accept-Language'
Welche Sprachen der Browser akzeptiert
ACCESS_CONTROL_REQUEST_HEADERS  = 'Access-Control-Request-Headers'
CORS: Access-Control-Request-Method
ACCESS_CONTROL_REQUEST_METHOD  = 'Access-Control-Request-Method'
CORS: Access-Control-Request-Method
APIVERSION  = 1
Version der API-Version der Klasse.
AUTHORIZATION  = 'Authorization'
Authentifizierungsdaten für HTTP-Authentifizierungsverfahren
CACHE_CONTROL  = 'Cache-Control'
Wird genutzt, um Optionen festzulegen, denen durch alle Caching-Mechanismen entlang der Anfrage-/Antwort-Kette Folge geleistet werden muss
CONNECTION  = 'Connection'
Welchen Typ von Verbindung der Browser bevorzugt
CONTENT_DISPOSITION  = 'Content-Disposition'
Mit diesem nicht standardisierten und als gefährlich eingestuften Feld kann der Server für bestimmte MIME-Typen Downloadfenster erzeugen und einen Dateinamen vorschlagen.
CONTENT_LENGTH  = 'Content-Length'
Länge des Bodys in Bytes
CONTENT_MD5  = 'Content-MD5'
Eine Base64-codierte MD5-Checksume des Bodys
CONTENT_TYPE  = 'Content-Type'
MIME-Typ des Bodys
COOKIE  = 'Cookie'
ein HTTP-Cookie, das zuvor vom Server mit Set-Cookie gesetzt wurde
DATE  = 'Date'
Datum und Zeit zum Sendezeitpunkt
EXPECT  = 'Expect'
Zeigt, welches Verhalten der Client vom Server erwartet
FROM_  = 'From'
E-mail-Adresse des Nutzers, der die Anfrage stellte (heute unüblich)
HOST  = 'Host'
Domain-Name des Servers, zwingend vorgeschrieben seit HTTP/1.1 und nötig für namensbasierte Hosts.
IDENTIFICATION  = 'Alvine'
Identifizierung der Alvine API
IF_MATCH  = 'If-Match'
Aktion nur durchführen, falls der gesendete Code mit dem auf dem Server vorhandenen Code übereinstimmt.
IF_MODIFIED_SINCE  = 'If-Modified-Since'
Erlaubt dem Server, den Statuscode 304 Not Modified zu senden, falls sich seit dem angegebenen Zeitpunkt nichts verändert hat.
IF_NONE_MATCH  = 'If-None-Match'
Erlaubt dem Server bei unverändertem Inhalt (verifiziert durch ETags) den Statuscode 304 Not Modified als Antwort.
IF_RANGE  = 'If-Range'
Falls der Client einen Teil einer Datei vom Server im Cache liegen hat, die sich auf dem Server nicht verändert hat, nur den fehlenden Rest senden; ansonsten ganze Datei schicken.
IF_UNMODIFIED_SINCE  = 'If-Unmodified-Since'
Nur dann die Seite senden, falls diese seit dem angegebenen Zeitpunkt nicht geändert wurde.
LOWERCASE  = 2
Kleinbuchstaben
MAX_FORWARDS  = 'Max-Forwards'
Begrenzt die Anzahl der möglichen Weiterleitungen durch Proxys oder Gateways
ORIGIN  = 'Origin'
CORS: Origin
PRAGMA  = 'Pragma'
Das Feld Pragma enthält Optionen, die möglicherweise nur von einigen Implementationen verstanden werden und sich an alle Glieder in der Frage-Antwort-Kette richten
PROXY_AUTHORIZATION  = 'Proxy-Authorization'
Im Feld Proxy-Authorization können Autorisierungsdaten für Proxys mit Autorisierungszwang eingebettet werden.
RANGE  = 'Range'
Enthält eine Bereichsangabe für den Bereich, den der Client vom Server anfordert.
REFERER  = 'Referer'
Im Feld Referer ist der URI der verweisenden Seite enthalten
SERIALVERSION  = 1
Version der Klasse (wird für die Serialisierung verwendet. Ändert sich der interne Aufbau der Klasse, so muss dieser Wert nach oben gesetzt werden. Die Serialisierung muss diesen Wert abfragen und bei Bedarf einen Wrapper für das Arbeiten mit veralteten Objekten implmenetieren.
TE  = 'TE'
Welche Formate der Client annehmen kann
UPGRADE  = 'Upgrade'
Vorschlag an den Server, ein anderes Protokoll zu nutzen
UPPERCASE  = 1
Großbuchstaben
USER_AGENT  = 'User-Agent'
Der User-Agent-String des Clients. In ihm stehen Informationen über den Client.
VERSION  = 2
Generelle Alvine-Version
VIA  = 'Via'
Gibt dem Server Informationen über Proxys im Übertragungsweg
WARNING  = 'Warning'
Allgemeine Warnungen über den Umgang mit dem Body oder den Body selbst

Properties

$entrySeparator  : string
$hasAssociatedProperties  : boolean
$hash  : string
Eindeutige ID
$hasVolatileProperties  : boolean
$headerMap  : array
Einige Header folgen nicht dem Schema von Groß-/Kleinschreibung und müssen gesondert behandelt werden. Diese Map definiert diese Sonderfälle.
$keyValueSeparator  : string
$method  : string
$properties  : array
$protocol  : string
$uri  : URI

Methods

__call()  : mixed
Ein Closures das dem Objekt übergeben wurde, kann entweder als Property oder als Funktion aufgerufen werden.
__clone()  : mixed
Interne Hook für das Clonen des Objektes. Wenn das zu klonende Objekt bereits eine eindeutige ID hat, dann wird auch für das neue Objekt eine eindeutige ID erstellt.
__construct()  : mixed
Neues Objekt erstellen
__get()  : mixed
Diese Methode wird inplizit aufgerufen wenn eine nicht definierte Eigenschaft abgefragt wird. Ist die Eigenschaft eine Anonyme-Funktion (Closure), so wird diese Funktion aufgerufen und die Klasse als Parameter übergeben.
__isset()  : boolean
Wird aufgerufen, wenn isset() auf ein internes Property angewendet wird.
__serialize()  : array<string|int, mixed>
Serialization of the object and data. In the serialized object also stores meta-information for matching.
__set()  : void
Jede von der Alvine-Klasse abgeleitete Klasse besitzt die Fähigkeit beliebige Werte und Lambda-Funktionen an das Objekt zu hängen.
__toString()  : string
Standardumwandlung des Inhalts der Klasse in eine Zeichenkette
__unserialize()  : void
__unset()  : mixed
Zurücksetzen von Werten
add()  : Header
Header hinzufügen
append()  : Map
Map oder Array anhängen
asArray()  : array
Inhalt des Dataset als Array
asJson()  : string
Json-Zeichenkette
clear()  : Map
Leert alle Einträge aus der Map
containsKey()  : boolean
Prüft ob es einen Eintrag mit dem Schlüssel gibt und dieser einen Wert !== null hat.
containsValue()  : boolean
Prüft ob der übergebene Wert in der Map enthalten ist.
count()  : int
Ermittelt die Anzahl der Einträge in der Map
current()  : mixed
Wert des aktuellen Objektes
each()  : Map
Durchläuft alle Einträge der Map und ruft die entsprechende Funktion auf. Besonders in Zusammenhang mit den anonymen Funktionen lassen sich so sehr effiziente Konvertierungen durchführen.
equals()  : boolean
Diese Funktion vergleicht zwei Objekte. Dazu wird von beiden der Wert, der von `Alvine::getID()` zurückgeliefert wird ermittelt und das Ergebnis verglichen. Vererbte Klassen können diese Methode überschreiben.
getClass()  : string
Name der Klasse
getClone()  : Alvine
Diese Methode gibt ein geklontes Objekt von sich selber zurück.
getClosure()  : Closure
Closure über den definierten Namen holen. Ist keine Eigenschaft mit dem Namen definiert, so wird eine BadPropertyException geworfen. Gibt es eine Eigenchaft mit dem Namen, ist diese aber kein Closure, so wird eine NotFoundException geworfen.
getContentType()  : MIMEType|null
Inhaltstyp
getHashCode()  : string
Die Methode Alvine::getID() verwenden!
getID()  : string
Diese Methode gibt eine eindeutige ID des Objektes zurück. Bei der ID handelt es sich um eine Zeichenkette in der Form einer UUID.
getInstanceFromData()  : Header
Parst eine Zeichenkette und gibt ein Header-Objekt zurück
getIntersection()  : Map
Teilschlüssel holen
getIntersectionGroups()  : Map
Teilmengen in Gruppen
getMethod()  : string
Die Methode des Requests
getProtocol()  : string
HTTP-Protokoll
getRealMethod()  : string|null
Methode
getShortID()  : string
Diese Methode entfernt alle Minuszeichen aus der UUID des Hash. Wird eine Länge definiert, so wird nach dem entfernen der Minuszeichen die ersten $length Zeichen zurückgegeben.
getURI()  : URI
URI
getValue()  : mixed
Gibt den Wert des Schlüssels in der Map zurück.
hasAssociatedProperties()  : boolean
Check if the object has associative properties
hasVolatileProperties()  : boolean
Prüfen ob das Objekt volatile Eigenschaften besitzt
isCallable()  : bool
Mit dieser Methode kann geprüft werden, ob eine Methode aufrufbar ist. Das gilt für echte und eingehängte DI-Methoden (Lambda).
isInstanceOf()  : boolean
Prüft ob das übergebene Objekt eine Instanz dieses Objektes ist. Allerdings ist darauf zu achten, das vorher definiert wurde, das das neue Objekt von Alvine abgeleitet wurde.
jsonSerialize()  : mixed
Implementierung des JsonSerializable Interfaces. Ein Dataset gibt auf oberster Ebene immer ein Array zurück.
key()  : mixed
Schlüssel des aktuellen Elements zurückgeben
next()  : void
Den internen Zeiger der Map auf den nächsten Wert setzen.
normalizeKey()  : Map
Wandelt die Schlüssel in Großbuchstaben oder Kleinbuchstaben um.
offsetExists()  : bool
Implementierung des Array-Interfaces
offsetGet()  : mixed
Implementierung des Array-Interfaces
offsetSet()  : void
Implementierung des Array-Interfaces
offsetUnset()  : void
Implementierung des Array-Interfaces
propertyExists()  : boolean
Prüfen ob eine Eigenschaft als dynamische Eigenschaft verfügbar ist, die über $obj->property abgefragt werden kann.
remove()  : Map
Löscht den Eintrag mit dem übergebenen Schlüssel aus der Map
removeValue()  : Map
Entfernt alle Einträge, die den übergebenen Wert haben.
rewind()  : void
Zurücksetzen des internen Zeigers der Map auf den ersten Eintrag
setAcceptCharset()  : Header
Setzt den akzeptierten Zeichensatz
setContentLength()  : Header
Die Anzahl an Bytes für den Requests setzen
setCookies()  : RequestHeader
Cookies setzen
setDate()  : Header
Datum setzen
setEntrySeparator()  : Map
Setzt das Trennzeichen für die __toString Methode
setKeyValueSeparator()  : Map
Setzt das Trennzeichen für die __toString Methode
setMethod()  : mixed
Eine der gültigen Methoden setzen
setProtocol()  : mixed
Setzt das Protokoll.
setURI()  : mixed
Setzen der URI
setValue()  : Map
Wert setzen
toArray()  : array
Werte als Array
valid()  : boolean
Prüft ob der interne Zeiger auf ein gültiges Element der Map zeigt.
checkAndAdjustSerialisation()  : array<string|int, mixed>
Dealing with versions
normalize()  : array<string|int, mixed>
Werte überprüfen
normalizeValue()  : mixed
Bearbeitung des Wertes
parseData()  : Header
Daten parsen
prepareOutput()  : array
Ausgabe vorbereiten
setFirstLine()  : Header
Erste Zeile setzen

Constants

ACCEPT

Welche Dateitypen der Browser verarbeiten kann.

public mixed ACCEPT = 'Accept'

ACCEPT_CHARSET

Welche Zeichensätze der Browser anzeigen kann und somit empfangen möchte

public mixed ACCEPT_CHARSET = 'Accept-Charset'

ACCEPT_DATETIME

Akzeptierte Dateiversion bis zum Datum X

public mixed ACCEPT_DATETIME = 'Accept-Datetime'

ACCEPT_ENCODING

Welche komprimierten Formate der Browser unterstützt

public mixed ACCEPT_ENCODING = 'Accept-Encoding'

ACCEPT_LANGUAGE

Welche Sprachen der Browser akzeptiert

public mixed ACCEPT_LANGUAGE = 'Accept-Language'

APIVERSION

Version der API-Version der Klasse.

public mixed APIVERSION = 1

AUTHORIZATION

Authentifizierungsdaten für HTTP-Authentifizierungsverfahren

public mixed AUTHORIZATION = 'Authorization'

CACHE_CONTROL

Wird genutzt, um Optionen festzulegen, denen durch alle Caching-Mechanismen entlang der Anfrage-/Antwort-Kette Folge geleistet werden muss

public mixed CACHE_CONTROL = 'Cache-Control'

CONNECTION

Welchen Typ von Verbindung der Browser bevorzugt

public mixed CONNECTION = 'Connection'

CONTENT_DISPOSITION

Mit diesem nicht standardisierten und als gefährlich eingestuften Feld kann der Server für bestimmte MIME-Typen Downloadfenster erzeugen und einen Dateinamen vorschlagen.

public mixed CONTENT_DISPOSITION = 'Content-Disposition'

CONTENT_LENGTH

Länge des Bodys in Bytes

public mixed CONTENT_LENGTH = 'Content-Length'

CONTENT_MD5

Eine Base64-codierte MD5-Checksume des Bodys

public mixed CONTENT_MD5 = 'Content-MD5'

CONTENT_TYPE

MIME-Typ des Bodys

public mixed CONTENT_TYPE = 'Content-Type'

COOKIE

ein HTTP-Cookie, das zuvor vom Server mit Set-Cookie gesetzt wurde

public mixed COOKIE = 'Cookie'

DATE

Datum und Zeit zum Sendezeitpunkt

public mixed DATE = 'Date'

EXPECT

Zeigt, welches Verhalten der Client vom Server erwartet

public mixed EXPECT = 'Expect'

FROM_

E-mail-Adresse des Nutzers, der die Anfrage stellte (heute unüblich)

public mixed FROM_ = 'From'

HOST

Domain-Name des Servers, zwingend vorgeschrieben seit HTTP/1.1 und nötig für namensbasierte Hosts.

public mixed HOST = 'Host'

IDENTIFICATION

Identifizierung der Alvine API

public mixed IDENTIFICATION = 'Alvine'

IF_MATCH

Aktion nur durchführen, falls der gesendete Code mit dem auf dem Server vorhandenen Code übereinstimmt.

public mixed IF_MATCH = 'If-Match'

IF_MODIFIED_SINCE

Erlaubt dem Server, den Statuscode 304 Not Modified zu senden, falls sich seit dem angegebenen Zeitpunkt nichts verändert hat.

public mixed IF_MODIFIED_SINCE = 'If-Modified-Since'

IF_NONE_MATCH

Erlaubt dem Server bei unverändertem Inhalt (verifiziert durch ETags) den Statuscode 304 Not Modified als Antwort.

public mixed IF_NONE_MATCH = 'If-None-Match'

IF_RANGE

Falls der Client einen Teil einer Datei vom Server im Cache liegen hat, die sich auf dem Server nicht verändert hat, nur den fehlenden Rest senden; ansonsten ganze Datei schicken.

public mixed IF_RANGE = 'If-Range'

IF_UNMODIFIED_SINCE

Nur dann die Seite senden, falls diese seit dem angegebenen Zeitpunkt nicht geändert wurde.

public mixed IF_UNMODIFIED_SINCE = 'If-Unmodified-Since'

LOWERCASE

Kleinbuchstaben

public mixed LOWERCASE = 2

MAX_FORWARDS

Begrenzt die Anzahl der möglichen Weiterleitungen durch Proxys oder Gateways

public mixed MAX_FORWARDS = 'Max-Forwards'

PRAGMA

Das Feld Pragma enthält Optionen, die möglicherweise nur von einigen Implementationen verstanden werden und sich an alle Glieder in der Frage-Antwort-Kette richten

public mixed PRAGMA = 'Pragma'

PROXY_AUTHORIZATION

Im Feld Proxy-Authorization können Autorisierungsdaten für Proxys mit Autorisierungszwang eingebettet werden.

public mixed PROXY_AUTHORIZATION = 'Proxy-Authorization'

RANGE

Enthält eine Bereichsangabe für den Bereich, den der Client vom Server anfordert.

public mixed RANGE = 'Range'

REFERER

Im Feld Referer ist der URI der verweisenden Seite enthalten

public mixed REFERER = 'Referer'

SERIALVERSION

Version der Klasse (wird für die Serialisierung verwendet. Ändert sich der interne Aufbau der Klasse, so muss dieser Wert nach oben gesetzt werden. Die Serialisierung muss diesen Wert abfragen und bei Bedarf einen Wrapper für das Arbeiten mit veralteten Objekten implmenetieren.

public mixed SERIALVERSION = 1

https://php.watch/versions/8.1/serializable-deprecated

UPGRADE

Vorschlag an den Server, ein anderes Protokoll zu nutzen

public mixed UPGRADE = 'Upgrade'

UPPERCASE

Großbuchstaben

public mixed UPPERCASE = 1

USER_AGENT

Der User-Agent-String des Clients. In ihm stehen Informationen über den Client.

public mixed USER_AGENT = 'User-Agent'

VERSION

Generelle Alvine-Version

public mixed VERSION = 2

VIA

Gibt dem Server Informationen über Proxys im Übertragungsweg

public mixed VIA = 'Via'

WARNING

Allgemeine Warnungen über den Umgang mit dem Body oder den Body selbst

public mixed WARNING = 'Warning'

Properties

$entrySeparator

protected string $entrySeparator = ','

Trennzeichen der Key/Value Einträge

$hash

Eindeutige ID

protected string $hash = null

Die ID wird erst über die Methode \Alvine\Core\Alvine::getID() bei Bedarf ermittelt, deshalb müssen auch abgeleitete Klassen nicht direkt auf den Wert zugreifen, sondern den Wert über getID() holen.

Hash-Wert des Objekts (UUID)

$headerMap

Einige Header folgen nicht dem Schema von Groß-/Kleinschreibung und müssen gesondert behandelt werden. Diese Map definiert diese Sonderfälle.

protected static array $headerMap = ['x-rewrite-url' => 'X-Rewrite-URL', 'x-http-method-override' => 'X-HTTP-Method-Override', 'x-http-method' => 'X-HTTP-Method', 'dnt' => 'DNT']

Liste mit definierten Array

$keyValueSeparator

protected string $keyValueSeparator = ':'

Trennzeichen zwischen den Key/Value Einträge

$properties

protected array $properties = []

Liste mit dynamischen Eigenschaften die über __get und __set bearbeitet werden können.

Methods

__call()

Ein Closures das dem Objekt übergeben wurde, kann entweder als Property oder als Funktion aufgerufen werden.

public __call(string $name, array $arguments) : mixed

Achtung: Wird das Closure in einem Objekt definiert, so ist die Variable $this nicht das Objekt des Closures, sondern des, in dem das Closure definiert wurde. 

// als erster Parameter wird immer das Objekt übergeben
$a->myfunction = function($obj, $b) { echo $b.'!'; };
// Aufruf als Eigenschaft ohne Parameter
$a->myfunction;  // Ausgabe ist ein !
//
// Aufruf als Methode mit Parametern
$a->myfunction('OK');  // Ausgabe ist  OK!
Parameters
$name : string

Funktionsname

$arguments : array

Argumente

Tags
throws
NotCallableException

Exception

Return values
mixed —

Ergebnis des Callbacks

__clone()

Interne Hook für das Clonen des Objektes. Wenn das zu klonende Objekt bereits eine eindeutige ID hat, dann wird auch für das neue Objekt eine eindeutige ID erstellt.

public __clone() : mixed

Alvine-Objekte werden rekursive geclont, so das ein vollständiger Clone vorhanden ist.

__construct()

Neues Objekt erstellen

public __construct() : mixed

Der Konstruktor erstellt einen neuen RequestHeader und füllt die Headerdaten mit den Daten aus der PHP-Umgebung.

__get()

Diese Methode wird inplizit aufgerufen wenn eine nicht definierte Eigenschaft abgefragt wird. Ist die Eigenschaft eine Anonyme-Funktion (Closure), so wird diese Funktion aufgerufen und die Klasse als Parameter übergeben.

public __get(string $name) : mixed

Vor der Abfrage sollte, damit keine Exception geworfen wird, die Existenz der Eigenschaft geprüft werden.

if($obj->propertyExists('myproperty')) {
  $value = $obj->myproperty;
}
Parameters
$name : string

Name der Eigenschaft

Tags
throws
BadPropertyException
Return values
mixed —

Wert der Eigenschaft

__isset()

Wird aufgerufen, wenn isset() auf ein internes Property angewendet wird.

public __isset(string $name) : boolean
Parameters
$name : string
Return values
boolean

__serialize()

Serialization of the object and data. In the serialized object also stores meta-information for matching.

public __serialize() : array<string|int, mixed>

If a derived class is not to be serializable, then this * method must be overridden and throw an exception. this method must be overridden and throw an exception.

Properties starting with volatile or associated. are handled separately. Properties with prefix volatile are not serialized. For properties with the prefix associated, only the * ID of the object is serialized. ID of the object is serialized. If no object is stored in the property is stored in the property, a TypeException is thrown.

Tags
see
https://php.watch/versions/8.1/serializable-deprecated
Return values
array<string|int, mixed>

__set()

Jede von der Alvine-Klasse abgeleitete Klasse besitzt die Fähigkeit beliebige Werte und Lambda-Funktionen an das Objekt zu hängen.

public __set(string $name, mixed $value) : void

Diese Methode wird indirekt aufgerufen, sobald ein Wert oder eine Funktion einem Objekt zugeordnet wird, die nicht definiert wurde.

class MyObject extends Alvine {
}

$obj = new MyObject();
$obj->myValue = 4;
Parameters
$name : string

Name der Eigenschaft

$value : mixed

Wert der Eigenschaft

Return values
void

__toString()

Standardumwandlung des Inhalts der Klasse in eine Zeichenkette

public __toString() : string 
echo (string) new MyObect();
Return values
string —

Daten des Objekts

__unset()

Zurücksetzen von Werten

public __unset(string $name) : mixed
Parameters
$name : string

add()

Header hinzufügen

public add(string $name, string $value) : Header

Diese Methode ergänzt das Hinzufügen um eine Bereinigung für $_SERVER-Variablen.

$obj->add('HTTP_DNT'); // DNT
Parameters
$name : string

Name des Headers

$value : string

Wert

Return values
Header —

Liefert dieses Objekt zurück

append()

Map oder Array anhängen

public append(Map|array $map) : Map

Hängt an die Map weitere Einträge an. Vor dem einhängen wird die Methode Map::normalize() aufgerufen.

Parameters
$map : Map|array

Eine anzuhängende map oder ein Key/Value Array

Return values
Map —

Liefert einen Zeiger auf dieses Objekt zurück

asArray()

Inhalt des Dataset als Array

public asArray() : array

asArray wandelt, anders als toArray die gesamte Struktur der Map so um, das es an tojson verwendet werden kann.

Return values
array

asJson()

Json-Zeichenkette

public asJson() : string
Return values
string —

Json-Zeichenkette

clear()

Leert alle Einträge aus der Map

public clear() : Map
Return values
Map —

dieses Objekt

containsKey()

Prüft ob es einen Eintrag mit dem Schlüssel gibt und dieser einen Wert !== null hat.

public containsKey(string $key) : boolean
Parameters
$key : string

Schlüssel

Return values
boolean —

true wenn der Schlüssel vorhanden ist

containsValue()

Prüft ob der übergebene Wert in der Map enthalten ist.

public containsValue(mixed $value) : boolean
Parameters
$value : mixed

Wert der gesucht werden soll

Return values
boolean —

true ist der Wert in der Map enthalten

count()

Ermittelt die Anzahl der Einträge in der Map

public count() : int
Return values
int —

Anzahl der Einträge in der Map

current()

Wert des aktuellen Objektes

public current() : mixed
Return values
mixed —

Gibt den Wert des aktuellen Element, oder wenn leer false zurück

each()

Durchläuft alle Einträge der Map und ruft die entsprechende Funktion auf. Besonders in Zusammenhang mit den anonymen Funktionen lassen sich so sehr effiziente Konvertierungen durchführen.

public each(Closure $callback[, string $filter = null ]) : Map 
$map = new Alvine\types\Map(array('aaa'=>'Auto','bbb'=>'Boot','ccc'=>'Flugzeug'));
$map->each(function($k, $v) { return $v.'...'; });
// Der Filter beachtet die groß/Kleinschreibung.
$map->each(function($k, $v) { return $v.'...'; });

Die Werte werden dann jeweils um ... ergänzt: Auto... Boot... und Flugzeug ... Über den optionalen Filter können Einschränkungen auf den Schlüssel angewendet werden.

// Mit Filter auf alle Schlüssel die mit a anfangen.
$map->each(function($k, $v) { return $v.'...'; }, 'a');

Nur das Auto würde in diesem Beispiel um ... ergänzt werden. Gibt die aufgerufene Funktion null zurück, so wird keine Zuweisung durchgeführt und der ursprüngliche Wert bleibt erhalten.

Parameters
$callback : Closure

Funktion die aufgerufen wird

$filter : string = null

Über einen Filter können nur ganz bestimmte Schlüsselwörter angesprochen werden.

Return values
Map

equals()

Diese Funktion vergleicht zwei Objekte. Dazu wird von beiden der Wert, der von `Alvine::getID()` zurückgeliefert wird ermittelt und das Ergebnis verglichen. Vererbte Klassen können diese Methode überschreiben.

public equals(Alvine $object) : boolean 
class MyObject extends Alvine };

$objA = new MyObject();
$objB = new MyObject();

if($objA->equals($objB)) {
  // ...
}
Parameters
$object : Alvine

Objekt das überprüft werden soll

Return values
boolean —

true wenn beide Objekte identisch sind.

getClass()

Name der Klasse

public getClass() : string 
class MyObject extends Alvine };
$obj = new MyObject();

echo $obj->getClass();
Tags
see
ClassType::getNormalizedName
Return values
string —

Klassenname

getClone()

Diese Methode gibt ein geklontes Objekt von sich selber zurück.

public getClone([boolean $deepClone = false ]) : Alvine

Wenn eine abgeleitete Klasse diese Methode nicht unterstützt, so muss diese die Methode überschreiben und eine CloneNotSupportedException werfen. Die Standardmethode klont eine seichte Kopie der Eigenschaften. Das bedeutet das Objekte in den Eigenschaften nicht geclont werden. Sollen diese auch geclont werden muss true übergeben werden.

Wenn weitere Funktionen implementiert werden sollen, so muss __clone überschrieben werden

Parameters
$deepClone : boolean = false

Clone aller enthaltenen Objekte

Tags
see
Alvine::__clone()
Return values
Alvine

getClosure()

Closure über den definierten Namen holen. Ist keine Eigenschaft mit dem Namen definiert, so wird eine BadPropertyException geworfen. Gibt es eine Eigenchaft mit dem Namen, ist diese aber kein Closure, so wird eine NotFoundException geworfen.

public getClosure(string $name) : Closure
Parameters
$name : string

Name des Closure

Tags
throws
NotFoundException
throws
BadPropertyException
Return values
Closure

getContentType()

Inhaltstyp

public getContentType() : MIMEType|null

Ist im Header kein Inhaltstyp definiert, so gibt diese Methode null zurück.

Return values
MIMEType|null —

MimeType des Requests

getHashCode()

Die Methode Alvine::getID() verwenden!

public getHashCode() : string
Tags
deprecated
20140611
Return values
string —

Hashwert des Objektes

getID()

Diese Methode gibt eine eindeutige ID des Objektes zurück. Bei der ID handelt es sich um eine Zeichenkette in der Form einer UUID.

public getID() : string

Objekte haben bei der Erstellung noch keine eindeutige ID, erst mit dem expliziten Aufruf der ID wird diese einmalig erstellt und im Objekt gepseichert.

Diese Methode wird implizit beim Serialisieren aufgerufen.

Die UUID ist dabei vom Type4 (Random)

Return values
string —

UUID des Objektes

getInstanceFromData()

Parst eine Zeichenkette und gibt ein Header-Objekt zurück

public static getInstanceFromData(string $data) : Header
Parameters
$data : string

Zeichekette

Return values
Header —

Header

getIntersection()

Teilschlüssel holen

public getIntersection(HierarchicalString|string $filter) : Map

Diese Methode holt eine Schnittmenge aus der Eigenschaftsliste mit allen Schlüsseln die zu dem Filter passen.

Diese Methode ist nicht sehr schnell und sollte mit bedacht gewählt werden.

Parameters
$filter : HierarchicalString|string

Filterwert

Return values
Map —

Neues Objekt

getIntersectionGroups()

Teilmengen in Gruppen

public getIntersectionGroups(HierarchicalString|string $filter[, integer|null $level = null ]) : Map

Diese Methode holt eine Schnittmenge aus der Eigenschaftsliste mit allen Schlüsseln die zu dem Filter passen und gruppiert das Ergebnis zu dem gewünschten Level.

Diese Methode ist nicht sehr schnell und sollte mit bedacht gewählt werden.

Parameters
$filter : HierarchicalString|string

Filterwert

$level : integer|null = null

Ebenen. Wird null übergeben, wird als Ebenen die Anzahl der Teilstrings verwendet.

Return values
Map —

Neues Objekt

getMethod()

Die Methode des Requests

public getMethod() : string

Diese Methode ermittelt das HTTP-Verb des Request. Dabei kann das Verb im Header durch die Angabe des optionalen Headers HTTP_X_HTTP_METHOD_OVERRIDE oder mittels POST-Variable HTTP_X_HTTP_METHOD_OVERRIDE überschireben werden.

So kann man über den Browser mittels verstecktem Input-Feld ein HTTP-DELETE realisieren.

<form method="POST">
<input name="X_HTTP_METHOD_OVERRIDE" value="DELETE">;
<!-- some stuff -->
</form>
Return values
string —

Methode

getProtocol()

HTTP-Protokoll

public getProtocol() : string

Holt das HTTP-Protokoll mit Version. HTTP/1.0 oder HTTP/1.1 werden aktuell unterstützt.

Return values
string —

Protokoll

getRealMethod()

Methode

public getRealMethod() : string|null

Liefert die echte im Header angegebene Methode.

Return values
string|null —

Methode

getShortID()

Diese Methode entfernt alle Minuszeichen aus der UUID des Hash. Wird eine Länge definiert, so wird nach dem entfernen der Minuszeichen die ersten $length Zeichen zurückgegeben.

public getShortID([int|null $length = null ]) : string

Diese Methode ist hilfreich um Platz zu sparen.

Je kürzer die ID ist, um so größer ist die Wahrscheinlichkeit einer Kollision mit anderen Hash vergleichbarer Objekte.

Parameters
$length : int|null = null
Return values
string

getValue()

Gibt den Wert des Schlüssels in der Map zurück.

public getValue(string $key[, mixed $default = null ]) : mixed
Parameters
$key : string

Schlüssel

$default : mixed = null

Standardwert, wenn der Schlüssel nicht gesetzt ist.

Return values
mixed —

Wert der Eigenschaft

isCallable()

Mit dieser Methode kann geprüft werden, ob eine Methode aufrufbar ist. Das gilt für echte und eingehängte DI-Methoden (Lambda).

public isCallable(string $name) : bool 
if($obj->isCallable('myfunction')) {
  $obj->myfunction();
}
Parameters
$name : string

Name der Methode

Return values
bool —

Ergebnis

isInstanceOf()

Prüft ob das übergebene Objekt eine Instanz dieses Objektes ist. Allerdings ist darauf zu achten, das vorher definiert wurde, das das neue Objekt von Alvine abgeleitet wurde.

public isInstanceOf(object $object) : boolean 
if($obj instanceof Alvine &&
   $obj->isInstanceOf($object)) { };

Die Prüfung entspricht

$this instanceof $object
Parameters
$object : object
Return values
boolean

jsonSerialize()

Implementierung des JsonSerializable Interfaces. Ein Dataset gibt auf oberster Ebene immer ein Array zurück.

public jsonSerialize() : mixed
Return values
mixed

key()

Schlüssel des aktuellen Elements zurückgeben

public key() : mixed
Return values
mixed —

Gibt den Schlüssel des aktuellen Elements, oder wenn leer false zurück

next()

Den internen Zeiger der Map auf den nächsten Wert setzen.

public next() : void
Return values
void

normalizeKey()

Wandelt die Schlüssel in Großbuchstaben oder Kleinbuchstaben um.

public normalizeKey(int $mode) : Map
Parameters
$mode : int

Map::LOWERCASE oder Map::UPPERCASE

Return values
Map —

Dieses Objekt

offsetExists()

Implementierung des Array-Interfaces

public offsetExists(mixed $key) : bool
Parameters
$key : mixed

Schlüssel

Return values
bool —

true/false

offsetGet()

Implementierung des Array-Interfaces

public offsetGet(mixed $key) : mixed
Parameters
$key : mixed

Schlüssel

offsetSet()

Implementierung des Array-Interfaces

public offsetSet(mixed $key, mixed $value) : void
Parameters
$key : mixed

Schlüssel

$value : mixed

Wert

offsetUnset()

Implementierung des Array-Interfaces

public offsetUnset(mixed $key) : void
Parameters
$key : mixed

Schlüssel

propertyExists()

Prüfen ob eine Eigenschaft als dynamische Eigenschaft verfügbar ist, die über $obj->property abgefragt werden kann.

public propertyExists(string $name) : boolean 
if($obj->propertyExists('myproperty')) {
  $value = $obj->myproperty;
}
Parameters
$name : string

Name der Eigenschaft

Return values
boolean

remove()

Löscht den Eintrag mit dem übergebenen Schlüssel aus der Map

public remove(string $key) : Map
Parameters
$key : string
Return values
Map —

Dieses Objekt

removeValue()

Entfernt alle Einträge, die den übergebenen Wert haben.

public removeValue(simple $value) : Map

Der Wert muss vom identischen Typ sein, da der Vergleich mittels === erfolgt.

Parameters
$value : simple
Return values
Map —

Dieses Objekt

rewind()

Zurücksetzen des internen Zeigers der Map auf den ersten Eintrag

public rewind() : void

setAcceptCharset()

Setzt den akzeptierten Zeichensatz

public setAcceptCharset(string $value) : Header
Parameters
$value : string

Charset (z.B. utf-8)

Return values
Header —

Dieses Objekt

setContentLength()

Die Anzahl an Bytes für den Requests setzen

public setContentLength(string $value) : Header
Parameters
$value : string

Anzahl

Return values
Header —

Dieses Objekt

setDate()

Datum setzen

public setDate(DateTime $dateTime[, mixed $timezone = null ]) : Header

Setzt das Datum in der Form Tue, 15 Nov 1994 08:12:31 GMT

Parameters
$dateTime : DateTime

Datum

$timezone : mixed = null
Return values
Header —

Dieses Objekt

setEntrySeparator()

Setzt das Trennzeichen für die __toString Methode

public setEntrySeparator(string $separator) : Map
Parameters
$separator : string

Trennzeichen

Return values
Map —

dieses Objekt

setKeyValueSeparator()

Setzt das Trennzeichen für die __toString Methode

public setKeyValueSeparator(string $separator) : Map
Parameters
$separator : string

Trennzeichen

Return values
Map —

dieses Objekt

setMethod()

Eine der gültigen Methoden setzen

public setMethod(string $method) : mixed
Parameters
$method : string

Methode

setProtocol()

Setzt das Protokoll.

public setProtocol(string $protocol) : mixed

Entweder HTTP/1.0 oder HTTP/1.1 werden aktuell unterstützt.

Parameters
$protocol : string

Protokoll

setValue()

Wert setzen

public setValue(string $key, mixed $value) : Map

Setzt den Wert eines Schlüssels auf den Übergebenen Wert.

Parameters
$key : string

Schlüssel in der Map. Wenn der Wert bereits gesetzt wurde, wird er überschrieben.

$value : mixed

Wert des Eintrages (muss ein einfacher Typ sein)

Return values
Map —

Liefert einen Zeiger auf dieses Objekt zurück

toArray()

Werte als Array

public toArray() : array

Die Werte werden nicht angepasst und Maps und Collection bleiben Objekte.

toArray wandelt im Gegensatz zu asArray die Unterwerte nicht um, sondern gibt nur das Array auf oberster Ebene aus.

Return values
array —

Werte

valid()

Prüft ob der interne Zeiger auf ein gültiges Element der Map zeigt.

public valid() : boolean
Return values
boolean —

true wenn das aktuelle Element gültig ist

checkAndAdjustSerialisation()

Dealing with versions

protected checkAndAdjustSerialisation(array $serialization) : array<string|int, mixed>

This method checks an object and ideally repairs older copies. If an old copy cannot be restored be restored, an exception is thrown.

This method must be overridden by the derived classes. be overridden. In the derived class, * the parent method should be called. the parent method should be called.

Parameters
$serialization : array

Daten des serialisiertes Objekts

Tags
throws
UnserializeException

Keine Übereinstimmung

Return values
array<string|int, mixed>

normalize()

Werte überprüfen

protected normalize(array $array) : array<string|int, mixed>

Diese Methode überprüft den Schlüssel und den Wert eines Arrays

Parameters
$array : array

zu überprüfendes Array

Return values
array<string|int, mixed>

normalizeValue()

Bearbeitung des Wertes

protected normalizeValue(string $key, mixed $value) : mixed

Überprüfung ob der Wert der Map ein bestimmter Type ist. Wenn nicht, wird eine TypeException geworfen. Diese Methode kann von abgeleiteten Klassen für die Bearbeitung der Werte verwendet werden.

Parameters
$key : string

Schlüssel für Zugriff

$value : mixed

zu überprüfender Wert

Return values
mixed —

$value Rückgabewert.

parseData()

Daten parsen

protected parseData(string $data) : Header

Die Daten aus dem Header werden analyisert und die entsprechenden Header-Objekte erstellt. Die Header werden dabei in einer Map gespciehrt. Einige Header können mehrfach vorkommen. Hier wird dem Namen des Headers eine forlaufende Zahl mit einem Bindestrich angestellt.

Die erste Zeile im $data muss der Rückgabewert (StatusCode) des Server sein

Set-Cookie Set-Cookie-1 Set-Cookie-2 ...

Parameters
$data : string

Daten

Return values
Header —

Header

prepareOutput()

Ausgabe vorbereiten

protected static prepareOutput(array $properties) : array
Parameters
$properties : array

Schlüssel/Werte

Return values
array —

Ausgabe

setFirstLine()

Erste Zeile setzen

protected abstract setFirstLine(string $line) : Header

Erste Zeile ist sowohl beim Request, als auch beim Response unterschiedlich aufgebaut.

Parameters
$line : string

Linie

Return values
Header —

Header


        

        
    




    

    

                                

                

                                
    

        On this page

        
    


                

                            

            

    

        

            
Search results