setpersistence.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 89ae180a851621c308f0ea4604ff2e919aa57a7f Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="soapserver.setpersistence" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
  <refname>SoapServer::setPersistence</refname>
  <refpurpose>Устанавливает режим сохранения SoapServer</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis role="SoapServer">
   <modifier>public</modifier> <type>void</type><methodname>SoapServer::setPersistence</methodname>
   <methodparam><type>int</type><parameter>mode</parameter></methodparam>
  </methodsynopsis>
  <para>
   Эта функция позволяет изменять режим сохранения объекта SoapServer между
   запросами. Эта функция позволяет сохранять данные между запросами используя
   механизм сессий PHP. Этот метод влияет только на SoapServer после экспорта функций,
   используя <methodname>SoapServer::setClass</methodname>.
  </para>
  <note>
   <para>
    Сохранение <constant>SOAP_PERSISTENCE_SESSION</constant> гарантирует
    сохранение только объектов заданного класса, но не статические данные класса.
    В этом случае используйте <varname>$this->bar</varname> вместо self::$bar.
   </para>
  </note>
  <note>
   <para>
    <constant>SOAP_PERSISTENCE_SESSION</constant> сериализует данные объекта
    класса и сохраняет их между запросами. Для корректной работы с ресурсами
    (например, <classname>PDO</classname>),
    следует использовать магические методы
    <link linkend="object.wakeup">__wakeup()</link> и
    <link linkend="object.sleep">__sleep()</link>.
   </para>
  </note>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>mode</parameter></term>
     <listitem>
      <para>
       Одна из констант <constant>SOAP_PERSISTENCE_<replaceable>*</replaceable></constant>.
      </para>
      <para>
       <constant>SOAP_PERSISTENCE_REQUEST</constant> - данные SoapServer не сохраняются
       между запросами. Это поведение <emphasis role="bold">по умолчанию</emphasis>
       любого объекта SoapServer после вызова setClass.
      </para>
      <para>
       <constant>SOAP_PERSISTENCE_SESSION</constant> - данные SoapServer сохраняются
       между запросами. Это достигается путём сериализации объекта SoapServer в
       <varname>$_SESSION['_bogus_session_name']</varname>, следовательно
       необходимо вызвать <function>session_start</function> перед включением этого режима.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   &return.void;
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Пример использования <function>SoapServer::setPersistence</function></title>
    <programlisting role="php">
<![CDATA[
<?php
 class MyFirstPersistentSoapServer {
     private $resource; // (Такие как PDO, mysqli и т.д.)
     public $myvar1;
     public $myvar2;

     public function __construct() {
         $this->__wakeup(); // Вызываем __wakeup для пересоздания $resource
     }

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

     public function __sleep() {
         // Не сохраняем $resource здесь.
         // Ошибка в этом методе приведёт к тому, что при последующей десериализации
         // мы не сможем восстановить состояние объекта.
         return array('myvar1','myvar2');
     }
 }

 try {
     session_start();
     $server = new SoapServer(null, array('uri' => $_SERVER['REQUEST_URI']));
     $server->setClass('MyFirstPersistentSoapServer');
     // setPersistence НЕОБХОДИМО вызвать после setClass, поскольку setClass
     // принудительно устанавливает SESSION_PERSISTENCE_REQUEST.
     $server->setPersistence(SOAP_PERSISTENCE_SESSION);
     $server->handle();
 } catch(SoapFault $e) {
     error_log("ОШИБКА SOAP: ". $e->getMessage());
 }
?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><methodname>SoapServer::setClass</methodname></member>
   </simplelist>
  </para>
 </refsect1>

</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->