SoapServer::setPersistence

    (PHP 5, PHP 7, PHP 8)

    SoapServer::setPersistence — Active le mode persistant de SoapServer

    Description

    publicSoapServer::setPersistence(int$mode): void

    Cette fonction permet de changer la persistance d'un objet SoapServer entre les requêtes. Elle permet de sauvegarder les données entre les requêtes, au moyen des sessions PHP. Cette fonction n'a d'effet qu'après avoir exporté la liste des fonctions au moyen de SoapServer::setClass().

    Note:

    La constante de persistence SOAP_PERSISTENCE_SESSION rend uniquement les objets de la classe donnée persistants, mais non pas les données statiques. Dans ce cas, $this->bar au lieu de self::$bar.

    Note:

    SOAP_PERSISTENCE_SESSION serialise les données de l'objet entre les requêtes. Dans le cas des ressources, (par exemple PDO), __wakeup() et __sleep() devraient être utilisées.

    Liste de paramètres

    mode

    Une des constantes suivantes :

    SOAP_PERSISTENCE_REQUEST - Les données de SoapServer ne sont pas persistantes entre les requêtes. C'est le comportement par défaut de tout objet SoapServer après appel à setClass().

    SOAP_PERSISTENCE_SESSION - Les données de SoapServer persistent entre les requêtes. Ceci est réalisé en sérialisant les données de la classe SoapServer dans $_SESSION['_bogus_session_name'], et ainsi session_start() doit être appelée avant de passer sous ce mode de persistance.

    Valeurs de retour

    Aucune valeur n'est retournée.

    Exemples

    Exemple #1 Exemple SoapServer::setPersistence()

    <?php
    class MyFirstPersistentSoapServer {
    private     $resource; // (Par exemple PDO, mysqli, etc..)
    public $myvar1;
    public     $myvar2;

    public function     __construct() {
    $this->__wakeup(); // On appelle notre wakeup pour relancer notre ressource
    }

    public function     __wakeup() {
    $this->resource = CodeToStartOurResourceUp();
    }

    public function     __sleep() {
    // On s'assure d'enlever $resource ici, ainsi nos données peuvent persister en session

    Voir aussi

    To Top