<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/language.oop5.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ru',
  ),
  'this' => 
  array (
    0 => 'language.oop5.serialization.php',
    1 => 'Сериализация объектов',
    2 => 'Сериализация объектов &mdash; сохранение объектов между сессиями',
  ),
  'up' => 
  array (
    0 => 'language.oop5.php',
    1 => 'Классы и объекты',
  ),
  'prev' => 
  array (
    0 => 'language.oop5.references.php',
    1 => 'Объекты и ссылки',
  ),
  'next' => 
  array (
    0 => 'language.oop5.variance.php',
    1 => 'Ковариантность и контравариантность',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ru',
    'path' => 'language/oop5/serialization.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="language.oop5.serialization" class="sect1">
 <h2 class="title">Сериализация объектов — сохранение объектов между сессиями</h2>
 

 <p class="para">
  Функция <span class="function"><a href="function.serialize.php" class="function">serialize()</a></span> возвращает
  строковое представление любого значения, которое может быть сохранено в
  PHP. Функция <span class="function"><a href="function.unserialize.php" class="function">unserialize()</a></span> может использовать эту строку для
  восстановления исходного значения переменной. Использование сериализации для
  сохранения объекта сохранит все его переменные. Методы в объекте не будут сохранены,
  только имя класса.
 </p>

 <p class="para">
  Чтобы десериализовать объект функцией <span class="function"><a href="function.unserialize.php" class="function">unserialize()</a></span>,
  необходимо заранее определить класс этого объекта. То есть, если
  есть экземпляр класса А, и он будет сериализован,
  будет получено его строковое представление,
  которое содержит значение всех переменных, содержащихся в нем.
  Чтобы восстановить объект из строки в другом PHP-файле,
  класс A должен быть определён в этом файле заранее.
  Это можно сделать, например, путём сохранения определения класса A в отдельном файле
  и подключения этого файла или вызовом функции
  <span class="function"><a href="function.spl-autoload-register.php" class="function">spl_autoload_register()</a></span> для автоматического подключения.
 </p>

 <div class="informalexample">
  <div class="example-contents">
<div class="annotation-interactive phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #FF8000">// A.php:<br /><br />  </span><span style="color: #007700">class </span><span style="color: #0000BB">A </span><span style="color: #007700">{<br />      public </span><span style="color: #0000BB">$one </span><span style="color: #007700">= </span><span style="color: #0000BB">1</span><span style="color: #007700">;<br /><br />      public function </span><span style="color: #0000BB">show_one</span><span style="color: #007700">() {<br />          echo </span><span style="color: #0000BB">$this</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">one</span><span style="color: #007700">;<br />      }<br />  }<br /><br /></span><span style="color: #FF8000">// page1.php:<br /><br />  </span><span style="color: #007700">include </span><span style="color: #DD0000">"A.php"</span><span style="color: #007700">;<br /><br />  </span><span style="color: #0000BB">$a </span><span style="color: #007700">= new </span><span style="color: #0000BB">A</span><span style="color: #007700">;<br />  </span><span style="color: #0000BB">$s </span><span style="color: #007700">= </span><span style="color: #0000BB">serialize</span><span style="color: #007700">(</span><span style="color: #0000BB">$a</span><span style="color: #007700">);<br />  </span><span style="color: #FF8000">// сохраняем $s где-нибудь, откуда page2.php сможет его получить.<br />  </span><span style="color: #0000BB">file_put_contents</span><span style="color: #007700">(</span><span style="color: #DD0000">'store'</span><span style="color: #007700">, </span><span style="color: #0000BB">$s</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">// page2.php:<br /><br />  // это нужно для того, чтобы функция unserialize работала правильно.<br />  </span><span style="color: #007700">include </span><span style="color: #DD0000">"A.php"</span><span style="color: #007700">;<br /><br />  </span><span style="color: #0000BB">$s </span><span style="color: #007700">= </span><span style="color: #0000BB">file_get_contents</span><span style="color: #007700">(</span><span style="color: #DD0000">'store'</span><span style="color: #007700">);<br />  </span><span style="color: #0000BB">$a </span><span style="color: #007700">= </span><span style="color: #0000BB">unserialize</span><span style="color: #007700">(</span><span style="color: #0000BB">$s</span><span style="color: #007700">);<br /><br />  </span><span style="color: #FF8000">// теперь можно использовать метод show_one() объекта $a.<br />  </span><span style="color: #0000BB">$a</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">show_one</span><span style="color: #007700">();<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
  </div>

 </div>

 <p class="para">
  Если в приложении сериализуются объекты, которые будут использованы в приложении позже,
  следуют строгой рекомендации — подключать определение класса
  для этого объекта во всём приложении. При невыполнении этого требования десериализация объекта
  пройдёт и без определения класса, но PHP назначит этому объекту
  класс <span class="classname"><strong class="classname">__PHP_Incomplete_Class_Name</strong></span>,
  у которого нет методов, и сделает объект бесполезным.
 </p>

 <p class="para">
  Поэтому, как в примере выше, если переменная <var class="varname">$a</var> стала частью сессии
  путём добавления нового ключа в суперглобальный массив <var class="varname"><a href="reserved.variables.session.php" class="classname">$_SESSION</a></var>,
  нужно подключать файл <code class="literal">A.php</code> на всех страницах,
  а не только на страницах <var class="filename">page1.php</var> и <var class="filename">page2.php</var>.
 </p>

 <p class="para">
  Обратите внимание, что, кроме уже приведённого совета, можно подключиться к событиям
  сериализации и десериализации объекта через методы
  <a href="language.oop5.magic.php#object.sleep" class="link">__sleep()</a>
  и <a href="language.oop5.magic.php#object.wakeup" class="link">__wakeup()</a>.
  В методе <a href="language.oop5.magic.php#object.sleep" class="link">__sleep()</a>
  можно управлять тем, какие свойства объекта будут сериализованы.
 </p>
</div><?php manual_footer($setup); ?>