PHP: полный мануал с примерами, функциями и ООП

Константные выражения

Теперь можно предоставить скалярное выражение, которое включает числовые и строковые литералы и (или) константы, когда раньше ожидалось статическое значение, например, в объявлениях констант или значениях аргументов функций по умолчанию.

<?php

const ONE = 1;
const TWO = ONE * 2;

class C
{
    const THREE = TWO + 1;
    const ONE_THIRD = ONE / self::THREE;
    const SENTENCE = 'Значение константы THREE - '.self::THREE;

    public function f($a = ONE + self::THREE)
    {
        return $a;
    }
}

echo (new C)->f()."\n";
echo C::SENTENCE;

?>

4
Значение константы THREE — 3

Массив (array) также определяют через ключевое слово const:

<?php

const ARR = ['a', 'b'];

echo ARR[0];

?>

a

Функции с переменным количеством аргументов через оператор ...

Функции с переменным количеством аргументов теперь разрешается реализовывать через оператор ..., вместо того чтобы полагаться на функцию func_get_args().

<?php

function f($req, $opt = null, ...$params)
{
    // Переменная $params — массив, который содержит остальные аргументы
    printf(
        '$req: %d; $opt: %d; количество параметров: %d' . "\n",
        $req,
        $opt,
        count($params)
    );
}

f(1);
f(1, 2);
f(1, 2, 3);
f(1, 2, 3, 4);
f(1, 2, 3, 4, 5);

?>

$req: 1; $opt: 0; количество параметров: 0
$req: 1; $opt: 2; количество параметров: 0
$req: 1; $opt: 2; количество параметров: 1
$req: 1; $opt: 2; количество параметров: 2
$req: 1; $opt: 2; количество параметров: 3

Распаковка аргументов через оператор ...

Массивы и объекты, которые реализуют интерфейс Traversable, разрешается распаковывать в список аргументов при вызове функций и передаче аргументов через оператор .... В других языках, включая Ruby, оператор знают как splat- или spread-оператор.

<?php

function add($a, $b, $c)
{
    return $a + $b + $c;
}

$operators = [2, 3];
echo add(1, ...$operators);

?>

6

Возведение в степень через оператор **

Добавили правоассоциативный оператор ** возведения в степень, и короткий синтаксис **= присваивания.

<?php

printf("2 ** 3 ==      %d\n", 2 ** 3);
printf("2 ** 3 ** 2 == %d\n", 2 ** 3 ** 2);

$a = 2;
$a **= 3;
printf("a ==           %d\n", $a);

?>

2 ** 3 ==      8
2 ** 3 ** 2 == 512
a ==           8

Конструкции use function и use const

Оператор use расширили, чтобы в дополнение к классам поддержать импорт функций и констант. Конструкция use function импортирует функции, а конструкция use const — константы.

<?php

namespace Name\Space {
    const FOO = 42;

    function f()
    {
        echo __FUNCTION__."\n";
    }
}

namespace {
    use const Name\Space\FOO;
    use function Name\Space\f;

    echo FOO."\n";
    f();
}

?>

42
Name\Space\f

phpdbg

Теперь PHP содержит интерактивный отладчик phpdbg, который реализовали как SAPI-модуль. Подробности даёт документация к модулю phpdbg.

Кодировка по умолчанию

Для функций htmlentities(), html_entity_decode() и htmlspecialchars() добавили директиву default_charset, которая устанавливает набор символов по умолчанию. Обратите внимание: при установке параметров кодировки для модулей iconv и mbstring, которые теперь устарели, они будут иметь приоритет над ini-параметром default_charset для функций модулей iconv и mbstring.

Значение по умолчанию для настройки — UTF-8.

Переиспользование обёртки php://input

Поток php://input теперь разрешается переоткрывать и считывать столько раз, сколько требуется. Эта работа также значительно сократила объём памяти, который требуется для обработки данных POST-запросов.

Загрузка больших файлов

Теперь разрешается загружать файлы размером больше 2 ГБ.

Модуль GMP поддерживает перегрузку операторов

Объекты GMP теперь поддерживают перегрузку операторов и приведение к скалярным типам. Перегрузка операторов делает код с функциями модуля GMP выразительнее:

<?php

$a = gmp_init(42);
$b = gmp_init(17);

if (version_compare(PHP_VERSION, '5.6', '<')) {
    echo gmp_intval(gmp_add($a, $b)), PHP_EOL;
    echo gmp_intval(gmp_add($a, 17)), PHP_EOL;
    echo gmp_intval(gmp_add(42, $b)), PHP_EOL;
} else {
    echo $a + $b, PHP_EOL;
    echo $a + 17, PHP_EOL;
    echo 42 + $b, PHP_EOL;
}

?>

59
59
59

Безопасное сравнение строк функцией hash_equals() для предотвращения атак по времени

Добавили функцию hash_equals() для сравнения двух строк за постоянное время. Функция снижает риск атаки по времени; например, во время тестирования хеширования паролей функцией crypt(), когда невозможно использовать функции password_hash() и password_verify(), которые не чувствительны к атакам по времени.

<?php

$expected  = crypt('12345', '$2a$07$usesomesillystringforsalt$');
$correct   = crypt('12345', '$2a$07$usesomesillystringforsalt$');
$incorrect = crypt('1234',  '$2a$07$usesomesillystringforsalt$');

var_dump(hash_equals($expected, $correct));
var_dump(hash_equals($expected, $incorrect));

?>

bool(true)
bool(false)

Метод __debugInfo()

Добавили магический метод __debugInfo(), который разрешает объектам изменять свойства и значения, которые отображаются при выводе объекта функцией var_dump().

<?php

class C
{
    private $prop;

    public function __construct($val)
    {
        $this->prop = $val;
    }

    public function __debugInfo()
    {
        return [
            'propSquared' => $this->prop ** 2,
        ];
    }
}

var_dump(new C(42));

?>

object(C)#1 (1) {
  ["propSquared"]=>
  int(1764)
}

Алгоритм хеширования gost-crypto

Добавили алгоритм хеширования gost-crypto. Алгоритм реализует функцию хеширования GOST, с которой работают в таблицах CryptoPro S-box, которые определяет секция 11.2 стандарта » RFC 4357.

Улучшение в протоколах SSL/TLS

В поддержку протоколов SSL/TLS в PHP 5.6 внесли широкий спектр улучшений. К улучшениям относятся: включение одноранговой проверки по умолчанию, поддержка сопоставления отпечатков сертификатов, снижение защита от атак повторного согласования по протоколу TLS и много новых параметров SSL-контекста, которые помогают точнее контролировать параметры протокола и проверки при работе с зашифрованными потоками.

Подробнее изменения описывает раздел руководства «Изменения OpenSSL в PHP 5.6.x».

Поддержка асинхронности в модуле pgsql

Модуль pgsql теперь поддерживает асинхронные соединения и запросы, чем разрешает неблокирующее взаимодействие с базами данных PostgreSQL. Асинхронные соединения разрешается устанавливать через константу PGSQL_CONNECT_ASYNC, а новые функции pg_connect_poll(), pg_socket(), pg_consume_input() и pg_flush() помогают обрабатывать асинхронные соединения и запросы.

Дата и время

• DateTimeImmutable::createFromMutable()

GMP

• gmp_root()

• gmp_rootrem()

Hash

• hash_equals()

LDAP

• ldap_escape()

• ldap_modify_batch()

MySQLi

• mysqli_get_links_stats()

OCI8

• oci_get_implicit_resultset()

OpenSSL

• openssl_get_cert_locations()

• openssl_x509_fingerprint()

• openssl_spki_new()

• openssl_spki_verify()

• openssl_spki_export_challenge()

• openssl_spki_export()

PostgreSQL

• pg_connect_poll()

• pg_consume_input()

• pg_flush()

• pg_socket()

PDO_PGSQL

• PDO::pgsqlGetNotify()

• PDO::pgsqlGetPid()

Управление сессиями

• session_abort()

• session_reset()

Zip

• ZipArchive::setPassword()

GD

• IMG_WEBP (с PHP 5.6.25)

LDAP

• LDAP_ESCAPE_DN

• LDAP_ESCAPE_FILTER

OpenSSL

• OPENSSL_DEFAULT_STREAM_CIPHERS

• STREAM_CRYPTO_METHOD_ANY_CLIENT

• STREAM_CRYPTO_METHOD_ANY_SERVER

• STREAM_CRYPTO_METHOD_TLSv1_0_CLIENT

• STREAM_CRYPTO_METHOD_TLSv1_0_SERVER

• STREAM_CRYPTO_METHOD_TLSv1_1_CLIENT

• STREAM_CRYPTO_METHOD_TLSv1_1_SERVER

• STREAM_CRYPTO_METHOD_TLSv1_2_CLIENT

• STREAM_CRYPTO_METHOD_TLSv1_2_SERVER

PostgreSQL

• PGSQL_CONNECT_ASYNC

• PGSQL_CONNECTION_AUTH_OK

• PGSQL_CONNECTION_AWAITING_RESPONSE

• PGSQL_CONNECTION_MADE

• PGSQL_CONNECTION_SETENV

• PGSQL_CONNECTION_SSL_STARTUP

• PGSQL_CONNECTION_STARTED

• PGSQL_DML_ESCAPE

• PGSQL_POLLING_ACTIVE

• PGSQL_POLLING_FAILED

• PGSQL_POLLING_OK

• PGSQL_POLLING_READING

• PGSQL_POLLING_WRITING

Ядро PHP

• crypt() теперь генерирует предупреждение E_NOTICE, если параметр salt опущен.

• substr_compare() теперь принимает 0 в качестве значения параметра length.

• unserialize() теперь терпит неудачу, если переданы сериализованные данные, которые были изменены в попытке инстанциировать объект без вызова его конструктора.

cURL

• Загрузка на сервер с использованием синтаксиса @file теперь поддерживается, только если опция CURLOPT_SAFE_UPLOAD установлена в false. Вместо этого следует пользоваться CURLFile .

Mcrypt

• Параметр source функции mcrypt_create_iv() теперь имеет значение по умолчанию MCRYPT_DEV_URANDOM вместо MCRYPT_DEV_RANDOM.

OpenSSL

• stream_socket_enable_crypto() теперь позволяет не указывать параметр crypto_type, если контекст потока SSL включает новую опцию crypto_type.

PostgreSQL

• pg_insert(), pg_select(), pg_update() и pg_delete() больше не являются экспериментальными.

• pg_send_execute(), pg_send_prepare(), pg_send_query() и pg_send_query_params() больше не блокируются до завершения записи запроса, если нижележащий поток сокета для соединения с базой данных находится в неблокирующем режиме.

Reflection

• ReflectionClass::newInstanceWithoutConstructor() теперь позволяет создавать экземпляры из неокончательных (non-final) внутренних классов.

XMLReader

• XMLReader::getAttributeNs() и XMLReader::getAttributeNo() теперь возвращают null, если атрибут не может быть найден, как это делает XMLReader::getAttribute().

Ключи массива не будут перезаписываться при определении массива как свойства класса через литерал массива

Раньше объявленные как свойства класса массивы, в которых смешались явные и неявные ключи, могли без предупреждения перезаписывать элементы массива, если явный ключ пересекался с последовательным неявным ключом. Например:

<?php

class C
{
    const ONE = 1;

    public $array = [
        self::ONE => 'foo',
        'bar',
        'quux',
    ];
}

var_dump((new C())->array);

?>

array(2) {
  [0]=>
  string(3) "bar"
  [1]=>
  string(4) "quux"
}

array(3) {
  [1]=>
  string(3) "foo"
  [2]=>
  string(3) "bar"
  [3]=>
  string(4) "quux"
}

Строгость json_decode()

Теперь функция json_decode() в соответствии со спецификацией JSON отклоняет JSON-литералы true, false и null, которые задали не строго в нижнем регистре, и, соответственно, устанавливает код ошибки для функции json_last_error(). Раньше данные, которые передавались в функцию json_decode() и содержали исключительно одно из этих значений в верхнем или смешанном регистре, принимались.

Это изменение повлияет только в случае передачи в функцию json_decode() некорректного JSON. В случае корректно сформированного JSON никакого эффекта не будет.

Теперь потоковые обёртки по умолчанию проверяют сертификаты точек при использовании SSL/TLS

Все шифруемые клиентские потоки теперь по умолчанию включают проверку пиров. По умолчанию сертификат пира проверяется пакетом OpenSSL CA. Обычно не нужно ничего делать для соединения с серверами с правильным SSL-сертификатом, так как OpenSSL настроен так, что уже работает с хорошими CA-пакетами.

Стандартный CA пакет может быть переопределён глобально с помощью установки или openssl.cafile или openssl.capath строк конфигурации, или же на уровне каждого запроса используя опции контекста cafile или capath.

Хотя это и не рекомендуется, но можно отключить проверку сертификата пира для запроса, установив verify_peer опцию контекста в false, и можно отключить проверку имени пира, установив verify_peer_name в false.

Ресурсы GMP стали объектами

Теперь ресурсы GMP — объекты. Функциональный API, который реализовали в модуле GMP, остался без изменений. Существующий код должен заработать без изменений, только если в нём явно не использовались проверки на ресурс is_resource() или что-то подобное.

Теперь функция Mcrypt требует корректные ключи и IV

mcrypt_encrypt(), mcrypt_decrypt(), mcrypt_cbc(), mcrypt_cfb(), mcrypt_ecb(), mcrypt_generic() и mcrypt_ofb() больше не принимают ключи и IV с некорректной длиной, а режимы блочного шифра, требующие IV, будут завершаться с ошибкой, если его не передать.

Загрузка файлов через cURL

Теперь загрузка с синтаксисом @file требует установки для параметра CURLOPT_SAFE_UPLOAD значения false. Вместо этого следует использовать класс CURLFile.

Вызовы из несовместимого контекста

Методы, вызываемые из несовместимого контекста объявлены устаревшими и будут вызывать ошибку уровня E_DEPRECATED вместо E_STRICT. В будущих версиях PHP поддержка этих вызовов будет удалена.

Примером такого вызова является:

<?php
class A {
    function f() { echo get_class($this); }
}

class B {
    function f() { A::f(); }
}

(new B)->f();
?>

Deprecated: Non-static method A::f() should not be called statically, assuming $this from incompatible context in - on line 7
B

$HTTP_RAW_POST_DATA и always_populate_raw_post_data

always_populate_raw_post_data теперь будет вызывать ошибку E_DEPRECATED, если $HTTP_RAW_POST_DATA заполнен. Новый код должен использовать php://input вместо $HTTP_RAW_POST_DATA, который будет удалён в будущих версиях PHP. Вы можете выбрать новое поведение (в котором $HTTP_RAW_POST_DATA никогда не определяется, следовательно, E_DEPRECATED не будет генерировать ошибку) путём установки always_populate_raw_post_data в -1.

Настройки кодирования iconv и mbstring

Параметры конфигурации iconv и mbstring, связанные с кодированием, устарели в пользу default_charset. Устаревшие опции:

• iconv.input_encoding

• iconv.output_encoding

• iconv.internal_encoding

• mbstring.http_input

• mbstring.http_output

• mbstring.internal_encoding

cURL

Ряд констант, помеченные как устаревшие в библиотеке cURL, теперь будут удалены:

• CURLOPT_CLOSEPOLICY

• CURLCLOSEPOLICY_CALLBACK

• CURLCLOSEPOLICY_LEAST_RECENTLY_USED

• CURLCLOSEPOLICY_LEAST_TRAFFIC

• CURLCLOSEPOLICY_OLDEST

• CURLCLOSEPOLICY_SLOWEST

OCI8

• Поддержка неявных наборов результатов для Oracle Database 12c была добавлена с помощью новой функции oci_get_implicit_resultset().

• С помощью oci_execute($s, OCI_NO_AUTO_COMMIT), для SELECT больше необязательно инициировать внутренний ROLLBACK во время закрытия соединения.

• Добавлены зонды DTrace, контролируемые с помощью опции конфигурации --enable-dtrace.

• oci_internal_debug() теперь ничего не делает.

• Формат вывода функции phpinfo() для OCI8 изменился.

Zip

Добавлена опция конфигурации --with-libzip, для использования системной библиотеки libzip. Требуется как минимум libzip версии 0.11, рекомендуется 0.11.2 или более поздняя.

MySQLi

Была добавлена опция mysqli.rollback_on_cached_plink, которая управляет поведением отката постоянных соединений.

Обёртки потоков теперь по умолчанию проверяют сертификаты узлов и имена хостов при использовании SSL/TLS

Все шифруемые клиентские потоки теперь по умолчанию включают проверку пиров. По умолчанию сертификат пира проверяется пакетом OpenSSL CA. Обычно не нужно ничего делать для соединения с серверами с правильным SSL-сертификатом, так как OpenSSL настроен так, что уже работает с хорошими CA-пакетами.

Стандартный CA пакет может быть переопределён глобально с помощью установки или openssl.cafile или openssl.capath строк конфигурации, или же на уровне каждого запроса используя опции контекста cafile или capath.

Хотя это и не рекомендуется, но можно отключить проверку сертификата пира для запроса, установив verify_peer опцию контекста в false, и можно отключить проверку имени пира, установив verify_peer_name в false.

Сигнатура сертификата

Была добавлена поддержка извлечения и проверки сигнатуры сертификата. Для извлечения сигнатур сертификатов X.509 добавлена функция openssl_x509_fingerprint(). Также были добавлены две опции контекста потока SSL: capture_peer_cert для захвата узлового сертификата X.509, и peer_fingerprint для проверки сертификата на соответствие заданной сигнатуре.

Обновлены шифры по умолчанию

Список шифров по умолчанию, используемых PHP, был обновлён на более безопасный в соответствии с »  рекомендациями по шифрам от Mozilla, с двумя дополнительными исключениями: анонимные шифры Диффи-Хеллмана и RC4.

Этот список доступен через новую константу OPENSSL_DEFAULT_STREAM_CIPHERS, и может быть переопределён (как и в предыдущих версиях PHP) установкой опцией контекста ciphers.

Сжатие запрещено по умолчанию

Сжатие SSL/TLS было запрещено по умолчанию для compression уменьшения вероятности атаки типа CRIME. В PHP 5.4.13 была добавлена опция контекста disable_compression для возможности запретить компрессию и теперь она по умолчанию установлена как true (то есть компрессия запрещена).

Разрешение серверу определять свой собственный порядок шифров

Была добавлена опция контекста honor_cipher_order, которая позволяет серверу обслуживающему зашифрованный поток самому определять шифры, которыми будет пользоваться клиент. Это позволить снизить риск атаки типа BEAST.

Доступ к согласованному протоколу и шифру

Протокол и шифр, согласованные для шифрованного потока, доступны с помощью функций stream_get_meta_data() или stream_context_get_options(), если опция контекста SSL capture_session_meta установлена как true.

<?php
$ctx = stream_context_create(['ssl' => [
    'capture_session_meta' => TRUE
]]);

$html = file_get_contents('https://google.com/', FALSE, $ctx);
$meta = stream_context_get_options($ctx)['ssl']['session_meta'];
var_dump($meta);
?>

array(4) {
  ["protocol"]=>
  string(5) "TLSv1"
  ["cipher_name"]=>
  string(20) "ECDHE-RSA-AES128-SHA"
  ["cipher_bits"]=>
  int(128)
  ["cipher_version"]=>
  string(11) "TLSv1/SSLv3"
}

Новые возможности для совершенной прямой секретности (PFS) для серверов, обслуживающих шифрованные потоки

Шифрованные потоки клиента уже поддерживают совершенную прямую секретность, поскольку она, как правило, контролируется сервером. Серверы PHP, обслуживающие шифрованные потоки, использующие сертификаты поддерживающие совершенную прямую секретность не нуждаются в каких либо дополнительных действиях для включения PFS; однако, было добавлено некоторое количество новых опций контекста SSL для более точного контроля над PFS и для решения возможных проблем.

ecdh_curve

Эта опция позволяет выбрать кривую для использования в шифрах ECDH. Если не задано, то будет использоваться prime256v1.

dh_param

Путь к файлу, содержащему параметры для обмена ключами Диффи-Хеллмана, созданного, например, с помощью такой команды:

openssl dhparam -out /path/to/my/certs/dh-2048.pem 2048

single_dh_use

Если установлено как true, новая пара ключей будет создана, используя параметры Диффи-Хеллмана, тем самым улучшая прямую секретность.

single_ecdh_use

Если установлено как true, новая пара ключей будет генерироваться всегда, при согласовании шифра ECDH. Это улучшает прямую секретность.

Выбор версии SSL/TLS

Теперь возможно выбирать конкретную версию SSL и TLS с помощью опции контекста crypto_method или указывая конкретный транспорт при создании обёртки потока (например с помощью вызова stream_socket_client() или stream_socket_server()).

Опция контекста SSL crypto_method принимает битовую маску, перечисляющую допустимые протоколы, также как это задаётся в параметре crypto_type функции stream_socket_enable_crypto().

<?php

// Требуется TLS 1.0 или выше для использования file_get_contents():
$ctx = stream_context_create([
    'ssl' => [
        'crypto_method' => STREAM_CRYPTO_METHOD_TLS_CLIENT,
    ],
]);
$html = file_get_contents('https://google.com/', false, $ctx);

// Требуется TLS 1.1 или 1.2:
$ctx = stream_context_create([
    'ssl' => [
        'crypto_method' => STREAM_CRYPTO_METHOD_TLSv1_1_CLIENT |
                           STREAM_CRYPTO_METHOD_TLSv1_2_CLIENT,
    ],
]);
$html = file_get_contents('https://google.com/', false, $ctx);

// Соединяемся с использованием транспорта потокового сокета tlsv1.2://
$sock = stream_socket_client('tlsv1.2://google.com:443/');

?>

Добавлена функция openssl_get_cert_locations()

Была добавлена функция openssl_get_cert_locations(): она возвращает расположения, в которых PHP будет искать пакеты CA по умолчанию.

<?php
var_dump(openssl_get_cert_locations());
?>

array(8) {
  ["default_cert_file"]=>
  string(21) "/etc/pki/tls/cert.pem"
  ["default_cert_file_env"]=>
  string(13) "SSL_CERT_FILE"
  ["default_cert_dir"]=>
  string(18) "/etc/pki/tls/certs"
  ["default_cert_dir_env"]=>
  string(12) "SSL_CERT_DIR"
  ["default_private_dir"]=>
  string(20) "/etc/pki/tls/private"
  ["default_default_cert_area"]=>
  string(12) "/etc/pki/tls"
  ["ini_cafile"]=>
  string(0) ""
  ["ini_capath"]=>
  string(0) ""
}

Поддержка SPKI

Была добавлена поддержка для создания, извлечения и проверки подписанных публичных ключей и опознавательных строк (SPKAC). Были добавлены функции openssl_spki_new(), openssl_spki_verify(), openssl_spki_export_challenge() и openssl_spki_export() для создания, проверки экспорта PEM публичных ключей и соответствующих опознавательных строк из SPKAC, созданных из элементов HTML5 KeyGen.

openssl_spki_new

Генерация нового SPKAC с использованием приватного ключа, опознавательной строки и алгоритма хеширования.

<?php
$pkey = openssl_pkey_new();
openssl_pkey_export($pkey, 'secret passphrase');

$spkac = openssl_spki_new($pkey, 'challenge string');
?>

Результат выполнения приведённого примера:

SPKAC=MIIBXjCByDCBnzANBgkqhkiG9w0BAQEFAAOBjQAwgYkCgYEA3L0IfUijj7+A8CPC8EmhcdNoe5fUAog7OrBdhn7EkxFButUp40P7+LiYiygYG1TmoI/a5EgsLU3s9twEz3hmgY9mYIqb/rb+SF8qlD/K6KVyUORC7Wlz1Df4L8O3DuRGzx6/+3jIW6cPBpfgH1sVuYS1vDBsP/gMMIxwTsKJ4P0CAwEAARYkYjViMzYxMTktNjY5YS00ZDljLWEyYzctMGZjNGFhMjVlMmE2MA0GCSqGSIb3DQEBAwUAA4GBAF7hu0ifzmjonhAak2FhhBRsKFDzXdKIkrWxVNe8e0bZzMrWOxFM/rqBgeH3/gtOUDRS5Fnzyq425UsTYbjfiKzxGeCYCQJb1KJ2V5Ij/mIJHZr53WYEXHQTNMGR8RPm7IxwVXVSHIgAfXsXZ9IXNbFbcaLRiSTr9/N4U+MXUWL7

openssl_spki_verify

Проверка предоставленного SPKAC.

<?php
$pkey = openssl_pkey_new();
openssl_pkey_export($pkey, 'secret passphrase');

$spkac = openssl_spki_new($pkey, 'challenge string');
var_dump(openssl_spki_verify($spkac));
?>

openssl_spki_export_challenge

Экспорт связанной опознавательной строки из предоставленного SPKAC.

<?php
$pkey = openssl_pkey_new();
openssl_pkey_export($pkey, 'secret passphrase');

$spkac = openssl_spki_new($pkey, 'challenge string');
$challenge = openssl_spki_export_challenge($spkac);
echo $challenge;
?>

Результат выполнения приведённого примера:

challenge string

openssl_spki_export

Экспорт публичного ключа (PEM) RSA в формате из SPKAC.

<?php
$pkey = openssl_pkey_new();
openssl_pkey_export($pkey, 'secret passphrase');

$spkac = openssl_spki_new($pkey, 'challenge string');
echo openssl_spki_export($spkac);
?>

Результат выполнения приведённого примера:

-----BEGIN PUBLIC KEY-----
MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDcvQh9SKOPv4DwI8LwSaFx02h7
l9QCiDs6sF2GfsSTEUG61SnjQ/v4uJiLKBgbVOagj9rkSCwtTez23ATPeGaBj2Zg
ipv+tv5IXyqUP8ropXJQ5ELtbXPUN/gvw7cO5EbPHr/7eMhbpw8Gl+AfWxW5hLW8
MGw/+AwwjHBOwong/QIDAQAB
-----END PUBLIC KEY-----

Объявления скалярных типов

Скалярные типы объявляют в двух режимах: нестрогом, в котором PHP работает по умолчанию, и строгом. Теперь как в нестрогом, так и в строгом режимах разрешается задавать следующие типы параметров: строки (string), целые числа (int), числа с плавающей точкой (float) и логические значения (bool). Перечисленные типы дополняют другие типы, которые появились в PHP 5: имена классов, интерфейсов, массивы (array) и callable.

<?php

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

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

?>

int(9)

Для установки строгого режима, в самом начале файла необходимо поместить одну директиву declare. Это означает, что строгость объявления скалярных типов работает на уровне файла и не затрагивает весь остальной код. Эта директива затрагивает не только объявления параметров, но и возвращаемые значения функций (смотрите объявления возвращаемого типа), встроенные функции PHP и функции загруженных модулей.

Подробную документацию и примеры использования читайте в разделе декларация типов.

Объявления возвращаемых значений

В PHP 7 добавлена поддержка объявления возвращаемого типа. Аналогично как и объявления типов аргументов, объявление типа возвращаемого значения указывает, значение какого типа должна вернуть функция. Для объявления типа возвращаемого значения доступны все те же типы, что и для объявления типов аргументов.

<?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]));

?>

Array
(
    [0] => 6
    [1] => 15
    [2] => 24
)

Полную документацию и примеры использования читайте в разделе про объявление возвращаемого типа.

Оператор объединения с null

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

<?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';

?>

Оператор spaceship (космический корабль)

Этот оператор предназначен для сравнения двух выражений. Он возвращает -1, 0 или 1 если $a, соответственно, меньше, равно или больше чем $b. Сравнение производится в соответствии с правилами сравнения типов PHP.

<?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

?>

Определение констант массивов с помощью define()

Можно определить константу типа array с помощью функции define(). В PHP 5.6 такие константы можно было задавать только с помощью const.

<?php

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

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

?>

Анонимные классы

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

<?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());

?>

object(class@anonymous)#2 (0) {
}

Подробную документацию и примеры использования читайте в разделе про анонимные классы.

Синтаксис экранирования кодовых точек Юникода

Синтаксис принимает кодовую точку Юникода в шестнадцатеричном формате, которую записали в кодировке UTF-8 как строку в двойных кавычках или heredoc-синтаксисом, и выводит эту кодовую точку в формате UTF-8. Синтаксис примет каждую допустимую кодовую точку. Ведущие нули в шестнадцатеричной последовательности указывать необязательно.

<?php

echo "\u{aa}", PHP_EOL;
echo "\u{0000aa}", PHP_EOL;

echo "\u{9999}", PHP_EOL;

echo <<<EOT
\u{01f418}
EOT;

?>

ª
ª (То же, что и первый вариант, но с ведущими нулями)
香

Closure::call()

Closure::call() — более производительный и короткий способ временного связывания области действия объекта с замыканием и его вызовом.

<?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);

?>

1
1

unserialize() с фильтрацией

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

<?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]);

?>

IntlChar

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

<?php

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

?>

10ffff
COMMERCIAL AT
bool(true)

Для работы с этим классом требуется установить модуль Intl.

Ожидания

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

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

<?php

ini_set('assert.exception', 1);

class CustomError extends AssertionError {}

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

?>

Fatal error: Uncaught CustomError: Сообщение об ошибке

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

Групповые объявления use

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

<?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};

?>

Выражение return в генераторах

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

<?php

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

    return 3;
})();

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

echo $gen->getReturn(), PHP_EOL;

?>

1
2
3

Явно получать конечное значение генератора полезно, поскольку разрешает клиентскому коду, который запустил генератор, получать и обрабатывать финальное значение генератора (возможно, из какой-то формы сопрограммных вычислений). Это значительно проще, чем заставлять клиентский код проверять, последнее ли значение вернул генератор, а затем, если это так, отдельно обрабатывать значение.

Делегация генератора

Теперь генераторы за счёт конструкции yield from умеют автоматически делегировать выдачу значений другому генератору, Traversable-объекту или массиву без написания шаблонного кода во внешнем генераторе.

<?php

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

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

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

?>

1
2
3
4

Функция целочисленного деления intdiv()

Новая функция intdiv() выполняет целочисленное деление операндов и возвращает результат деления.

<?php

var_dump(intdiv(10, 3));

?>

int(3)

Опции сессий

Теперь функция session_start() принимает массив опций, которые переопределят конфигурационные директивы сессии файла в php.ini.

Опции также расширили включённой по умолчанию опцией session.lazy_write, которая говорит PHP, что файл сессии нужно перезаписывать, только если изменились данные сессии, и опцией read_and_close, которую можно задать только через функцию session_start(), чтобы PHP закрывал сессию сразу после прочтения данных сессии и не вносил в сессию каких-либо изменений.

Приведём пример. Для установки директиве session.cache_limiter значения private и немедленному закрытию сессии после чтения данных сессии:

<?php

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

?>

preg_replace_callback_array()

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

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

Функции CSPRNG

Добавили две новые кросс-платформенные функции для генерации криптографически безопасных строк и целых чисел: random_bytes() и random_int().

Функция list() теперь всегда распаковывает объекты, которые реализуют интерфейс ArrayAccess

Раньше функция list() не гарантировала корректную обработку объектов, которые реализуют интерфейс ArrayAccess. Это исправили.

Другие изменения

• Добавили возможность доступа к методам и свойствам класса при клонировании, то есть (clone $foo)->bar().

Интернационализация

• IntlChar

Reflection

• ReflectionGenerator

• ReflectionType

Управление сессиями

• SessionUpdateTimestampHandlerInterface

Иерархия исключений

• Throwable

• Error

• TypeError

• ParseError

• AssertionError

• ArithmeticError

• DivisionByZeroError

Замыкания

• Closure::call()

CSPRNG

• random_bytes()

• random_int()

Обработка и логирование ошибок

• error_clear_last()

Генераторы

• Generator::getReturn()

Вычисления над целыми числами с произвольной точностью (GNU Multiple Precision)

• gmp_random_seed()

Математика

• intdiv()

PCRE

• preg_replace_callback_array()

Опции/информация PHP

• gc_mem_caches()

• get_resources()

POSIX

• posix_setrlimit()

Reflection

• ReflectionParameter::getType()

• ReflectionParameter::hasType()

• ReflectionFunctionAbstract::getReturnType()

• ReflectionFunctionAbstract::hasReturnType()

Zip

• ZipArchive::setCompressionIndex()

• ZipArchive::setCompressionName()

Компрессия Zlib

• inflate_add()

• deflate_add()

• inflate_init()

• deflate_init()

Константы предопределённые в ядре PHP

• PHP_INT_MIN

GD

• IMG_WEBP (с PHP 7.0.10)

JSON

• JSON_ERROR_INVALID_PROPERTY_NAME

• JSON_ERROR_UTF16

LibXML

• LIBXML_BIGLINES

PCRE

• PREG_JIT_STACKLIMIT_ERROR

POSIX

• POSIX_RLIMIT_AS

• POSIX_RLIMIT_CORE

• POSIX_RLIMIT_CPU

• POSIX_RLIMIT_DATA

• POSIX_RLIMIT_FSIZE

• POSIX_RLIMIT_LOCKS

• POSIX_RLIMIT_MEMLOCK

• POSIX_RLIMIT_MSGQUEUE

• POSIX_RLIMIT_NICE

• POSIX_RLIMIT_NOFILE

• POSIX_RLIMIT_NPROC

• POSIX_RLIMIT_RSS

• POSIX_RLIMIT_RTPRIO

• POSIX_RLIMIT_RTTIME

• POSIX_RLIMIT_SIGPENDING

• POSIX_RLIMIT_STACK

• POSIX_RLIMIT_INFINITY

Zlib

• ZLIB_ENCODING_RAW

• ZLIB_ENCODING_DEFLATE

• ZLIB_ENCODING_GZIP

• ZLIB_FILTERED

• ZLIB_HUFFMAN_ONLY

• ZLIB_FIXED

• ZLIB_RLE

• ZLIB_DEFAULT_STRATEGY

• ZLIB_BLOCK

• ZLIB_FINISH

• ZLIB_FULL_FLUSH

• ZLIB_NO_FLUSH

• ZLIB_PARTIAL_FLUSH

• ZLIB_SYNC_FLUSH

Ядро PHP

• debug_zval_dump() теперь печатает "int" вместо "long", и "float" вместо "double"

• dirname() принимает второй, необязательный, параметр depth, для получения имени директории на depth уровней выше текущей.

• getrusage() теперь поддерживается в Windows.

• Функции mktime() и gmmktime() больше не принимают параметр is_dst.

• Функция preg_replace() больше не поддерживает "\e" (PREG_REPLACE_EVAL). Вместо этого используйте preg_replace_callback().

• Функция setlocale() больше не принимает параметр category переданный в виде строки. Теперь нужно использовать константы LC_*.

• Функции exec(), system() и passthru() теперь защищены от NULL-байта.

• shmop_open() теперь возвращает не целое, а ресурс, который должен быть передан в shmop_size(), shmop_write(), shmop_read(), shmop_close() и shmop_delete().

• substr() и iconv_substr() возвращают пустую строку, если start равно длине строки.

• Использование xml_parser_free() теперь недостаточно для освобождения ресурса парсера, если он ссылается на объект, а этот объект ссылается на ресурс парсера. В таком случае необходимо дополнительно вручную удалить (unset) переменную $parser.

Изменения в обработке ошибок и исключений

В PHP 7 многие фатальные и поправимые фатальные ошибки переделали в исключения. Эти исключения наследуют класс Error, который, в свою очередь, реализует интерфейс Throwable (новый базовый интерфейс, который наследуют исключения).

Поэтому пользовательские обработчики ошибок не вызовутся, если вместо вызова ошибки выбросится исключение (порождая новые фатальные ошибки из-за неперехваченных исключений класса Error).

Более подробное описание работы ошибок в PHP 7 даёт страница ошибки PHP 7. Это руководство только перечисляет изменения, которые приводят к обратной несовместимости.

<?php

// Только PHP 5. В PHP 7 при исключении другого типа вызывает фатальную ошибку
function handler(Exception $e) { /* ... */ }
set_exception_handler('handler');

// Будет работать PHP 5 и 7
function handler($e) { /* ... */ }

// Только PHP 7
function handler(Throwable $e) { /* ... */ }

?>

Изменения в обработке переменных

PHP 7 использует абстрактное синтаксическое дерево при разборе файлов с исходным кодом. Это позволило внести множество улучшений в язык, которые ранее были невозможны из-за ограничений парсера, использовавшегося в предыдущих версиях PHP, но привело к удалению некоторых особых возможностей по соображениям согласованности и нарушило обратную совместимость. Описание этих особых случаев приведено в этой секции.

<?php
function f() {
    // Корректно только в PHP 5.
    global $$foo->bar;

    // Корректно в PHP 5 и 7.
    global ${$foo->bar};
}
?>

<?php
list($a[], $a[], $a[]) = [1, 2, 3];
var_dump($a);
?>

array(3) {
  [0]=>
  int(3)
  [1]=>
  int(2)
  [2]=>
  int(1)
}

array(3) {
  [0]=>
  int(1)
  [1]=>
  int(2)
  [2]=>
  int(3)
}

<?php
list() = $a;
list(,,) = $a;
list($x, list(), $y) = $a;
?>

<?php
$array = [];
$array["a"] =& $array["b"];
$array["b"] = 1;
var_dump($array);
?>

array(2) {
  ["b"]=>
  &int(1)
  ["a"]=>
  &int(1)
}

array(2) {
  ["a"]=>
  &int(1)
  ["b"]=>
  &int(1)
}

<?php
function getArray() {
    return [1, 2, 3];
}

function squareArray(array &$a) {
    foreach ($a as &$v) {
        $v **= 2;
    }
}

// Выведет предупреждение в PHP 7.
squareArray((getArray()));
?>

Notice: Only variables should be passed by reference in /tmp/test.php on line 13

Изменения foreach

Небольшие изменения были внесены в поведение управляющей структуры foreach. Основное изменение касается модификации итерируемого массива и обработки его внутреннего указателя.

<?php
$array = [0, 1, 2];
foreach ($array as &$val) {
    var_dump(current($array));
}
?>

int(1)
int(2)
bool(false)

int(0)
int(0)
int(0)

<?php
$array = [0];
foreach ($array as &$val) {
    var_dump($val);
    $array[1] = 1;
}
?>

int(0)

int(0)
int(1)

Изменение в обработке значений типа int

<?php
var_dump(1 >> -1);
?>

int(0)

Fatal error: Uncaught ArithmeticError: Bit shift by negative number in /tmp/test.php:2
Stack trace:
#0 {main}
  thrown in /tmp/test.php on line 2

<?php
var_dump(3/0);
var_dump(0/0);
var_dump(0%0);
?>

Warning: Division by zero in %s on line %d
bool(false)

Warning: Division by zero in %s on line %d
bool(false)

Warning: Division by zero in %s on line %d
bool(false)

Warning: Division by zero in %s on line %d
float(INF)

Warning: Division by zero in %s on line %d
float(NAN)

PHP Fatal error:  Uncaught DivisionByZeroError: Modulo by zero in %s line %d

Изменения в обработке строк

<?php
var_dump("0x123" == "291");
var_dump(is_numeric("0x123"));
var_dump("0xe" + "0x1");
var_dump(substr("foo", "0x1"));
?>

bool(true)
bool(true)
int(15)
string(2) "oo"

bool(false)
bool(false)
int(0)

Notice: A non well formed numeric value encountered in /tmp/test.php on line 5
string(3) "foo"

<?php
$str = "0xffff";
$int = filter_var($str, FILTER_VALIDATE_INT, FILTER_FLAG_ALLOW_HEX);
if (false === $int) {
    throw new Exception("Некорректное целое число!");
}
var_dump($int); // int(65535)
?>

Удалённые функции

Удалённые директивы INI-файла

Прочие изменения, которые затрагивают обратную совместимость

<?php

class C {}
$c =& new C;

?>

Deprecated: Assigning the return value of new by reference is deprecated in /tmp/test.php on line 3

Parse error: syntax error, unexpected 'new' (T_NEW) in /tmp/test.php on line 3

<?php

class A
{
    public function test()
    {
        var_dump($this);
    }
}

// Обратите внимание: класс B не расширяет класс A
class B
{
    public function callNonStaticMethodOfA()
    {
        A::test();
    }
}

(new B())
    ->callNonStaticMethodOfA()
;

?>

Deprecated: Non-static method A::test() should not be called statically, assuming $this from incompatible context in /tmp/test.php on line 8
object(B)#1 (0) {
}

Deprecated: Non-static method A::test() should not be called statically in /tmp/test.php on line 8

Notice: Undefined variable: this in /tmp/test.php on line 3
NULL

<?php

echo yield -1;
// Раньше интерпретировалось так
echo (yield) - 1;
// А теперь так
echo yield (-1);

yield $foo or die;
// Раньше интерпретировалось так
yield ($foo or die);
// А теперь так
(yield $foo) or die;

?>

<?php

function foo($a, $b, $unused, $unused)
{
    //
}

?>

<?php

function foo($x)
{
    $x++;
    var_dump(func_get_arg(0));
}

foo(1);

?>

1

2

<?php

switch (1) {
    default:
        break;
    default:
        break;
}

?>