<?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.overloading.php',
    1 => '重载',
    2 => '重载',
  ),
  'up' => 
  array (
    0 => 'language.oop5.php',
    1 => '类与对象',
  ),
  'prev' => 
  array (
    0 => 'language.oop5.anonymous.php',
    1 => '匿名类',
  ),
  'next' => 
  array (
    0 => 'language.oop5.iterations.php',
    1 => '遍历对象',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'zh',
    'path' => 'language/oop5/overloading.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="language.oop5.overloading" class="sect1">
  <h2 class="title">重载</h2>

  <p class="para">
   PHP所提供的<q class="quote">重载</q>（overloading）是指动态地<q class="quote">创建</q>类属性和方法。我们是通过魔术方法（magic methods）来实现的。
  </p>

  <p class="para">
   当调用当前环境下未定义或不<a href="language.oop5.visibility.php" class="link">可见</a>的类属性或方法时，重载方法会被调用。本节后面将使用<q class="quote">不可访问属性（inaccessible
   properties）</q>和<q class="quote">不可访问方法（inaccessible
   methods）</q>来称呼这些未定义或不可见的类属性或方法。
  </p>

  <p class="para">
   所有的重载方法都必须被声明为 <code class="literal">public</code>。
  </p>

  <blockquote class="note"><p><strong class="note">注意</strong>: 
   <p class="para">
    这些魔术方法的参数都不能<a href="functions.arguments.php#functions.arguments.by-reference" class="link">通过引用传递</a>。
   </p>
  </p></blockquote>

  <blockquote class="note"><p><strong class="note">注意</strong>: 
   <p class="para">
     PHP中的<q class="quote">重载</q>与其它绝大多数面向对象语言不同。传统的<q class="quote">重载</q>是用于提供多个同名的类方法，但各方法的参数类型和个数不同。
   </p>
  </p></blockquote>

  <div class="sect2" id="language.oop5.overloading.members">
   <h3 class="title">属性重载</h3>

   <div class="methodsynopsis dc-description" id="object.set">
    <span class="modifier">public</span> <span class="methodname"><strong>__set</strong></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$name</code></span>, <span class="methodparam"><span class="type"><a href="language.types.mixed.php" class="type mixed">mixed</a></span> <code class="parameter">$value</code></span>): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>

   <div class="methodsynopsis dc-description" id="object.get"><span class="modifier">public</span> <span class="methodname"><strong>__get</strong></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$name</code></span>): <span class="type"><a href="language.types.mixed.php" class="type mixed">mixed</a></span></div>

   <div class="methodsynopsis dc-description" id="object.isset"><span class="modifier">public</span> <span class="methodname"><strong>__isset</strong></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$name</code></span>): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>

   <div class="methodsynopsis dc-description" id="object.unset"><span class="modifier">public</span> <span class="methodname"><strong>__unset</strong></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$name</code></span>): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>


   <p class="para">
    在给不可访问（protected 或 private）或不存在的属性赋值时，<a href="language.oop5.overloading.php#object.set" class="link">__set()</a> 会被调用。
   </p>

   <p class="para">
    读取不可访问（protected 或 private）或不存在的属性的值时，<a href="language.oop5.overloading.php#object.get" class="link">__get()</a> 会被调用。
   </p>

   <p class="para"> 
    当对不可访问（protected 或 private）或不存在的属性调用 <span class="function"><a href="function.isset.php" class="function">isset()</a></span> 或
    <span class="function"><a href="function.empty.php" class="function">empty()</a></span> 时，<a href="language.oop5.overloading.php#object.isset" class="link">__isset()</a> 
   会被调用。
   </p>

   <p class="para">
    当对不可访问（protected 或 private）或不存在的属性调用 <span class="function"><a href="function.unset.php" class="function">unset()</a></span>
    时，<a href="language.oop5.overloading.php#object.unset" class="link">__unset()</a> 会被调用。
   </p>

   <p class="para">  
    参数 <var class="varname">$name</var> 是指要操作的变量名称。<a href="language.oop5.overloading.php#object.set" class="link">__set()</a>
    方法的 <var class="varname">$value</var> 参数指定了 <var class="varname">$name</var> 变量的值。
   </p>

   <p class="para">
    属性重载只能在对象中进行。在静态方法中，这些魔术方法将不会被调用。所以这些方法都不能被
    声明为 <a href="language.oop5.static.php" class="link">static</a>。将这些魔术方法定义为 <code class="literal">static</code> 会产生一个警告。
   </p>

   <blockquote class="note"><p><strong class="note">注意</strong>: 
    <p class="para">
     因为 PHP 处理赋值运算的方式，<a href="language.oop5.overloading.php#object.set" class="link">__set()</a>
     的返回值将被忽略。类似的, 在下面这样的链式赋值中，<a href="language.oop5.overloading.php#object.get" class="link">__get()</a>
     不会被调用：<code class="literal"><div class="annotation-interactive cdata"><pre> $a = $obj-&gt;b = 8; </pre></div></code>
    </p>
   </p></blockquote>

    <blockquote class="note"><p><strong class="note">注意</strong>: 
    <p class="para">
     PHP 不会在重载方法中再次调用本身。这意味着如果没有定义 <code class="literal">foo</code> 属性，在
     <a href="language.oop5.overloading.php#object.get" class="link">__get()</a> 中执行 <code class="code">return $this-&gt;foo</code>
     将会返回 <code class="literal">null</code> 并引发 <strong><code><a href="errorfunc.constants.php#constant.e-warning">E_WARNING</a></code></strong>，而不是再次调用
     <a href="language.oop5.overloading.php#object.get" class="link">__get()</a>。然而，重载方法可能会隐式调用其它重载方法（比如调用
     <a href="language.oop5.overloading.php#object.set" class="link">__set()</a> 触发 <a href="language.oop5.overloading.php#object.get" class="link">__get()</a>）。
    </p>
   </p></blockquote>

  <div class="example" id="example-1">
    <p><strong>示例 #1 使用 <a href="language.oop5.overloading.php#object.get" class="link">__get()</a>，<a href="language.oop5.overloading.php#object.set" class="link">__set()</a>，<a href="language.oop5.overloading.php#object.isset" class="link">__isset()</a>
    和 <a href="language.oop5.overloading.php#object.unset" class="link">__unset()</a> 进行属性重载</strong></p>
    <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: #007700">class </span><span style="color: #0000BB">PropertyTest </span><span style="color: #007700">{<br />     </span><span style="color: #FF8000">/**  被重载的数据保存在此  */<br />    </span><span style="color: #007700">private </span><span style="color: #0000BB">$data </span><span style="color: #007700">= array();<br /><br /> <br />     </span><span style="color: #FF8000">/**  重载不能被用在已经定义的属性  */<br />    </span><span style="color: #007700">public </span><span style="color: #0000BB">$declared </span><span style="color: #007700">= </span><span style="color: #0000BB">1</span><span style="color: #007700">;<br /><br />     </span><span style="color: #FF8000">/**  只有从类外部访问这个属性时，重载才会发生 */<br />    </span><span style="color: #007700">private </span><span style="color: #0000BB">$hidden </span><span style="color: #007700">= </span><span style="color: #0000BB">2</span><span style="color: #007700">;<br /><br />    public function </span><span style="color: #0000BB">__set</span><span style="color: #007700">(</span><span style="color: #0000BB">$name</span><span style="color: #007700">, </span><span style="color: #0000BB">$value</span><span style="color: #007700">) <br />    {<br />        echo </span><span style="color: #DD0000">"Setting '</span><span style="color: #0000BB">$name</span><span style="color: #DD0000">' to '</span><span style="color: #0000BB">$value</span><span style="color: #DD0000">'\n"</span><span style="color: #007700">;<br />        </span><span style="color: #0000BB">$this</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">data</span><span style="color: #007700">[</span><span style="color: #0000BB">$name</span><span style="color: #007700">] = </span><span style="color: #0000BB">$value</span><span style="color: #007700">;<br />    }<br /><br />    public function </span><span style="color: #0000BB">__get</span><span style="color: #007700">(</span><span style="color: #0000BB">$name</span><span style="color: #007700">) <br />    {<br />        echo </span><span style="color: #DD0000">"Getting '</span><span style="color: #0000BB">$name</span><span style="color: #DD0000">'\n"</span><span style="color: #007700">;<br />        if (</span><span style="color: #0000BB">array_key_exists</span><span style="color: #007700">(</span><span style="color: #0000BB">$name</span><span style="color: #007700">, </span><span style="color: #0000BB">$this</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">data</span><span style="color: #007700">)) {<br />            return </span><span style="color: #0000BB">$this</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">data</span><span style="color: #007700">[</span><span style="color: #0000BB">$name</span><span style="color: #007700">];<br />        }<br /><br />        </span><span style="color: #0000BB">$trace </span><span style="color: #007700">= </span><span style="color: #0000BB">debug_backtrace</span><span style="color: #007700">();<br />        </span><span style="color: #0000BB">trigger_error</span><span style="color: #007700">(<br />            </span><span style="color: #DD0000">'Undefined property via __get(): ' </span><span style="color: #007700">. </span><span style="color: #0000BB">$name </span><span style="color: #007700">.<br />            </span><span style="color: #DD0000">' in ' </span><span style="color: #007700">. </span><span style="color: #0000BB">$trace</span><span style="color: #007700">[</span><span style="color: #0000BB">0</span><span style="color: #007700">][</span><span style="color: #DD0000">'file'</span><span style="color: #007700">] .<br />            </span><span style="color: #DD0000">' on line ' </span><span style="color: #007700">. </span><span style="color: #0000BB">$trace</span><span style="color: #007700">[</span><span style="color: #0000BB">0</span><span style="color: #007700">][</span><span style="color: #DD0000">'line'</span><span style="color: #007700">],<br />            </span><span style="color: #0000BB">E_USER_NOTICE</span><span style="color: #007700">);<br />        return </span><span style="color: #0000BB">null</span><span style="color: #007700">;<br />    }<br /><br />    public function </span><span style="color: #0000BB">__isset</span><span style="color: #007700">(</span><span style="color: #0000BB">$name</span><span style="color: #007700">) <br />    {<br />        echo </span><span style="color: #DD0000">"Is '</span><span style="color: #0000BB">$name</span><span style="color: #DD0000">' set?\n"</span><span style="color: #007700">;<br />        return isset(</span><span style="color: #0000BB">$this</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">data</span><span style="color: #007700">[</span><span style="color: #0000BB">$name</span><span style="color: #007700">]);<br />    }<br /><br />    public function </span><span style="color: #0000BB">__unset</span><span style="color: #007700">(</span><span style="color: #0000BB">$name</span><span style="color: #007700">) <br />    {<br />        echo </span><span style="color: #DD0000">"Unsetting '</span><span style="color: #0000BB">$name</span><span style="color: #DD0000">'\n"</span><span style="color: #007700">;<br />        unset(</span><span style="color: #0000BB">$this</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">data</span><span style="color: #007700">[</span><span style="color: #0000BB">$name</span><span style="color: #007700">]);<br />    }<br /><br />    </span><span style="color: #FF8000">/**  非魔术方法  */<br />    </span><span style="color: #007700">public function </span><span style="color: #0000BB">getHidden</span><span style="color: #007700">() <br />    {<br />        return </span><span style="color: #0000BB">$this</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">hidden</span><span style="color: #007700">;<br />    }<br />}<br /><br /><br /></span><span style="color: #0000BB">$obj </span><span style="color: #007700">= new </span><span style="color: #0000BB">PropertyTest</span><span style="color: #007700">;<br /><br /></span><span style="color: #0000BB">$obj</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">a </span><span style="color: #007700">= </span><span style="color: #0000BB">1</span><span style="color: #007700">;<br />echo </span><span style="color: #0000BB">$obj</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">a </span><span style="color: #007700">. </span><span style="color: #DD0000">"\n\n"</span><span style="color: #007700">;<br /><br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(isset(</span><span style="color: #0000BB">$obj</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">a</span><span style="color: #007700">));<br />unset(</span><span style="color: #0000BB">$obj</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">a</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(isset(</span><span style="color: #0000BB">$obj</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">a</span><span style="color: #007700">));<br />echo </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br /><br />echo </span><span style="color: #0000BB">$obj</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">declared </span><span style="color: #007700">. </span><span style="color: #DD0000">"\n\n"</span><span style="color: #007700">;<br /><br />echo </span><span style="color: #DD0000">"Let's experiment with the private property named 'hidden':\n"</span><span style="color: #007700">;<br />echo </span><span style="color: #DD0000">"Privates are visible inside the class, so __get() not used...\n"</span><span style="color: #007700">;<br />echo </span><span style="color: #0000BB">$obj</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">getHidden</span><span style="color: #007700">() . </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />echo </span><span style="color: #DD0000">"Privates not visible outside of class, so __get() is used...\n"</span><span style="color: #007700">;<br />echo </span><span style="color: #0000BB">$obj</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">hidden </span><span style="color: #007700">. </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

    <div class="example-contents"><p>以上示例会输出：</p></div>
    <div class="example-contents screen">
<div class="annotation-interactive cdata"><pre>
Setting &#039;a&#039; to &#039;1&#039;
Getting &#039;a&#039;
1

Is &#039;a&#039; set?
bool(true)
Unsetting &#039;a&#039;
Is &#039;a&#039; set?
bool(false)

1

Let&#039;s experiment with the private property named &#039;hidden&#039;:
Privates are visible inside the class, so __get() not used...
2
Privates not visible outside of class, so __get() is used...
Getting &#039;hidden&#039;


Notice:  Undefined property via __get(): hidden in &lt;file&gt; on line 70 in &lt;file&gt; on line 29
</pre></div>
    </div>

   </div>
  </div>

  <div class="sect2" id="language.oop5.overloading.methods">
   <h3 class="title">方法重载</h3>

   <div class="methodsynopsis dc-description" id="object.call">
    <span class="modifier">public</span> <span class="methodname"><strong>__call</strong></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$name</code></span>, <span class="methodparam"><span class="type"><a href="language.types.array.php" class="type array">array</a></span> <code class="parameter">$arguments</code></span>): <span class="type"><a href="language.types.mixed.php" class="type mixed">mixed</a></span></div>

   <div class="methodsynopsis dc-description" id="object.callstatic"><span class="modifier">public static</span> <span class="methodname"><strong>__callStatic</strong></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$name</code></span>, <span class="methodparam"><span class="type"><a href="language.types.array.php" class="type array">array</a></span> <code class="parameter">$arguments</code></span>): <span class="type"><a href="language.types.mixed.php" class="type mixed">mixed</a></span></div>


   <p class="para">
    在对象中调用一个不可访问方法时，<a href="language.oop5.overloading.php#object.call" class="link">__call()</a> 会被调用。
   </p>

   <p class="para">
    在静态上下文中调用一个不可访问方法时，<a href="language.oop5.overloading.php#object.callstatic" class="link">__callStatic()</a> 会被调用。
   </p>

   <p class="para"> 
    <var class="varname">$name</var> 参数是要调用的方法名称。<var class="varname">$arguments</var>
    参数是一个枚举数组，包含着要传递给方法 <var class="varname">$name</var> 的参数。
   </p>

   <div class="example" id="example-2">
    <p><strong>示例 #2 使用 <a href="language.oop5.overloading.php#object.call" class="link">__call()</a>
    和 <a href="language.oop5.overloading.php#object.callstatic" class="link">__callStatic()</a> 对方法重载</strong></p>
    <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: #007700">class </span><span style="color: #0000BB">MethodTest <br /></span><span style="color: #007700">{<br />    public function </span><span style="color: #0000BB">__call</span><span style="color: #007700">(</span><span style="color: #0000BB">$name</span><span style="color: #007700">, </span><span style="color: #0000BB">$arguments</span><span style="color: #007700">) <br />    {<br />        </span><span style="color: #FF8000">// 注意: $name 的值区分大小写<br />        </span><span style="color: #007700">echo </span><span style="color: #DD0000">"Calling object method '</span><span style="color: #0000BB">$name</span><span style="color: #DD0000">' "<br />             </span><span style="color: #007700">. </span><span style="color: #0000BB">implode</span><span style="color: #007700">(</span><span style="color: #DD0000">', '</span><span style="color: #007700">, </span><span style="color: #0000BB">$arguments</span><span style="color: #007700">). </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />    }<br /><br />    public static function </span><span style="color: #0000BB">__callStatic</span><span style="color: #007700">(</span><span style="color: #0000BB">$name</span><span style="color: #007700">, </span><span style="color: #0000BB">$arguments</span><span style="color: #007700">) <br />    {<br />        </span><span style="color: #FF8000">// 注意: $name 的值区分大小写<br />        </span><span style="color: #007700">echo </span><span style="color: #DD0000">"Calling static method '</span><span style="color: #0000BB">$name</span><span style="color: #DD0000">' "<br />             </span><span style="color: #007700">. </span><span style="color: #0000BB">implode</span><span style="color: #007700">(</span><span style="color: #DD0000">', '</span><span style="color: #007700">, </span><span style="color: #0000BB">$arguments</span><span style="color: #007700">). </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />    }<br />}<br /><br /></span><span style="color: #0000BB">$obj </span><span style="color: #007700">= new </span><span style="color: #0000BB">MethodTest</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$obj</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">runTest</span><span style="color: #007700">(</span><span style="color: #DD0000">'in object context'</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">MethodTest</span><span style="color: #007700">::</span><span style="color: #0000BB">runTest</span><span style="color: #007700">(</span><span style="color: #DD0000">'in static context'</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

    <div class="example-contents"><p>以上示例会输出：</p></div>
    <div class="example-contents screen">
<div class="annotation-interactive cdata"><pre>
Calling object method &#039;runTest&#039; in object context
Calling static method &#039;runTest&#039; in static context
</pre></div>
    </div>
   </div>

  </div>

 </div><?php manual_footer($setup); ?>