SoapServer->setPersistence()
(PHP 5, PHP 7, PHP 8)
SoapServer->setPersistence() — Versetzt einen SoapServer in den Persistenz-Modus
Beschreibung
$mode): voidDiese Funktion erlaubt das Ändern des Persistenzzustands eines SoapServer Objekts zwischen Anfragen. Diese Funktion erlaubt das Speichern von Daten zwischen Anfragen durch Verwendung von PHP Sessions. Diese Methode hat nur Auswirkungen auf den SoapServer, nachdem er Funktionen unter Verwendung von SoapServer::setClass() exportiert hat.
Hinweis:
Die Option
SOAP_PERSISTENCE_SESSIONmacht nur Objekte der angegebenen Klasse persistent, nicht aber ihre statischen Eigenschaften. Daher sollten sie $this->bar anstatt von self::$bar nutzen.
Hinweis:
SOAP_PERSISTENCE_SESSIONserialisiert Daten des Klassenobjekts zwischen Anfragen. Damit Ressourcen (z.B. PDO) ordnungsgemäß verwendet werden können, sollten die magischen __wakeup() und __sleep() Methoden verwendet werden.
Parameter-Liste
-
mode -
Eine der
SOAP_PERSISTENCE_XXXKonstanten.SOAP_PERSISTENCE_REQUEST- SoapServer Daten bleiben zwischen Anfragen nicht erhalten. Das ist das standardmäßige Verhalten von jedem SoapServer Objekt nachdem setClass aufgerufen wurde.SOAP_PERSISTENCE_SESSION- SoapServer Daten bleiben zwischen Anfragen erhalten. Dies wird durch Serialisierung der SoapServer Klassendaten in $_SESSION['_bogus_session_name'] erreicht, weshalb session_start() aufgerufen werden muss, bevor dieser Persistenzmodus eingestellt wird.
Rückgabewerte
Es wird kein Wert zurückgegeben.
Beispiele
Beispiel #1 SoapServer::setPersistence() Beispiel
<?php
class MyFirstPersistentSoapServer {
private $resource; // (wie z.B. PDO, mysqli, usw.)
public $myvar1;
public $myvar2;
public function __construct() {
$this->__wakeup(); // Wir rufen unser wakeup auf, damit die Ressource verwendet werden kann
}
public function __wakeup() {
$this->resource = CodeToStartOurResourceUp();
}
public function __sleep() {
// Wir stellen sicher, dass $resource hier ausgelassen wird, damit
// unsere Sessiondaten persistent bleiben. Versäumen wir dies, wird das
// Deserialisieren der Daten bei der nächsten Anfrage fehlschlagen;
// folglich wäre unser SoapObject nicht anfrageübergreifend persistent.
return array('myvar1','myvar2');
}
}
try {
session_start();
$server = new SoapServer(null, array('uri' => $_SERVER['REQUEST_URI']));
$server->setClass('MyFirstPersistentSoapServer');
// setPersistence MUSS nach setClass aufgerufen werden, weil setClass
// SESSION_PERSISTENCE_REQUEST setzt sobald die Methode ausgeführt wird.
$server->setPersistence(SOAP_PERSISTENCE_SESSION);
$server->handle();
} catch(SoapFault $e) {
error_log("SOAP FEHLER: ". $e->getMessage());
}
?>
