<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/language.functions.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'fr',
  ),
  'this' => 
  array (
    0 => 'functions.first_class_callable_syntax.php',
    1 => 'Syntaxe callable de premi&egrave;re classe',
    2 => 'Syntaxe callable de premi&egrave;re classe',
  ),
  'up' => 
  array (
    0 => 'language.functions.php',
    1 => 'Les fonctions',
  ),
  'prev' => 
  array (
    0 => 'functions.arrow.php',
    1 => 'Fonction Fl&eacute;ch&eacute;e',
  ),
  'next' => 
  array (
    0 => 'language.oop5.php',
    1 => 'Les classes et les objets',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'fr',
    'path' => 'language/functions.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="functions.first_class_callable_syntax" class="sect1">
  <h2 class="title">Syntaxe callable de première classe</h2>

  <p class="para">
   La syntaxe de callable de première classe est introduite à partir de PHP 8.1.0,
   comme une manière de créer des <a href="functions.anonymous.php" class="link">fonctions anonymes</a>
   depuis des <a href="language.types.callable.php" class="link">callable</a>.
   Elle remplace la syntaxe des callables existante utilisant les chaînes et tableaux.
   L&#039;avantage de cette syntaxe est qu&#039;elle est accessible à l&#039;analyse statique
   et utilise la portée du point où le callable est acquis.
  </p>

  <p class="para">
   La syntaxe <code class="code">CallableExpr(...)</code> est utilisée pour créer un objet
   <span class="classname"><a href="class.closure.php" class="classname">Closure</a></span> depuis le callable.
   <code class="code">CallableExpr</code> accepte toute expression qui peut être directement
   appelée dans la grammaire de PHP :
   <div class="example" id="example-1">
    <p><strong>Exemple #1 Syntaxe callable de première classe basique</strong></p>
    <div class="example-contents">
     <div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">class </span><span style="color: #0000BB">Foo </span><span style="color: #007700">{<br />   public function </span><span style="color: #0000BB">method</span><span style="color: #007700">() {}<br />   public static function </span><span style="color: #0000BB">staticmethod</span><span style="color: #007700">() {}<br />   public function </span><span style="color: #0000BB">__invoke</span><span style="color: #007700">() {}<br />}<br /></span><span style="color: #0000BB">$obj </span><span style="color: #007700">= new </span><span style="color: #0000BB">Foo</span><span style="color: #007700">();<br /></span><span style="color: #0000BB">$classStr </span><span style="color: #007700">= </span><span style="color: #DD0000">'Foo'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$methodStr </span><span style="color: #007700">= </span><span style="color: #DD0000">'method'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$staticmethodStr </span><span style="color: #007700">= </span><span style="color: #DD0000">'staticmethod'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$f1 </span><span style="color: #007700">= </span><span style="color: #0000BB">strlen</span><span style="color: #007700">(...);<br /></span><span style="color: #0000BB">$f2 </span><span style="color: #007700">= </span><span style="color: #0000BB">$obj</span><span style="color: #007700">(...);  </span><span style="color: #FF8000">// objet invocable<br /></span><span style="color: #0000BB">$f3 </span><span style="color: #007700">= </span><span style="color: #0000BB">$obj</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">method</span><span style="color: #007700">(...);<br /></span><span style="color: #0000BB">$f4 </span><span style="color: #007700">= </span><span style="color: #0000BB">$obj</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">$methodStr</span><span style="color: #007700">(...);<br /></span><span style="color: #0000BB">$f5 </span><span style="color: #007700">= </span><span style="color: #0000BB">Foo</span><span style="color: #007700">::</span><span style="color: #0000BB">staticmethod</span><span style="color: #007700">(...);<br /></span><span style="color: #0000BB">$f6 </span><span style="color: #007700">= </span><span style="color: #0000BB">$classStr</span><span style="color: #007700">::</span><span style="color: #0000BB">$staticmethodStr</span><span style="color: #007700">(...);<br /></span><span style="color: #FF8000">// callable traditionnel utilisant une chaîne, un tableau<br /></span><span style="color: #0000BB">$f7 </span><span style="color: #007700">= </span><span style="color: #DD0000">'strlen'</span><span style="color: #007700">(...);<br /></span><span style="color: #0000BB">$f8 </span><span style="color: #007700">= [</span><span style="color: #0000BB">$obj</span><span style="color: #007700">, </span><span style="color: #DD0000">'method'</span><span style="color: #007700">](...);<br /></span><span style="color: #0000BB">$f9 </span><span style="color: #007700">= [</span><span style="color: #0000BB">Foo</span><span style="color: #007700">::class, </span><span style="color: #DD0000">'staticmethod'</span><span style="color: #007700">](...);<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
  </p>

  <blockquote class="note"><p><strong class="note">Note</strong>: 
   <p class="para">
    Les <code class="code">...</code> font partie de la syntaxe et ne sont pas une omission.
   </p>
  </p></blockquote>

  <p class="para">
   <code class="code">CallableExpr(...)</code> a les mêmes sémantiques que <span class="methodname"><a href="closure.fromcallable.php" class="methodname">Closure::fromCallable()</a></span>.
   C&#039;est-à-dire, contrairement aux callables utilisant les chaînes et tableaux,
   <code class="code">CallableExpr(...)</code> respecte la portée du point où il est créé :
   <div class="example" id="example-2">
    <p><strong>Exemple #2 Comparaison de portée de <code class="code">CallableExpr(...)</code> et des callables traditionnels</strong></p>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">class </span><span style="color: #0000BB">Foo </span><span style="color: #007700">{<br />    public function </span><span style="color: #0000BB">getPrivateMethod</span><span style="color: #007700">() {<br />        return [</span><span style="color: #0000BB">$this</span><span style="color: #007700">, </span><span style="color: #DD0000">'privateMethod'</span><span style="color: #007700">];<br />    }<br />    private function </span><span style="color: #0000BB">privateMethod</span><span style="color: #007700">() {<br />        echo </span><span style="color: #0000BB">__METHOD__</span><span style="color: #007700">, </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />    }<br />}<br /></span><span style="color: #0000BB">$foo </span><span style="color: #007700">= new </span><span style="color: #0000BB">Foo</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$privateMethod </span><span style="color: #007700">= </span><span style="color: #0000BB">$foo</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">getPrivateMethod</span><span style="color: #007700">();<br /></span><span style="color: #0000BB">$privateMethod</span><span style="color: #007700">();<br /></span><span style="color: #FF8000">// Erreur fatale : Call to private method Foo::privateMethod() from global scope<br />// Ceci est dû au fait que l'appel est effectué en dehors de Foo et la visibilité sera vérifiée depuis ce point.<br /></span><span style="color: #007700">class </span><span style="color: #0000BB">Foo1 </span><span style="color: #007700">{<br />    public function </span><span style="color: #0000BB">getPrivateMethod</span><span style="color: #007700">() {<br />        </span><span style="color: #FF8000">// Utilise la portée où le callable est acquis.<br />        </span><span style="color: #007700">return </span><span style="color: #0000BB">$this</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">privateMethod</span><span style="color: #007700">(...); </span><span style="color: #FF8000">// identique à Closure::fromCallable([$this, 'privateMethod']);<br />    </span><span style="color: #007700">}<br />    private function </span><span style="color: #0000BB">privateMethod</span><span style="color: #007700">() {<br />        echo </span><span style="color: #0000BB">__METHOD__</span><span style="color: #007700">, </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />    }<br />}<br /></span><span style="color: #0000BB">$foo1 </span><span style="color: #007700">= new </span><span style="color: #0000BB">Foo1</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$privateMethod </span><span style="color: #007700">= </span><span style="color: #0000BB">$foo1</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">getPrivateMethod</span><span style="color: #007700">();<br /></span><span style="color: #0000BB">$privateMethod</span><span style="color: #007700">();  </span><span style="color: #FF8000">// Foo1::privateMethod<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>

  </p>

  <blockquote class="note"><p><strong class="note">Note</strong>: 
   <p class="para">
    La création d&#039;objets avec cette syntaxe (e.g <code class="code">new Foo(...)</code>) n&#039;est pas supportée,
    car la syntaxe <code class="code">new Foo()</code> n&#039;est pas considérée comme un appel.
   </p>
  </p></blockquote>

  <blockquote class="note"><p><strong class="note">Note</strong>: 
   <p class="para">
    La syntaxe de callable de première classe ne peut pas être combinée avec
    l&#039;<a href="language.oop5.basic.php#language.oop5.basic.nullsafe" class="link">opérateur nullsafe</a>.
    Les deux cas suivants entraînent une erreur de compilation :
    <div class="informalexample">
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$obj</span><span style="color: #007700">?-&gt;</span><span style="color: #0000BB">method</span><span style="color: #007700">(...);<br /></span><span style="color: #0000BB">$obj</span><span style="color: #007700">?-&gt;</span><span style="color: #0000BB">prop</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">method</span><span style="color: #007700">(...);<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
     </div>

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