<?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 => 'ru',
  ),
  'this' => 
  array (
    0 => 'functions.first_class_callable_syntax.php',
    1 => 'Синтаксис создания первоклассных callable-значений',
    2 => 'Синтаксис создания первоклассных callable-значений',
  ),
  'up' => 
  array (
    0 => 'language.functions.php',
    1 => 'Функции',
  ),
  'prev' => 
  array (
    0 => 'functions.arrow.php',
    1 => 'Стрелочные функции',
  ),
  'next' => 
  array (
    0 => 'language.oop5.php',
    1 => 'Классы и объекты',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ru',
    '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">Синтаксис создания первоклассных callable-значений</h2>

  <p class="para">
   Синтаксис преобразования callable-выражений в объекты первого класса, которые возможно
   передавать как аргумент, возвращать из функций или присваивать переменным,
   представили в PHP 8.1.0 как способ, который
   создаёт <a href="functions.anonymous.php" class="link">анонимные функции</a>
   из <a href="language.types.callable.php" class="link">callable-выражений</a>.
   Новый синтаксис вытесняет предыдущий callable-синтаксис со строками и массивами.
   Преимущество нового синтаксиса состоит в доступности для статического анализа
   и наследовании новым синтаксисом области видимости переменных в точке
   получения callable-выражения.
  </p>

  <p class="para">
   Синтаксис <code class="code">CallableExpr(...)</code> создаёт объект
   <span class="classname"><a href="class.closure.php" class="classname">Closure</a></span> из выражения, доступного для вызова,
   где <code class="code">CallableExpr</code> — элемент синтаксиса, который принимает выражение,
   доступное для прямого вызова в терминах PHP-грамматики:
   <div class="example" id="example-1">
    <p><strong>Пример #1 Пример создания первоклассных вызываемых значений синтаксисом с многоточием</strong></p>
    <div class="example-contents">
<div class="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">Foo<br /></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 /><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 /><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">// Вызов объекта как функции<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 /><br /></span><span style="color: #FF8000">// Традиционный синтаксис callable-выражений со строками и массивами<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">](...);</span></span></code></div>
    </div>

   </div>
  </p>

  <blockquote class="note"><p><strong class="note">Замечание</strong>: 
   <p class="para">
    Оператор <code class="code">...</code> — часть синтаксиса, а не пропуск.
   </p>
  </p></blockquote>

  <p class="para">
   Выражение <code class="code">CallableExpr(...)</code> и метод <span class="methodname"><a href="closure.fromcallable.php" class="methodname">Closure::fromCallable()</a></span>
   семантически идентичны. Поэтому в отличие от callable-синтаксиса
   со строками и массивами, синтаксис <code class="code">CallableExpr(...)</code>
   учитывает область видимости контекста, в котором создаёт замыкание:
   <div class="example" id="example-2">
    <p><strong>Пример #2 
     Сравнение области видимости синтаксиса <code class="code">CallableExpr(...)</code>
     и традиционного callable-синтаксиса
    </strong></p>
    <div class="example-contents">
<div class="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">Foo<br /></span><span style="color: #007700">{<br />    public function </span><span style="color: #0000BB">getPrivateMethod</span><span style="color: #007700">()<br />    {<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 /><br />    private function </span><span style="color: #0000BB">privateMethod</span><span style="color: #007700">()<br />    {<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 /><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">// Fatal error: Call to private method Foo::privateMethod() from global scope<br />// Причина фатальной ошибки состоит в вызове замыкания вне класса Foo,<br />// при том что видимость метода проверяется в контексте вызова, а не определения<br /><br /></span><span style="color: #007700">class </span><span style="color: #0000BB">Foo1<br /></span><span style="color: #007700">{<br />    public function </span><span style="color: #0000BB">getPrivateMethod</span><span style="color: #007700">()<br />    {<br />        </span><span style="color: #FF8000">// Callable-выражение унаследует область видимости переменных,<br />        // в которой выражение получат<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">// Значение возврата идентично<br />                                          // значению вызова Closure::fromCallable([$this, 'privateMethod']);<br />    </span><span style="color: #007700">}<br /><br />    private function </span><span style="color: #0000BB">privateMethod</span><span style="color: #007700">()<br />    {<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 /><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</span></span></code></div>
    </div>

   </div>

  </p>

  <blockquote class="note"><p><strong class="note">Замечание</strong>: 
   <p class="para">
    Синтаксисом наподобие <code class="code">new Foo(...)</code> нельзя создать объект,
    поскольку синтаксис <code class="code">new Foo()</code> не относится к вызовам.
   </p>
  </p></blockquote>

  <blockquote class="note"><p><strong class="note">Замечание</strong>: 
   <p class="para">
    Синтаксис, который создаёт объекты первого класса из callable-выражений,
    нельзя комбинировать
    <a href="language.oop5.basic.php#language.oop5.basic.nullsafe" class="link">с null-безопасным оператором</a>.
    Каждая из следующих строк вызывает ошибку времени компиляции:
    <div class="informalexample">
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><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">(...);</span></span></code></div>
     </div>

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