(PHP 5, PHP 7)
SoapServer->setPersistence() — Versetzt einen SoapServer in den Persistenz-Modus
$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.
mode
Eine der SOAP_PERSISTENCE_XXX Konstanten.
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.
Es wird kein Wert zurückgegeben.
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());
}
?>