Versetzt einen SoapServer in den Persistenz-Modus

# SoapServer->setPersistence()

(PHP 5, PHP 7, PHP 8)

SoapServer->setPersistence() — Versetzt einen SoapServer in den Persistenz-Modus

### Beschreibung

public function SoapServer::setPersistence(int `$mode`): void

Diese 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_SESSION` macht nur Objekte der angegebenen Klasse persistent, nicht aber ihre statischen Eigenschaften. Daher sollten sie $this->bar anstatt von self::$bar nutzen.

> Hinweis:

> `SOAP_PERSISTENCE_SESSION` serialisiert Daten des Klassenobjekts zwischen Anfragen. Damit Ressourcen (z. B. PDO) ordnungsgemäß verwendet werden können, sollten die magischen Methoden __wakeup() und __sleep() verwendet werden.

### Parameter-Liste

`mode`

  Eine der `SOAP_PERSISTENCE_*`-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.

### 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());
     }
    ?>

### Siehe auch

- SoapServer::setClass() - Setzt die Klasse, welche SOAP-Anfragen verarbeitet

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open