<?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 => 'pt_BR',
  ),
  'this' => 
  array (
    0 => 'language.oop5.late-static-bindings.php',
    1 => 'Vincula&ccedil;&otilde;es Est&aacute;ticas Tardias',
    2 => 'Vincula&ccedil;&otilde;es Est&aacute;ticas Tardias',
  ),
  'up' => 
  array (
    0 => 'language.oop5.php',
    1 => 'Classes e Objetos',
  ),
  'prev' => 
  array (
    0 => 'language.oop5.object-comparison.php',
    1 => 'Comparando Objetos',
  ),
  'next' => 
  array (
    0 => 'language.oop5.references.php',
    1 => 'Objetos e Refer&ecirc;ncias',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'pt_BR',
    'path' => 'language/oop5/late-static-bindings.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="language.oop5.late-static-bindings" class="sect1">
  <h2 class="title">Vinculações Estáticas Tardias</h2>
  <p class="para">
   O PHP implementa um recurso chamado Vinculações Estáticas Tardias que
   pode ser usado para referenciar a classe chamada no contexto de herança estática.
  </p>

  <p class="para">
   Mais precisamente, as Vinculações Estáticas Tardias funcionam através do armazenamento do nome da classe na
   última &quot;chamada não encaminhada&quot;. No caso de chamadas a métodos estáticos, é a
   classe explicitamente chamada (normalmente o nome à esquerda do operador
   <a href="language.oop5.paamayim-nekudotayim.php" class="link"><code class="literal">::</code></a>);
   no caso de chamadas a métodos não estáticos, é o nome da classe do objeto. Uma
   &quot;chamada encaminhada&quot; é àquela estática, realizada pelos prefixos <code class="literal">self::</code>,
   <code class="literal">parent::</code>, <code class="literal">static::</code>, ou, se subindo
   na hierarquia de classes, <span class="function"><a href="function.forward-static-call.php" class="function">forward_static_call()</a></span>.
   

   A função <span class="function"><a href="function.get-called-class.php" class="function">get_called_class()</a></span> pode ser utilizada para recuperar
   uma string com o nome da classe chamada e <code class="literal">static::</code>
   introduz seu escopo.
  </p>

  <p class="para">
   Esse recurso foi chamado de &quot;Vinculações Estáticas Tardias&quot; de uma perspectiva interna em
   mente. &quot;Vinculação tardia&quot; vem do fato que <code class="literal">static::</code>
   não será resolvido usando a classe onde o método foi definido, mas
   computada utilizando informações em tempo de execução.

   É também chamado &quot;vinculação estática&quot; pois pode ser utilizado em (mas não
   limitado a) chamadas de métodos estáticos.
  </p>

  <div class="sect2" id="language.oop5.late-static-bindings.self">
   <h3 class="title">Limitações do <code class="literal">self::</code></h3>
   <p class="para">
    Referências estáticas para a atual classe como <code class="literal">self::</code> ou
    <code class="literal">__CLASS__</code> são resolvidas usando a classe na qual
    a função pertence, como onde ele foi definido:
   </p>
   <div class="example" id="example-1">
    <p><strong>Exemplo #1 Uso do <code class="literal">self::</code></strong></p>
    <div class="example-contents">
<div class="annotation-interactive phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br /></span><span style="color: #007700">class </span><span style="color: #0000BB">A<br /></span><span style="color: #007700">{<br />    public static function </span><span style="color: #0000BB">who</span><span style="color: #007700">()<br />    {<br />        echo </span><span style="color: #0000BB">__CLASS__</span><span style="color: #007700">;<br />    }<br /><br />    public static function </span><span style="color: #0000BB">test</span><span style="color: #007700">()<br />    {<br />        </span><span style="color: #0000BB">self</span><span style="color: #007700">::</span><span style="color: #0000BB">who</span><span style="color: #007700">();<br />    }<br />}<br /><br />class </span><span style="color: #0000BB">B </span><span style="color: #007700">extends </span><span style="color: #0000BB">A<br /></span><span style="color: #007700">{<br />    public static function </span><span style="color: #0000BB">who</span><span style="color: #007700">()<br />    {<br />        echo </span><span style="color: #0000BB">__CLASS__</span><span style="color: #007700">;<br />    }<br />}<br /><br /></span><span style="color: #0000BB">B</span><span style="color: #007700">::</span><span style="color: #0000BB">test</span><span style="color: #007700">();<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

    <div class="example-contents"><p>O exemplo acima produzirá:</p></div>
    <div class="example-contents screen">
<div class="annotation-interactive cdata"><pre>
A
</pre></div>
    </div>
   </div>

  </div>

  <div class="sect2" id="language.oop5.late-static-bindings.usage">
   <h3 class="title">Uso de Vinculações Estáticas Tardias</h3>

   <p class="para">
    Vinculações Estáticas Tardias tentam resolver a limitação introduzindo uma
    palavra-chave que referencia a classe que foi inicialmente chamada em tempo de execução.
    Basicamente, é uma palavra-chave que permite referenciar
    <code class="literal">B</code> em <code class="literal">test()</code>, no exemplo
    anterior. Foi decidido não introduzir uma nova palavra-chave, mas usar
    <code class="literal">static</code>, já reservada.
   </p>

   <div class="example" id="example-2">
    <p><strong>Exemplo #2 Uso simples de <code class="literal">static::</code></strong></p>
    <div class="example-contents">
<div class="annotation-interactive phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br /></span><span style="color: #007700">class </span><span style="color: #0000BB">A<br /></span><span style="color: #007700">{<br />    public static function </span><span style="color: #0000BB">who</span><span style="color: #007700">()<br />    {<br />        echo </span><span style="color: #0000BB">__CLASS__</span><span style="color: #007700">;<br />    }<br /><br />    public static function </span><span style="color: #0000BB">test</span><span style="color: #007700">()<br />    {<br />        static::</span><span style="color: #0000BB">who</span><span style="color: #007700">(); </span><span style="color: #FF8000">// Aqui acontecem as Vinculações Estáticas Tardias<br />    </span><span style="color: #007700">}<br />}<br /><br />class </span><span style="color: #0000BB">B </span><span style="color: #007700">extends </span><span style="color: #0000BB">A<br /></span><span style="color: #007700">{<br />    public static function </span><span style="color: #0000BB">who</span><span style="color: #007700">()<br />    {<br />        echo </span><span style="color: #0000BB">__CLASS__</span><span style="color: #007700">;<br />    }<br />}<br /><br /></span><span style="color: #0000BB">B</span><span style="color: #007700">::</span><span style="color: #0000BB">test</span><span style="color: #007700">();<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

    <div class="example-contents"><p>O exemplo acima produzirá:</p></div>
    <div class="example-contents screen">
<div class="annotation-interactive cdata"><pre>
B
</pre></div>
    </div>
   </div>
   <blockquote class="note"><p><strong class="note">Nota</strong>: 
    <p class="para">
     Em contextos não estáticos, a classe chamada será a classe da instância
     do objeto. Assim como <code class="literal">$this-&gt;</code> chamará métodos privados
     do mesmo escopo, utilizar <code class="literal">static::</code> pode ter
     resultados diferentes. Outra diferença é que <code class="literal">static::</code>
     só pode referenciar propriedades estáticas.
    </p>
   </p></blockquote>
   <div class="example" id="example-3">
    <p><strong>Exemplo #3 Uso de <code class="literal">static::</code> em um contexto não-estático</strong></p>
    <div class="example-contents">
<div class="annotation-interactive phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br /></span><span style="color: #007700">class </span><span style="color: #0000BB">A<br /></span><span style="color: #007700">{<br />    private function </span><span style="color: #0000BB">foo</span><span style="color: #007700">()<br />    {<br />        echo </span><span style="color: #DD0000">"successo!\n"</span><span style="color: #007700">;<br />    }<br /><br />    public function </span><span style="color: #0000BB">test</span><span style="color: #007700">()<br />    {<br />        </span><span style="color: #0000BB">$this</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">foo</span><span style="color: #007700">();<br />        static::</span><span style="color: #0000BB">foo</span><span style="color: #007700">();<br />    }<br />}<br /><br />class </span><span style="color: #0000BB">B </span><span style="color: #007700">extends </span><span style="color: #0000BB">A<br /></span><span style="color: #007700">{<br />   </span><span style="color: #FF8000">/* foo() será copiado para B, assim seu escopo ainda será A e<br />    * e a chamada funcionará */<br /></span><span style="color: #007700">}<br /><br />class </span><span style="color: #0000BB">C </span><span style="color: #007700">extends </span><span style="color: #0000BB">A<br /></span><span style="color: #007700">{<br />    private function </span><span style="color: #0000BB">foo</span><span style="color: #007700">()<br />    {<br />        </span><span style="color: #FF8000">/* método original foi substituído, escopo agora é C */<br />    </span><span style="color: #007700">}<br />}<br /><br /></span><span style="color: #0000BB">$b </span><span style="color: #007700">= new </span><span style="color: #0000BB">B</span><span style="color: #007700">();<br /></span><span style="color: #0000BB">$b</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">test</span><span style="color: #007700">();<br /><br /></span><span style="color: #0000BB">$c </span><span style="color: #007700">= new </span><span style="color: #0000BB">C</span><span style="color: #007700">();<br />try {<br />    </span><span style="color: #0000BB">$c</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">test</span><span style="color: #007700">();<br />} catch (</span><span style="color: #0000BB">Error $e</span><span style="color: #007700">) {<br />    echo </span><span style="color: #0000BB">$e</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">getMessage</span><span style="color: #007700">();<br />}<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

    <div class="example-contents"><p>O exemplo acima produzirá:</p></div>
    <div class="example-contents screen">
<div class="annotation-interactive cdata"><pre>
successo!
successo!
successo!
Call to private method C::foo() from scope A
</pre></div>
    </div>
   </div>
   <blockquote class="note"><p><strong class="note">Nota</strong>: 
    <p class="para">
     As resoluções de Vinculações Estáticas Tardias terminarão quando a chamada for realizada
     sem retorno. Por outro lado, chamadas estáticas utilizando instruções como
     <code class="literal">parent::</code> ou <code class="literal">self::</code> irão repassar a informação
     do chamador.
    </p>
    <div class="example" id="example-4">
     <p><strong>Exemplo #4 Chamadas repassadas e não repassadas</strong></p>
     <div class="example-contents">
<div class="annotation-interactive phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br /></span><span style="color: #007700">class </span><span style="color: #0000BB">A<br /></span><span style="color: #007700">{<br />    public static function </span><span style="color: #0000BB">foo</span><span style="color: #007700">()<br />    {<br />        static::</span><span style="color: #0000BB">who</span><span style="color: #007700">();<br />    }<br /><br />    public static function </span><span style="color: #0000BB">who</span><span style="color: #007700">()<br />    {<br />        echo </span><span style="color: #0000BB">__CLASS__</span><span style="color: #007700">.</span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />    }<br />}<br /><br />class </span><span style="color: #0000BB">B </span><span style="color: #007700">extends </span><span style="color: #0000BB">A<br /></span><span style="color: #007700">{<br />    public static function </span><span style="color: #0000BB">test</span><span style="color: #007700">()<br />    {<br />        </span><span style="color: #0000BB">A</span><span style="color: #007700">::</span><span style="color: #0000BB">foo</span><span style="color: #007700">();<br />        </span><span style="color: #0000BB">parent</span><span style="color: #007700">::</span><span style="color: #0000BB">foo</span><span style="color: #007700">();<br />        </span><span style="color: #0000BB">self</span><span style="color: #007700">::</span><span style="color: #0000BB">foo</span><span style="color: #007700">();<br />    }<br /><br />    public static function </span><span style="color: #0000BB">who</span><span style="color: #007700">()<br />    {<br />        echo </span><span style="color: #0000BB">__CLASS__</span><span style="color: #007700">.</span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />    }<br />}<br /><br />class </span><span style="color: #0000BB">C </span><span style="color: #007700">extends </span><span style="color: #0000BB">B<br /></span><span style="color: #007700">{<br />    public static function </span><span style="color: #0000BB">who</span><span style="color: #007700">()<br />    {<br />        echo </span><span style="color: #0000BB">__CLASS__</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">C</span><span style="color: #007700">::</span><span style="color: #0000BB">test</span><span style="color: #007700">();<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
     </div>

     <div class="example-contents"><p>O exemplo acima produzirá:</p></div>
     <div class="example-contents screen">
<div class="annotation-interactive cdata"><pre>
A
C
C
</pre></div>
     </div>
    </div>
   </p></blockquote>
  </div>
 </div><?php manual_footer($setup); ?>