<?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 => 'fr',
  ),
  'this' => 
  array (
    0 => 'language.oop5.late-static-bindings.php',
    1 => 'Late Static Bindings (R&eacute;solution statique &agrave; la vol&eacute;e)',
    2 => 'Late Static Bindings (R&eacute;solution statique &agrave; la vol&eacute;e)',
  ),
  'up' => 
  array (
    0 => 'language.oop5.php',
    1 => 'Les classes et les objets',
  ),
  'prev' => 
  array (
    0 => 'language.oop5.object-comparison.php',
    1 => 'Comparaison d\'objets',
  ),
  'next' => 
  array (
    0 => 'language.oop5.references.php',
    1 => 'Objets et r&eacute;f&eacute;rences',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'fr',
    '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">Late Static Bindings (Résolution statique à la volée)</h2>
  <p class="para">
   PHP implémente une fonctionnalité appelée 
   <code class="literal">late static binding</code>, en français la résolution
   statique à la volée, qui peut être utilisée pour référencer la classe appelée
   dans un contexte d&#039;héritage statique.
  </p>
  
  <p class="para">
   Plus précisément, les résolutions statiques à la volée fonctionnent en enregistrant
   le nom de la classe dans le dernier &quot;appel non transmis&quot;. Dans le cas des appels de
   méthodes statiques, il s&#039;agit de la classe explicitement nommée (généralement, celle à
   gauche de l&#039;opérateur
   <a href="language.oop5.paamayim-nekudotayim.php" class="link"><code class="literal">::</code></a>) ;
   dans le cas de méthodes non statiques, il s&#039;agit de la classe de l&#039;objet. Un &quot;appel
   transmis&quot; est un appel statique déclenché par <code class="literal">self::</code>,
   <code class="literal">parent::</code>, <code class="literal">static::</code>, ou, tout en haut de la
   hiérarchie des classes, <span class="function"><a href="function.forward-static-call.php" class="function">forward_static_call()</a></span>.
   
   
   La fonction <span class="function"><a href="function.get-called-class.php" class="function">get_called_class()</a></span> peut être utilisée pour récupérer
   une chaîne contenant le nom de la classe appelée, et <code class="literal">static::</code>
   introduit son espace.
  </p>

  <p class="para">
   Cette fonctionnalité a été baptisée <code class="literal">&quot;late static bindings&quot;</code>,
   avec un point de vue interne. <code class="literal">&quot;Late binding&quot;</code>, littéralement
   résolution tardive, vient du fait que les éléments <code class="literal">static::</code>
   ne seront pas résolus en utilisant la classe où la méthode a été définie, mais
   celle qui est active durant l&#039;exécution. L&#039;adjectif statique a été
   ajouté car ce problème s&#039;applique (sans y être limité) aux méthodes statiques.
  </p>

  <div class="sect2" id="language.oop5.late-static-bindings.self">
   <h3 class="title">Limitations de <code class="literal">self::</code></h3>
   <p class="para">
    Les références statiques à la classe courante, avec <code class="literal">self::</code> ou
    <code class="literal">__CLASS__</code>, sont résolues en utilisant la classe à laquelle
    appartiennent les fonctions, celle où elles ont été définies :
   </p>
   <div class="example" id="example-1">
    <p><strong>Exemple #1 Utilisation de <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">qui</span><span style="color: #007700">()<br />    {<br />        echo </span><span style="color: #0000BB">__CLASS__</span><span style="color: #007700">;<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">qui</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">qui</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>L&#039;exemple ci-dessus va afficher :</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">Utilisation de la résolution statique à la volée</h3>

   <p class="para">
    La résolution statique à la volée essaie de dépasser cette limitation
    en introduisant un mot clé qui fait référence à la classe
    qui a été appelée durant l&#039;exécution. Pour faire simple, ce mot-clé
    permet le référencement à <code class="literal">B</code> depuis
    <code class="literal">test()</code>, dans l&#039;exemple précédent.
    Il a été décidé de ne pas introduire de nouveau mot clé, mais
    plutôt d&#039;utiliser le mot <code class="literal">static</code> qui était déjà
    réservé.
   </p>

   <div class="example" id="example-2">
    <p><strong>Exemple #2 Utilisation simple 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">qui</span><span style="color: #007700">()<br />    {<br />        echo </span><span style="color: #0000BB">__CLASS__</span><span style="color: #007700">;<br />    }<br />    public static function </span><span style="color: #0000BB">test</span><span style="color: #007700">()<br />    {<br />        static::</span><span style="color: #0000BB">qui</span><span style="color: #007700">(); </span><span style="color: #FF8000">// Ici, résolution à la volée<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">qui</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>L&#039;exemple ci-dessus va afficher :</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">Note</strong>: 
    <p class="para">
     Dans les contextes non statiques, la classe appelée sera celle de l&#039;objet.
     Comme <code class="literal">$this-&gt;</code> essayera d&#039;appeler
     des méthodes privées depuis le même contexte, utiliser <code class="literal">static::</code>
     pourrait donner des résultats différents. Une autre différence est que
     <code class="literal">static::</code> ne peut faire référence qu&#039;à des propriétés
     statiques.
    </p>
   </p></blockquote>
   <div class="example" id="example-3">
    <p><strong>Exemple #3 Utilisation de <code class="literal">static::</code> dans un contexte non statique</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">"Success!\n"</span><span style="color: #007700">;<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() sera copiée dans B, par conséquent son contexte sera toujours A<br />    * et l'appel se fera sans problème */<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">/* La méthode originale est remplacée; le contexte est celui de 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>L&#039;exemple ci-dessus va afficher :</p></div>
    <div class="example-contents screen">
<div class="annotation-interactive cdata"><pre>
Success!
Success!
Success!
Call to private method C::foo() from scope A
</pre></div>
    </div>
   </div>
   <blockquote class="note"><p><strong class="note">Note</strong>: 
    <p class="para">
     La résolution des statiques à la volée va s&#039;arrêter à un appel statique
     complètement résolu. D&#039;un autre côté, les appels statiques en utilisant
     un mot-clé comme <code class="literal">parent::</code> ou <code class="literal">self::</code> 
     vont transmettre l&#039;information appelante.
    </p>
    <div class="example" id="example-4">
     <p><strong>Exemple #4 Appel avec ou sans transmission</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">qui</span><span style="color: #007700">();<br />    }<br /><br />    public static function </span><span style="color: #0000BB">qui</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">qui</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 />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">qui</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>L&#039;exemple ci-dessus va afficher :</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); ?>