<?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 => 'zh',
  ),
  'this' => 
  array (
    0 => 'language.oop5.serialization.php',
    1 => '对象序列化',
    2 => '序列化对象 - 在会话中存放对象',
  ),
  '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' => 'zh',
    '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">
   所有 PHP 里面的值都可以使用函数 <span class="function"><a href="function.serialize.php" class="function">serialize()</a></span> 来返回一个包含字节流的字符串来表示。<span class="function"><a href="function.unserialize.php" class="function">unserialize()</a></span>
   函数能够重新把字符串变回 PHP 原来的值。序列化一个对象将会保存对象的所有变量，但是不会保存对象的方法，只会保存类的名字。
  </p>

  <p class="para">
   为了能够 <span class="function"><a href="function.unserialize.php" class="function">unserialize()</a></span> 一个对象，这个对象的类必须已经定义过。如果序列化类 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 />  // 要正确反序列化，必须包含下面一个文件<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">// 现在可以使用对象$a里面的函数 show_one()<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">
   在应用程序中序列化对象以便在之后使用，强烈推荐在整个应用程序都包含对象的类的定义。
   不然有可能出现在反序列化对象的时候，没有找到该对象的类的定义，从而把没有方法的类 <span class="classname"><strong class="classname">__PHP_Incomplete_Class_Name</strong></span> 作为该对象的类，导致返回一个没有用的对象。
  </p>

  <p class="para">
   所以在上面的例子中，通过在 <var class="varname"><a href="reserved.variables.session.php" class="classname">$_SESSION</a></var> 超全局数组中添加新的键，把变量 <var class="varname">$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); ?>