new-features.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 389525942dd551c9b1943d404d76c03ab4a6203b Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<sect1 xml:id="migration70.new-features" xmlns:xlink="http://www.w3.org/1999/xlink">
 <title>Новая функциональность</title>

 <sect2 xml:id="migration70.new-features.scalar-type-declarations">
  <title>Объявления скалярных типов</title>

  <para>
   Скалярные типы <link linkend="language.types.declarations">объявляют</link> в двух режимах:
   нестрогом, в котором PHP работает по умолчанию, и строгом.
   Теперь как в нестрогом, так и в строгом режимах разрешается задавать
   следующие типы параметров:
   строки (<type>string</type>), целые числа (<type>int</type>), числа с плавающей точкой
   (<type>float</type>) и логические значения (<type>bool</type>). Перечисленные типы дополняют
   другие типы, которые появились в PHP 5: имена классов, интерфейсов,
   массивы (<type>array</type>) и <type>callable</type>.
  </para>

  <informalexample>
   <programlisting role="php">
<![CDATA[
<?php

// Нестрогий режим с приведением типов
function sumOfInts(int ...$ints)
{
    return array_sum($ints);
}

var_dump(sumOfInts(2, '3', 4.1));

?>
]]>
   </programlisting>
   &example.outputs;
   <screen>
<![CDATA[
int(9)
]]>
   </screen>
  </informalexample>

  <para>
   Для установки строгого режима, в самом начале файла необходимо поместить одну
   директиву &declare;. Это означает, что строгость объявления скалярных типов
   работает на уровне файла и
   не затрагивает весь остальной код. Эта директива затрагивает не только объявления
   параметров, но и возвращаемые значения функций (смотрите
   <link linkend="language.types.declarations">объявления возвращаемого типа</link>),
   встроенные функции PHP и функции загруженных модулей.
  </para>

  <para>
   Подробную документацию и примеры использования читайте в разделе
   <link linkend="language.types.declarations">декларация типов</link>.
  </para>
 </sect2>

 <sect2 xml:id="migration70.new-features.return-type-declarations">
  <title>Объявления возвращаемых значений</title>

  <para>
   В PHP 7 добавлена поддержка <link linkend="language.types.declarations">
   объявления возвращаемого типа</link>. Аналогично как и
   <link linkend="language.types.declarations">объявления типов аргументов</link>,
   объявление типа возвращаемого значения указывает, значение какого типа должна вернуть
   функция. Для объявления типа возвращаемого значения доступны все те же
   <link linkend="language.types.declarations">типы</link>, что и для
   объявления типов аргументов.
  </para>

  <informalexample>
   <programlisting role="php">
<![CDATA[
<?php

function arraysSum(array ...$arrays): array
{
    return array_map(function(array $array): int {
        return array_sum($array);
    }, $arrays);
}

print_r(arraysSum([1,2,3], [4,5,6], [7,8,9]));

?>
]]>
   </programlisting>
   &example.outputs;
   <screen>
<![CDATA[
Array
(
    [0] => 6
    [1] => 15
    [2] => 24
)
]]>
   </screen>
  </informalexample>

  <para>
   Полную документацию и примеры использования читайте в разделе про
   <link linkend="language.types.declarations">объявление возвращаемого типа</link>.
  </para>
 </sect2>

 <sect2 xml:id="migration70.new-features.null-coalesce-op">
  <title>Оператор объединения с null</title>

  <para>
   Был добавлен оператор объединения с null (<literal>??</literal>), являющийся
   синтаксическим сахаром для достаточно распространённого действия, когда совместно
   используются тернарный оператор и функция <function>isset</function>. Он возвращает
   первый операнд, если он задан и не равен &null;, а в обратном случае возвращает второй
   операнд.
  </para>

  <informalexample>
   <programlisting role="php">
<![CDATA[
<?php

// Извлекаем значение $_GET['user'], а если оно не задано,
// то возвращаем 'nobody'
$username = $_GET['user'] ?? 'nobody';

// Это идентично следующему коду:
$username = isset($_GET['user']) ? $_GET['user'] : 'nobody';

// Этот оператор можно использовать в цепочке.

// В этом примере мы сперва проверяем, задан ли $_GET['user'], если нет,
// то проверяем $_POST['user'], и если он тоже не задан, то присваеваем 'nobody'.
$username = $_GET['user'] ?? $_POST['user'] ?? 'nobody';

?>
]]>
   </programlisting>
  </informalexample>

  <!-- TODO: we don't need further details here, but this still has to be
       added to the operator precedence table -->
 </sect2>

 <sect2 xml:id="migration70.new-features.spaceship-op">
  <title>Оператор spaceship (космический корабль)</title>
  <para>
   Этот оператор предназначен для сравнения двух выражений. Он возвращает -1, 0 или 1
   если <varname>$a</varname>, соответственно, меньше, равно или больше чем
   <varname>$b</varname>. Сравнение производится в соответствии с
   <link linkend="types.comparisons">правилами сравнения типов</link> PHP.
  </para>
  <informalexample>
   <programlisting role="php">
<![CDATA[
<?php

// Целые числа
echo 1 <=> 1; // 0
echo 1 <=> 2; // -1
echo 2 <=> 1; // 1

// Числа с плавающей точкой
echo 1.5 <=> 1.5; // 0
echo 1.5 <=> 2.5; // -1
echo 2.5 <=> 1.5; // 1

// Строки
echo "a" <=> "a"; // 0
echo "a" <=> "b"; // -1
echo "b" <=> "a"; // 1

?>
]]>
   </programlisting>
  </informalexample>

  <!-- TODO: we don't need further details here, but this still has to be
       added to the operator precedence table -->
 </sect2>

 <sect2 xml:id="migration70.new-features.define-array">
  <title>Определение констант массивов с помощью <function>define</function></title>

  <para>
   Можно определить константу типа <type>array</type> с помощью функции
   <function>define</function>. В PHP 5.6 такие константы можно было задавать только с
   помощью &const;.
  </para>

  <informalexample>
   <programlisting role="php">
<![CDATA[
<?php

define('ANIMALS', [
    'dog',
    'cat',
    'bird'
]);

echo ANIMALS[1]; // выводит "cat"

?>
]]>
   </programlisting>
  </informalexample>
 </sect2>

 <sect2 xml:id="migration70.new-features.anonymous-classes">
  <title>Анонимные классы</title>

  <para>
   Была добавлена поддержка анонимных классов с помощью <literal>new class</literal>.
   Их можно использовать тогда, когда нужен одноразовый класс и создавать полноценный
   класс, а потом его объект не имеет смысла:
  </para>

  <informalexample>
   <programlisting role="php">
<![CDATA[
<?php

interface Logger
{
    public function log(string $msg);
}

class Application
{
    private $logger;

    public function getLogger(): Logger {
         return $this->logger;
    }

    public function setLogger(Logger $logger) {
         $this->logger = $logger;
    }
}

$app = new Application;
$app->setLogger(new class implements Logger {
    public function log(string $msg) {
        echo $msg;
    }
});

var_dump($app->getLogger());

?>
]]>
   </programlisting>
   &example.outputs;
   <screen>
<![CDATA[
object(class@anonymous)#2 (0) {
}
]]>
   </screen>
  </informalexample>

  <para>
   Подробную документацию и примеры использования читайте в разделе про
   <link linkend="language.oop5.anonymous">анонимные классы</link>.
  </para>
 </sect2>

 <sect2 xml:id="migration70.new-features.unicode-codepoint-escape-syntax">
  <title>Синтаксис кодирования Unicode</title>

  <para>
   Он принимает шестнадцатеричный код Unicode и записываем его в формате UTF-8 в
   двойных кавычках или формате heredoc. Любой корректный код будет принят.
   Ведущие нули по желанию.
  </para>

  <informalexample>
   <programlisting role="php">
<![CDATA[
echo "\u{aa}";
echo "\u{0000aa}";
echo "\u{9999}";
]]>
   </programlisting>
   &example.outputs;
   <screen>
<![CDATA[
ª
ª (То же самое, что и первый вариант, но с ведущими нулями)
香
]]>
   </screen>
  </informalexample>
 </sect2>

 <sect2 xml:id="migration70.new-features.closure-call-method">
  <title><methodname>Closure::call</methodname></title>

  <para>
   <methodname>Closure::call</methodname> — более производительный
   и короткий способ временного связывания области действия объекта с замыканием
   и его вызовом.
  </para>

  <informalexample>
   <programlisting role="php">
<![CDATA[
<?php

class A
{
    private $x = 1;
}

// До PHP 7
$getX = function() {
    return $this->x;
};
$getXCB = $getX->bindTo(new A, 'A'); // Промежуточное замыкание
echo $getXCB();

// PHP 7+
$getX = function() {
    return $this->x;
};
echo $getX->call(new A);

?>
]]>
   </programlisting>
   &example.outputs;
   <screen>
<![CDATA[
1
1
]]>
   </screen>
  </informalexample>
 </sect2>
 <sect2 xml:id="migration70.new-features.filtered-unserialize">
  <title><function>unserialize</function> с фильтрацией</title>

  <para>
   Эта функциональность обеспечивает более высокий уровень безопасности при десериализации
   объектов с непроверенными данными. Это позволяет предотвратить возможную инъекцию
   кода, позволяя разработчику использовать белый список классов для десериализации.
  </para>

  <informalexample>
   <programlisting role="php">
<![CDATA[
<?php

// Преобразование всех объектов в __PHP_Incomplete_Class
$data = unserialize($foo, ["allowed_classes" => false]);

// Преобразование всех объектов, кроме MyClass и MyClass2 в __PHP_Incomplete_Class
$data = unserialize($foo, ["allowed_classes" => ["MyClass", "MyClass2"]]);

// Поведение по умолчанию принимает все классы (можно просто не задавать второй аргумент)
$data = unserialize($foo, ["allowed_classes" => true]);

?>
]]>
   </programlisting>
  </informalexample>
 </sect2>

 <sect2 xml:id="migration70.new-features.intlchar">
  <title><classname>IntlChar</classname></title>

  <para>
   Новый класс <classname>IntlChar</classname> добавляет новую функциональность в
   ICU. Класс определяет несколько статических методов и констант для манипулирования
   символами Unicode.
  </para>

  <informalexample>
   <programlisting role="php">
<![CDATA[
<?php

printf('%x', IntlChar::CODEPOINT_MAX);
echo IntlChar::charName('@');
var_dump(IntlChar::ispunct('!'));

?>
]]>
   </programlisting>
   &example.outputs;
   <screen>
<![CDATA[
10ffff
COMMERCIAL AT
bool(true)
]]>
   </screen>
  </informalexample>

  <para>
   Для работы с этим классом требуется установить модуль
   <link linkend="book.intl">Intl</link>.
  </para>
 </sect2>

 <sect2 xml:id="migration70.new-features.expectations">
  <title>Ожидания</title>

  <para>
   Ожидания являются улучшенной,
   обратно совместимой версией старой функции <function>assert</function>.
   Они позволяют делать предположения с нулевой стоимостью в промышленном коде и
   предоставляют возможность выбрасывать пользовательские исключения в случае
   провала ожидания.
  </para>

  <para>
   Вместе тем, что старое API поддерживается, <function>assert</function> теперь является
   языковой конструкцией, принимающей первым аргументом выражения, а не только
   строки (<type>string</type>) для оценки или логические значения (<type>bool</type>) для проверки.
  </para>

  <informalexample>
   <programlisting role="php">
<![CDATA[
<?php

ini_set('assert.exception', 1);

class CustomError extends AssertionError {}

assert(false, new CustomError('Сообщение об ошибке'));

?>
]]>
   </programlisting>
   &example.outputs;
   <screen>
<![CDATA[
Fatal error: Uncaught CustomError: Сообщение об ошибке
]]>
   </screen>
  </informalexample>

  <para>
   Подробное описание этого функционала, а также инструкции для его конфигурирования
   для тестовых и промышленных сред, можно найти на странице руководства, посвящённой
   функции <function>assert</function>.
  </para>
 </sect2>

 <sect2 xml:id="migration70.new-features.group-use-declarations">
  <title>Групповые объявления <literal>use</literal></title>

  <para>
   Классы, функции и константы импортируемые из одного и того же &namespace;,
   теперь можно группировать в одном операторе &use.namespace;.
  </para>

  <informalexample>
   <programlisting role="php">
<![CDATA[
<?php

// До PHP 7
use some\namespace\ClassA;
use some\namespace\ClassB;
use some\namespace\ClassC as C;

use function some\namespace\fn_a;
use function some\namespace\fn_b;
use function some\namespace\fn_c;

use const some\namespace\ConstA;
use const some\namespace\ConstB;
use const some\namespace\ConstC;

// PHP 7+
use some\namespace\{ClassA, ClassB, ClassC as C};
use function some\namespace\{fn_a, fn_b, fn_c};
use const some\namespace\{ConstA, ConstB, ConstC};

?>
]]>
   </programlisting>
  </informalexample>
 </sect2>

 <sect2 xml:id="migration70.new-features.generator-return-expressions">
  <title>Выражение return в генераторах</title>

  <para>
   Эта функциональность добавлена к генераторам, введённым в PHP 5.5.
   Она позволяет использовать оператор <literal>return</literal> в генераторах в качестве
   окончательного возвращаемого значения (возврат по ссылке недопустим). Это значение можно
   извлечь с помощью нового метода <literal>Generator::getReturn()</literal>, который можно
   использовать только после того, как генератор вернул все сгенерированные значение.
  </para>

  <informalexample>
   <programlisting role="php">
<![CDATA[
<?php

$gen = (function() {
    yield 1;
    yield 2;

    return 3;
})();

foreach ($gen as $val) {
    echo $val, PHP_EOL;
}

echo $gen->getReturn(), PHP_EOL;

?>
]]>
   </programlisting>
   &example.outputs;
   <screen>
<![CDATA[
1
2
3
]]>
   </screen>
  </informalexample>

  <para>
   Возможность явно получать окончательное значение генератора является очень полезной,
   так как позволяет клиентскому коду, использующему генератор, получать и обработать
   самое последнее значение генератора, после которого точно ничего больше не будет.
   Это сильно проще, чем вынуждать разработчика проверять, последнее ли значение
   вернулось и как-то по особенному его обрабатывать.
  </para>
 </sect2>
 <sect2 xml:id="migration70.new-features.generator-delegation">
  <title>Делегация генератора</title>

  <para>
   Теперь генератор может автоматически делегировать другому генератору, объекту класса,
   реализующий <classname>Traversable</classname> или массиву без необходимости писать в нем
   дополнительную обработку полученных значений. Достигается это с помощью
   конструкции &yield.from;.
  </para>

  <informalexample>
   <programlisting role="php">
<![CDATA[
<?php

function gen()
{
    yield 1;
    yield 2;
    yield from gen2();
}

function gen2()
{
    yield 3;
    yield 4;
}

foreach (gen() as $val)
{
    echo $val, PHP_EOL;
}

?>
]]>
   </programlisting>
   &example.outputs;
   <screen>
<![CDATA[
1
2
3
4
]]>
   </screen>
  </informalexample>
 </sect2>

 <sect2 xml:id="migration70.new-features.intdiv">
  <title>Функция целочисленного деления <function>intdiv</function></title>

  <para>
   Новая функция <function>intdiv</function> производит целочисленное деление
   операндов и возвращает его результат.
  </para>

  <informalexample>
   <programlisting role="php">
<![CDATA[
<?php

var_dump(intdiv(10, 3));

?>
]]>
   </programlisting>
   &example.outputs;
   <screen>
<![CDATA[
int(3)
]]>
   </screen>
  </informalexample>
 </sect2>

 <sect2 xml:id="migration70.new-features.session-options">
  <title>Опции сессий</title>

  <para>
   Теперь <function>session_start</function> принимает массив опций, которые переопределят
   <link linkend="session.configuration">конфигурационные директивы сессии</link>
   установленные в php.ini.
  </para>

  <para>
   Также опции были расширены включённой по умолчанию опцией
   <link linkend="ini.session.lazy-write">session.lazy_write</link>, которая говорит PHP
   о том, что файл сессии надо перезаписывать, только если изменились данные сессии,
   и опцией <literal>read_and_close</literal>, которую можно задать только через
   <function>session_start</function> для того, чтобы PHP закрывал сессию сразу же как
   прочитает её данные и не вносил в неё каких-либо изменений.
  </para>

  <para>
   К примеру, для установки
   <link linkend="ini.session.cache-limiter">session.cache_limiter</link> равным
   <literal>private</literal> и немедленному закрытию сессии после чтения её данных:
  </para>

  <informalexample>
   <programlisting role="php">
<![CDATA[
<?php

session_start([
    'cache_limiter' => 'private',
    'read_and_close' => true,
]);

?>
]]>
   </programlisting>
  </informalexample>
 </sect2>

 <sect2 xml:id="migration70.new-features.preg-repace-callback-array-function">
  <title><function>preg_replace_callback_array</function></title>

  <para>
   Новая функция <function>preg_replace_callback_array</function> помогает писать более
   чистый код, когда требуется вызвать функцию
   <function>preg_replace_callback</function>. До PHP 7 при обработке
   разных регулярных выражений разными функциями приходилось для каждой такой
   обработки писать отдельный вызов функции.
  </para>

  <para>
   Теперь можно использовать одну функцию и передавать в неё ассоциативный массив,
   в котором ключи — регулярные выражения, а значения — функции обратного вызова.
  </para>
 </sect2>

 <sect2 xml:id="migration70.new-features.csprng-functions">
  <title>Функции CSPRNG</title>

  <para>
   Были добавлены две новые кроссплатформенные функции для генерации криптографически
   безопасных строк и целых чисел: <function>random_bytes</function> и
   <function>random_int</function>.
  </para>
 </sect2>

 <sect2 xml:id="migration70.new-features.list-arrayaccess">
  <title>
   Теперь функция <function>list</function> всегда может распаковывать объекты,
   реализующие <classname>ArrayAccess</classname>
  </title>

  <para>
   Ранее функция <function>list</function> не гарантировала корректную обработку
   объектов, реализующих <classname>ArrayAccess</classname>.
   Теперь это исправлено.
  </para>
 </sect2>

 <sect2 xml:id="migration70.new-features.others">
  <title>Прочие изменения</title>
  <itemizedlist>
   <listitem>
    <simpara>
     Добавлена возможность доступа к методам и свойствам класса при клонировании,
     то есть <literal>(clone $foo)-&gt;bar()</literal>.
    </simpara>
   </listitem>
  </itemizedlist>
 </sect2>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->