<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/migration81.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ru',
  ),
  'this' => 
  array (
    0 => 'migration81.new-features.php',
    1 => 'Новая функциональность',
    2 => 'Новая функциональность',
  ),
  'up' => 
  array (
    0 => 'migration81.php',
    1 => 'Миграция с PHP 8.0.x на PHP 8.1.x',
  ),
  'prev' => 
  array (
    0 => 'migration81.php',
    1 => 'Миграция с PHP 8.0.x на PHP 8.1.x',
  ),
  'next' => 
  array (
    0 => 'migration81.new-classes.php',
    1 => 'Новые классы и интерфейсы',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ru',
    'path' => 'appendices/migration81/new-features.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="migration81.new-features" class="sect1">
 <h2 class="title">Новая функциональность</h2>

 <div class="sect2" id="migration81.new-features.core">
  <h3 class="title">Ядро PHP</h3>

  <div class="sect3" id="migration81.new-features.core.octal-literal-prefix">
   <h4 class="title">Буквенный префикс восьмеричных целых чисел</h4>

   <p class="para">
    Восьмеричные целые числа теперь могут использовать явный префикс
    <code class="literal">0o</code>/<code class="literal">0O</code> в целочисленных литералах,
    аналогично двоичным и шестнадцатеричным целочисленным литералам.
    <div class="informalexample">
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />014</span><span style="color: #007700">;  </span><span style="color: #FF8000">// Восьмеричный литерал без префикса<br /></span><span style="color: #0000BB">0o14</span><span style="color: #007700">; </span><span style="color: #FF8000">// Восьмеричный литерал с префиксом<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
     </div>

    </div>
   </p>
   
  </div>

  <div class="sect3" id="migration81.new-features.core.unpacking-string-keys">
   <h4 class="title">Распаковка массива с помощью строковых ключей</h4>

   <p class="para">
    Добавлена поддержка <a href="language.types.array.php#language.types.array.unpacking" class="link">распаковки массивов со строковыми ключами</a>.
    <div class="informalexample">
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$arr1 </span><span style="color: #007700">= [</span><span style="color: #0000BB">1</span><span style="color: #007700">, </span><span style="color: #DD0000">'a' </span><span style="color: #007700">=&gt; </span><span style="color: #DD0000">'b'</span><span style="color: #007700">];<br /></span><span style="color: #0000BB">$arr2 </span><span style="color: #007700">= [...</span><span style="color: #0000BB">$arr1</span><span style="color: #007700">, </span><span style="color: #DD0000">'c' </span><span style="color: #007700">=&gt; </span><span style="color: #DD0000">'d'</span><span style="color: #007700">]; </span><span style="color: #FF8000">//[1, 'a' =&gt; 'b', 'c' =&gt; 'd']<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
     </div>

    </div>
   </p>
   
  </div>

  <div class="sect3" id="migration81.new-features.core.named-arg-after-unpack">
   <h4 class="title">Именованный аргумент после распаковки аргумента</h4>

   <p class="para">
    Теперь можно указать именованные аргументы после распаковки аргументов.
    
    например:
    foo(...$args, named: $arg).
   </p>
  </div>

  <div class="sect3" id="migration81.new-features.core.upload-full-path-key">
   <h4 class="title">Ключ с полным путём при загрузке файлов</h4>

   <p class="para">
    При загрузке файлов появился новый ключ <code class="literal">full_path</code>,
    который содержит полный путь (а не только относительный) загруженного файла.
    Предназначен для использования вместе с HTML-атрибутом webkitdirectory.
   </p>
   
  </div>

  <div class="sect3" id="migration81.new-features.core.enums">
   <h4 class="title">Перечисления</h4>

   <p class="para">
    Добавлена поддержка <a href="language.enumerations.php" class="link">перечислений</a>.
    
   </p>
  </div>

  <div class="sect3" id="migration81.new-features.core.fibers">
   <h4 class="title">Файберы</h4>

   <p class="para">
    Добавлена поддержка <a href="language.fibers.php" class="link">файберов</a>.
    
   </p>
  </div>

  <div class="sect3" id="migration81.new-features.core.callable-syntax">
   <h4 class="title">Callback-функции как объекты первого класса</h4>

   <p class="para">
    Замыкания для callback-функций теперь можно создавать с помощью синтаксиса <code class="code">myFunc(...)</code>,
    который идентичен <a href="functions.first_class_callable_syntax.php" class="link">синтаксису <code class="code">Closure::fromCallable(&#039;myFunc&#039;)</code></a>.
    
   </p>
   <blockquote class="note"><p><strong class="note">Замечание</strong>: 
    <span class="simpara">
     <code class="code">...</code> является частью синтаксиса, а не пропуском.
    </span>
   </p></blockquote>
  </div>

  <div class="sect3" id="migration81.new-features.core.intersection-types">
   <h4 class="title">Пересечение типов</h4>

   <p class="para">
    Добавлена поддержка <a href="language.types.type-system.php#language.types.type-system.composite.intersection" class="link">пересечения типов</a>.
   </p>
   <div class="caution"><strong class="caution">Предостережение</strong>
    <p class="simpara">
     <a href="language.types.type-system.php#language.types.type-system.composite.intersection" class="link">Пересечения типов</a>
     нельзя использовать вместе с <a href="language.types.declarations.php#language.types.declarations.composite.union" class="link">объединением типов</a>.
    </p>
   </div>
  </div>

  <div class="sect3" id="migration81.new-features.core.never-type">
   <h4 class="title">Тип never</h4>

   <p class="para">
    Добавлен новый тип возвращаемого значения <span class="type"><a href="language.types.never.php" class="type never">never</a></span>.
    Тип указывает на то, что функция либо вызывает <span class="function"><a href="function.exit.php" class="function">exit()</a></span>,
    либо выбрасывает исключение, либо не завершается.
    
   </p>
  </div>

  <div class="sect3" id="migration81.new-features.core.new-in-initializer">
   <h4 class="title"><a href="language.oop5.basic.php#language.oop5.basic.new" class="link"><code class="literal">new</code></a> в инициализации класса</h4>

   <p class="para">
    Теперь можно использовать выражения <code class="code">new ClassName()</code> в качестве
    значения по умолчанию для параметра, статической переменной,
    инициализаторов глобальных констант и в качестве аргументов атрибутов.
    Теперь объекты также можно передавать в <span class="function"><a href="function.define.php" class="function">define()</a></span>.
    
   </p>
   
  </div>

  <div class="sect3" id="migration81.new-features.core.readonly">
   <h4 class="title">Readonly-свойства</h4>

   <p class="para">
    Добавлена поддержка <a href="language.oop5.properties.php#language.oop5.properties.readonly-properties" class="link">readonly</a>-свойств.
    
   </p>
  </div>

  <div class="sect3" id="migration81.new-features.core.final-constants">
   <h4 class="title">Окончательные константы класса</h4>

   <p class="para">
    Добавлена поддержка <a href="language.oop5.final.php#language.oop5.final.example.php81" class="link">модификатора <span class="modifier">final</span> при определении констант класса</a>.
    Кроме того, константы интерфейса по умолчанию становятся переопределяемыми.
    
   </p>
  </div>

 </div>

 <div class="sect2" id="migration81.new-features.curl">
  <h3 class="title">CURL</h3>

  <p class="para">
   Добавлена опция <strong><code><a href="curl.constants.php#constant.curlopt-doh-url">CURLOPT_DOH_URL</a></code></strong>.
  </p>

  <p class="para">
   Добавлены параметры для сертификата BLOB-объекта, доступные с libcurl &gt;= 7.71.0:
  </p>
  <ul class="itemizedlist">
   <li class="listitem">
    <span class="simpara"><strong><code><a href="curl.constants.php#constant.curlopt-issuercert-blob">CURLOPT_ISSUERCERT_BLOB</a></code></strong></span>
   </li>
   <li class="listitem">
    <span class="simpara"><strong><code><a href="curl.constants.php#constant.curlopt-proxy-issuercert">CURLOPT_PROXY_ISSUERCERT</a></code></strong></span>
   </li>
   <li class="listitem">
    <span class="simpara"><strong><code><a href="curl.constants.php#constant.curlopt-proxy-issuercert-blob">CURLOPT_PROXY_ISSUERCERT_BLOB</a></code></strong></span>
   </li>
   <li class="listitem">
    <span class="simpara"><strong><code><a href="curl.constants.php#constant.curlopt-proxy-sslcert-blob">CURLOPT_PROXY_SSLCERT_BLOB</a></code></strong></span>
   </li>
   <li class="listitem">
    <span class="simpara"><strong><code><a href="curl.constants.php#constant.curlopt-proxy-sslkey-blob">CURLOPT_PROXY_SSLKEY_BLOB</a></code></strong></span>
   </li>
   <li class="listitem">
    <span class="simpara"><strong><code><a href="curl.constants.php#constant.curlopt-sslcert-blob">CURLOPT_SSLCERT_BLOB</a></code></strong></span>
   </li>
   <li class="listitem">
    <span class="simpara"><strong><code><a href="curl.constants.php#constant.curlopt-sslkey-blob">CURLOPT_SSLKEY_BLOB</a></code></strong></span>
   </li>
  </ul>

  <p class="para">
   Добавлен класс <span class="classname"><a href="class.curlstringfile.php" class="classname">CURLStringFile</a></span>, который можно использовать
   для отправки файла из строки (<span class="type"><a href="language.types.string.php" class="type string">string</a></span>), а не из файла:
   <div class="informalexample">
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$file </span><span style="color: #007700">= new </span><span style="color: #0000BB">CURLStringFile</span><span style="color: #007700">(</span><span style="color: #0000BB">$data</span><span style="color: #007700">, </span><span style="color: #DD0000">'filename.txt'</span><span style="color: #007700">, </span><span style="color: #DD0000">'text/plain'</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">curl_setopt</span><span style="color: #007700">(</span><span style="color: #0000BB">$curl</span><span style="color: #007700">, </span><span style="color: #0000BB">CURLOPT_POSTFIELDS</span><span style="color: #007700">, [</span><span style="color: #DD0000">'file' </span><span style="color: #007700">=&gt; </span><span style="color: #0000BB">$file</span><span style="color: #007700">]);<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
  </p>
 </div>

 <div class="sect2" id="migration81.new-features.fpm">
  <h3 class="title">FPM</h3>

  <p class="para">
   Добавлен формат статуса openmetrics.
   Prometheus может использовать его для получения метрик FPM.
  </p>
  <p class="para">
   Добавлен новый пул для диспетчера динамических процессов под названием <code class="literal">pm.max_spawn_rate</code>.
   Он позволяет запускать несколько дочерних процессов более быстрыми темпами, если выбран динамический pm.
   Значение по умолчанию - <code class="literal">32</code>, которое ранее было фиксированным значением.
  </p>
 </div>

 <div class="sect2" id="migration81.new-features.gd">
  <h3 class="title">GD</h3>

  <p class="para">
   Поддержка Avif теперь доступна с помощью <span class="function"><a href="function.imagecreatefromavif.php" class="function">imagecreatefromavif()</a></span>
   и <span class="function"><a href="function.imageavif.php" class="function">imageavif()</a></span>, если libgd был собран с поддержкой Avif.
  </p>
 </div>

 <div class="sect2" id="migration81.new-features.hash">
  <h3 class="title">Hash</h3>

  <p class="para">
   Следующие функции <span class="function"><a href="function.hash.php" class="function">hash()</a></span>, <span class="function"><a href="function.hash-file.php" class="function">hash_file()</a></span>
   и <span class="function"><a href="function.hash-init.php" class="function">hash_init()</a></span> теперь поддерживают дополнительный необязательный аргумент
   <code class="parameter">options</code>, который можно использовать для передачи специфичных для алгоритма данных.
  </p>

  <div class="sect3" id="migration81.new-features.hash.murmurhash3">
   <h4 class="title">MurmurHash3</h4>

   <p class="para">
    Добавлена поддержка <code class="literal">MurmurHash3</code> с поддержкой потоковой передачи.
    Реализованы следующие варианты:
   </p>
   <ul class="itemizedlist">
    <li class="listitem">
     <span class="simpara">murmur3a, 32-битный хеш</span>
    </li>
    <li class="listitem">
     <span class="simpara">murmur3c, 128-битный хеш для x86</span>
    </li>
    <li class="listitem">
     <span class="simpara">murmur3f, 128-битный хеш для x64</span>
    </li>
   </ul>

   <p class="para">
    Начальное состояние хеширования можно передать с помощью ключа <code class="literal">seed</code>
    в массиве <code class="parameter">options</code>, например:

    <div class="informalexample">
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$h </span><span style="color: #007700">= </span><span style="color: #0000BB">hash</span><span style="color: #007700">(</span><span style="color: #DD0000">"murmur3f"</span><span style="color: #007700">, </span><span style="color: #0000BB">$data</span><span style="color: #007700">, </span><span style="color: #0000BB">options</span><span style="color: #007700">: [</span><span style="color: #DD0000">"seed" </span><span style="color: #007700">=&gt; </span><span style="color: #0000BB">42</span><span style="color: #007700">]);<br />echo </span><span style="color: #0000BB">$h</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>

    Допустимое начальное значение находится в диапазоне от <code class="literal">0</code>
    до определённого платформой значения <strong><code>UINT_MAX</code></strong>, обычно - <code class="literal">4294967295</code>.
   </p>
  </div>

  <div class="sect3" id="migration81.new-features.hash.xxhash">
   <h4 class="title">xxHash</h4>

   <p class="para">
    Добавлена поддержка <code class="literal">xxHash</code>.
    Реализованы следующие варианты:
   </p>
   <ul class="itemizedlist">
    <li class="listitem">
     <span class="simpara">xxh32, 32-bit hash</span>
    </li>
    <li class="listitem">
     <span class="simpara">xxh64, 64-bit hash</span>
    </li>
    <li class="listitem">
     <span class="simpara">xxh3, 64-bit hash</span>
    </li>
    <li class="listitem">
     <span class="simpara">xxh128, 128-bit hash</span>
    </li>
   </ul>

   <p class="para">
    Начальное состояние хеширования можно передать с помощью ключа <code class="literal">seed</code>
    в массиве <code class="parameter">options</code>, например:

    <div class="informalexample">
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$h </span><span style="color: #007700">= </span><span style="color: #0000BB">hash</span><span style="color: #007700">(</span><span style="color: #DD0000">"xxh3"</span><span style="color: #007700">, </span><span style="color: #0000BB">$data</span><span style="color: #007700">, </span><span style="color: #0000BB">options</span><span style="color: #007700">: [</span><span style="color: #DD0000">"seed" </span><span style="color: #007700">=&gt; </span><span style="color: #0000BB">42</span><span style="color: #007700">]);<br />echo </span><span style="color: #0000BB">$h</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>

    Использование секрета также поддерживается путём передачи ключа
    <code class="literal">secret</code> в массиве <code class="parameter">options</code>:

    <div class="informalexample">
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$h </span><span style="color: #007700">= </span><span style="color: #0000BB">hash</span><span style="color: #007700">(</span><span style="color: #DD0000">"xxh3"</span><span style="color: #007700">, </span><span style="color: #0000BB">$data</span><span style="color: #007700">, </span><span style="color: #0000BB">options</span><span style="color: #007700">: [</span><span style="color: #DD0000">"secret" </span><span style="color: #007700">=&gt; </span><span style="color: #DD0000">"как минимум 136 байт секрета"</span><span style="color: #007700">]);<br />echo </span><span style="color: #0000BB">$h</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>

    Качество пользовательского секрета имеет решающее значение для качества хеша результата.
    Для секрета настоятельно рекомендуется использовать максимально возможную энтропию.
   </p>
  </div>
 </div>

 <div class="sect2" id="migration81.new-features.mysqli">
  <h3 class="title">MySQLi</h3>

  <div class="sect3" id="migration81.new-features.mysqli.local_infile_directory">
   <h4 class="title">Новая INI-директива <code class="literal">mysqli.local_infile_directory</code></h4>

   <p class="para">
    Добавлена INI-директива <a href="mysqli.configuration.php#ini.mysqli.local-infile-directory" class="link">mysqli.local_infile_directory</a>,
    с помощью которой можно указать каталог, из которого разрешена загрузка файлов.
    Это имеет смысл, только если <a href="mysqli.configuration.php#ini.mysqli.allow-local-infile" class="link">mysqli.allow_local_infile</a>
    не включён, поскольку в этом случае разрешены все каталоги.
   </p>
  </div>

  <div class="sect3" id="migration81.new-features.mysqli.bind-in-execute">
   <h4 class="title">Привязка параметров во время выполнении</h4>

   <p class="para">
    Теперь можно привязывать параметры, передав их в виде массива в <span class="methodname"><a href="mysqli-stmt.execute.php" class="methodname">mysqli_stmt::execute()</a></span>.
    Все значения будут привязаны как строки. Разрешены только списочные массивы.
    Эта новая функция недоступна, если MySQLi скомпилирован с libmysqlclient.
    
    <div class="informalexample">
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$stmt </span><span style="color: #007700">= </span><span style="color: #0000BB">$mysqli</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">prepare</span><span style="color: #007700">(</span><span style="color: #DD0000">'INSERT INTO users(id, name) VALUES(?,?)'</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$stmt</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">execute</span><span style="color: #007700">([</span><span style="color: #0000BB">1</span><span style="color: #007700">, </span><span style="color: #0000BB">$username</span><span style="color: #007700">]);<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
     </div>

    </div>
   </p>
  </div>

  <div class="sect3" id="migration81.new-features.mysqli.mysqli_fetch_column">
   <h4 class="title">Новый метод <span class="methodname"><a href="mysqli-result.fetch-column.php" class="methodname">mysqli_result::fetch_column()</a></span></h4>

   <p class="para">
    Добавлен <span class="methodname"><a href="mysqli-result.fetch-column.php" class="methodname">mysqli_result::fetch_column()</a></span> для
    выборки единственного скалярного значения из набора результатов.
    Новый метод принимает необязательный параметр <code class="parameter">column</code>,
    начинающийся с 0, в виде целого числа (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>), указывающий из какого столбца производить выборку.
    
    <div class="informalexample">
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$result </span><span style="color: #007700">= </span><span style="color: #0000BB">$mysqli</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">query</span><span style="color: #007700">(</span><span style="color: #DD0000">'SELECT username FROM users WHERE id = 123'</span><span style="color: #007700">);<br />echo </span><span style="color: #0000BB">$result</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">fetch_column</span><span style="color: #007700">();<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
     </div>

    </div>
   </p>
  </div>

 </div>

 <div class="sect2" id="migration81.new-features.pdo_mysql">
  <h3 class="title">PDO</h3>

  <p class="para">
   Добавлен атрибут <strong><code><a href="ref.pdo-mysql.php#pdo.constants.mysql-attr-local-infile-directory">PDO::MYSQL_ATTR_LOCAL_INFILE_DIRECTORY</a></code></strong>,
   который можно использовать для указания каталога, из которого могут быть загружены файлы.
   Это имеет смысл только в том случае, если <strong><code><a href="ref.pdo-mysql.php#pdo.constants.mysql-attr-local-infile">PDO::MYSQL_ATTR_LOCAL_INFILE</a></code></strong> не включён,
   поскольку в этом случае разрешены все каталоги.
  </p>
 </div>

 <div class="sect2" id="migration81.new-features.pdo_sqlite">
  <h3 class="title">PDO_SQLite</h3>

  <p class="para">
   Поддерживается новый элемент <code class="literal">&quot;file:&quot;</code> в DSN-префиксе SQLite,
   который позволяет указывать дополнительные флаги.
   Он не будет работать, если включена опция open_basedir.
   <div class="informalexample">
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">new </span><span style="color: #0000BB">PDO</span><span style="color: #007700">(</span><span style="color: #DD0000">'sqlite:file:path/to/sqlite.db?mode=ro'</span><span style="color: #007700">)<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
  </p>
 </div>

 <div class="sect2" id="migration81.new-features.posix">
  <h3 class="title">POSIX</h3>

  <p class="para">
   Добавлены константы <strong><code><a href="posix.constants.setrlimit.php#constant.posix-rlimit-kqueues">POSIX_RLIMIT_KQUEUES</a></code></strong> и <strong><code><a href="posix.constants.setrlimit.php#constant.posix-rlimit-npts">POSIX_RLIMIT_NPTS</a></code></strong>.
   Эти ограничения доступны только во FreeBSD.
  </p>
 </div>

 <div class="sect2" id="migration81.new-features.standard">
  <h3 class="title">Стандартные функции</h3>

  <p class="para">
   <span class="function"><a href="function.fputcsv.php" class="function">fputcsv()</a></span> теперь принимает новый аргумент <code class="parameter">eol</code>,
   который позволяет определять настраиваемую последовательность конца строки,
   значение по умолчанию остаётся прежним - <code class="literal">&quot;\n&quot;</code>.
  </p>
 </div>

 <div class="sect2" id="migration81.new-features.spl">
  <h3 class="title">SPL</h3>

  <p class="para">
   <span class="methodname"><a href="splfileobject.fputcsv.php" class="methodname">SplFileObject::fputcsv()</a></span> теперь принимает новый аргумент
   <code class="parameter">eol</code>, который позволяет определять настраиваемую последовательность конца строки,
   значение по умолчанию остаётся прежним - <code class="literal">&quot;\n&quot;</code>.
  </p>
 </div>

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