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

Ядро PHP

Менеджер процессов FastCGI

Для настройки логирования FPM были добавлены новые опции:

log_limit

Эта глобальная опция может использоваться для установки лимита логирования для строки логирования, позволяющая записывать сообщения длиной более 1024 символов без переноса. Также исправляет различные проблемы с упаковкой (wrapping).

log_buffering

Этот глобальная опция позволяет вести экспериментальное логирование без дополнительной буферизации.

decorate_workers_output

Этот вариант пула позволяет отключить отметку вывода (output decoration) для обработчиков, когда catch_workers_output включена.

Функции BC Math

Функция bcscale() теперь также может использоваться как геттер для извлечения текущего используемого масштаба.

Облегчённый протокол доступа к каталогам (LDAP)

Была добавлена полная поддержка LDAP Controls к функциям запросов LDAP и ldap_parse_result():

• Добавлен параметр $controls для отправки управления серверу в функциях ldap_add(), ldap_mod_replace(), ldap_mod_add(), ldap_mod_del(), ldap_rename(), ldap_compare(), ldap_delete(), ldap_modify_batch(), ldap_search(), ldap_list() и ldap_read().

• Добавлен параметр $controls для получения управления с сервера в функции ldap_parse_result().

• Поддержка LDAP_OPT_SERVER_CONTROLS и LDAP_OPT_CLIENT_CONTROLS в функциях ldap_get_option() и ldap_set_option() была исправлена.

Функции мультибайтовых строк

<?php

mb_strtoupper("Straße");
// Выведет STRAßE в PHP 7.2
// Выведет STRASSE в PHP 7.3

?>

<?php
mb_ereg('(?<word>\w+)', '国', $matches);
// => [0 => "国", 1 => "国", "word" => "国"];
?>

<?php
mb_ereg_replace('\s*(?<word>\w+)\s*', "_\k<word>_\k'word'_", ' foo ');
// => "_foo_foo_"
?>

Readline

В функции readline_info() добавлена поддержка параметров completion_append_character и completion_suppress_append. Эти опции доступны, только если PHP скомпилирован с библиотекой libreadline (а не libedit).

Ядро PHP

• array_key_first()

• array_key_last()

• gc_status()

• hrtime()

• is_countable()

• net_get_interfaces()

Менеджер процессов FastCGI

• fpm_get_status()

Дата и время

• DateTime::createFromImmutable()

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

• gmp_binomial()

• gmp_kronecker()

• gmp_lcm()

• gmp_perfect_power()

Функции интернационализации

• Normalizer::getRawDecomposition()

• normalizer_get_raw_decomposition()

• Spoofchecker::setRestrictionLevel()

Облегчённый протокол доступа к каталогам (LDAP)

• ldap_add_ext()

• ldap_bind_ext()

• ldap_delete_ext()

• ldap_exop_refresh()

• ldap_mod_add_ext()

• ldap_mod_replace_ext()

• ldap_mod_del_ext()

• ldap_rename_ext()

OpenSSL

• openssl_pkey_derive()

Сокеты

• socket_wsaprotocol_info_export()

• socket_wsaprotocol_info_import()

• socket_wsaprotocol_info_release()

Ядро PHP

• PASSWORD_ARGON2ID

Библиотека Client URL (cURL)

• CURLAUTH_BEARER

• CURLAUTH_GSSAPI

• CURLE_WEIRD_SERVER_REPLY

• CURLINFO_APPCONNECT_TIME_T

• CURLINFO_CONNECT_TIME_T

• CURLINFO_CONTENT_LENGTH_DOWNLOAD_T

• CURLINFO_CONTENT_LENGTH_UPLOAD_T

• CURLINFO_FILETIME_T

• CURLINFO_HTTP_VERSION

• CURLINFO_NAMELOOKUP_TIME_T

• CURLINFO_PRETRANSFER_TIME_T

• CURLINFO_PROTOCOL

• CURLINFO_PROXY_SSL_VERIFYRESULT

• CURLINFO_REDIRECT_TIME_T

• CURLINFO_SCHEME

• CURLINFO_SIZE_DOWNLOAD_T

• CURLINFO_SIZE_UPLOAD_T

• CURLINFO_SPEED_DOWNLOAD_T

• CURLINFO_SPEED_UPLOAD_T

• CURLINFO_STARTTRANSFER_TIME_T

• CURLINFO_TOTAL_TIME_T

• CURL_LOCK_DATA_CONNECT

• CURL_LOCK_DATA_PSL

• CURL_MAX_READ_SIZE

• CURLOPT_ABSTRACT_UNIX_SOCKET

• CURLOPT_DISALLOW_USERNAME_IN_URL

• CURLOPT_DNS_SHUFFLE_ADDRESSES

• CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS

• CURLOPT_HAPROXYPROTOCOL

• CURLOPT_KEEP_SENDING_ON_ERROR

• CURLOPT_PRE_PROXY

• CURLOPT_PROXY_CAINFO

• CURLOPT_PROXY_CAPATH

• CURLOPT_PROXY_CRLFILE

• CURLOPT_PROXY_KEYPASSWD

• CURLOPT_PROXY_PINNEDPUBLICKEY

• CURLOPT_PROXY_SSLCERT

• CURLOPT_PROXY_SSLCERTTYPE

• CURLOPT_PROXY_SSL_CIPHER_LIST

• CURLOPT_PROXY_SSLKEY

• CURLOPT_PROXY_SSLKEYTYPE

• CURLOPT_PROXY_SSL_OPTIONS

• CURLOPT_PROXY_SSL_VERIFYHOST

• CURLOPT_PROXY_SSL_VERIFYPEER

• CURLOPT_PROXY_SSLVERSION

• CURLOPT_PROXY_TLS13_CIPHERS

• CURLOPT_PROXY_TLSAUTH_PASSWORD

• CURLOPT_PROXY_TLSAUTH_TYPE

• CURLOPT_PROXY_TLSAUTH_USERNAME

• CURLOPT_REQUEST_TARGET

• CURLOPT_SOCKS5_AUTH

• CURLOPT_SSH_COMPRESSION

• CURLOPT_SUPPRESS_CONNECT_HEADERS

• CURLOPT_TIMEVALUE_LARGE

• CURLOPT_TLS13_CIPHERS

• CURLPROXY_HTTPS

• CURLSSH_AUTH_GSSAPI

• CURL_SSLVERSION_MAX_DEFAULT

• CURL_SSLVERSION_MAX_NONE

• CURL_SSLVERSION_MAX_TLSv1_0

• CURL_SSLVERSION_MAX_TLSv1_1

• CURL_SSLVERSION_MAX_TLSv1_2

• CURL_SSLVERSION_MAX_TLSv1_3

• CURL_SSLVERSION_TLSv1_3

• CURL_VERSION_ALTSVC (начиная с PHP 7.3.6)

• CURL_VERSION_ASYNCHDNS

• CURL_VERSION_BROTLI

• CURL_VERSION_CONV

• CURL_VERSION_CURLDEBUG (начиная с PHP 7.3.6)

• CURL_VERSION_DEBUG

• CURL_VERSION_GSSAPI

• CURL_VERSION_GSSNEGOTIATE

• CURL_VERSION_HTTPS_PROXY

• CURL_VERSION_IDN

• CURL_VERSION_LARGEFILE

• CURL_VERSION_MULTI_SSL

• CURL_VERSION_NTLM

• CURL_VERSION_NTLM_WB

• CURL_VERSION_PSL (начиная с PHP 7.3.6)

• CURL_VERSION_SPNEGO

• CURL_VERSION_SSPI

• CURL_VERSION_TLSAUTH_SRP

Фильтрация данных

• FILTER_SANITIZE_ADD_SLASHES

Объектная нотация JavaScript (JSON)

• JSON_THROW_ON_ERROR

Облегчённый протокол доступа к каталогам (LDAP)

• LDAP_CONTROL_ASSERT

• LDAP_CONTROL_MANAGEDSAIT

• LDAP_CONTROL_PROXY_AUTHZ

• LDAP_CONTROL_SUBENTRIES

• LDAP_CONTROL_VALUESRETURNFILTER

• LDAP_CONTROL_PRE_READ

• LDAP_CONTROL_POST_READ

• LDAP_CONTROL_SORTREQUEST

• LDAP_CONTROL_SORTRESPONSE

• LDAP_CONTROL_PAGEDRESULTS

• LDAP_CONTROL_AUTHZID_REQUEST

• LDAP_CONTROL_AUTHZID_RESPONSE

• LDAP_CONTROL_SYNC

• LDAP_CONTROL_SYNC_STATE

• LDAP_CONTROL_SYNC_DONE

• LDAP_CONTROL_DONTUSECOPY

• LDAP_CONTROL_PASSWORDPOLICYREQUEST

• LDAP_CONTROL_PASSWORDPOLICYRESPONSE

• LDAP_CONTROL_X_INCREMENTAL_VALUES

• LDAP_CONTROL_X_DOMAIN_SCOPE

• LDAP_CONTROL_X_PERMISSIVE_MODIFY

• LDAP_CONTROL_X_SEARCH_OPTIONS

• LDAP_CONTROL_X_TREE_DELETE

• LDAP_CONTROL_X_EXTENDED_DN

• LDAP_CONTROL_VLVREQUEST

• LDAP_CONTROL_VLVRESPONSE

Мультибайтовые строки

• MB_CASE_FOLD

• MB_CASE_LOWER_SIMPLE

• MB_CASE_UPPER_SIMPLE

• MB_CASE_TITLE_SIMPLE

• MB_CASE_FOLD_SIMPLE

OpenSSL

• STREAM_CRYPTO_PROTO_SSLv3

• STREAM_CRYPTO_PROTO_TLSv1_0

• STREAM_CRYPTO_PROTO_TLSv1_1

• STREAM_CRYPTO_PROTO_TLSv1_2

PostgreSQL

• PGSQL_DIAG_SCHEMA_NAME

• PGSQL_DIAG_TABLE_NAME

• PGSQL_DIAG_COLUMN_NAME

• PGSQL_DIAG_DATATYPE_NAME

• PGSQL_DIAG_CONSTRAINT_NAME

• PGSQL_DIAG_SEVERITY_NONLOCALIZED

Ядро PHP

<?php

$str = <<<FOO
abcdefg
   FOO
FOO;

?>

<?php

while ($foo) {
    switch ($bar) {
      case "baz":
         continue;
         // Предупреждение: "continue" эквивалентен
         //          "break". Возможно, вы имели в виду "continue 2"?
   }
}

?>

<?php

class Test
{
    public static $x = 0;
}

class Test2 extends Test { }

Test2::$x = &$x;
$x = 1;

var_dump(Test::$x, Test2::$x);
// Раньше:  int(0), int(1)
// Теперь: int(1), int(1)

?>

<?php

$arr = [1];
$ref =& $arr[0];
var_dump($arr[0] + ($arr[0] = 2));
// Раньше: int(4), Теперь: int(3)

?>

<?php

function foo(...$args)
{
    var_dump($args);
}

function gen()
{
    yield 1.23 => 123;
}

foo(...gen());

?>

Произвольной точности математика BCMath

Все предупреждения, выброшенные функциями BCMath, теперь используют обработку ошибок PHP. Раньше некоторые предупреждения были непосредственно отправлены в поток stderr.

Функции bcmul() и bcpow() теперь возвращают числа с запрошенным масштабом. Раньше возвращаемые числа могли опускать завершающие десятичные нули.

IMAP, POP3 и NNTP

Логины rsh/ssh по умолчанию отключены. Используйте imap.enable_insecure_rsh, если вы хотите включить их. Обратите внимание, что библиотека IMAP не фильтрует имена почтовых ящиков перед передачей их команде rsh/ssh, таким образом, передача ненадёжных данных этой функции с включённым rsh/ssh небезопасна.

Мультибайтовые строки

Из-за дополнительной поддержки именованных фрагментов, паттерны mb_ereg_*() с использованием именованных фрагментов будут вести себя по-разному. В частности, именованные фрагменты будут частью совпадений, а функция mb_ereg_replace() будет интерпретировать дополнительный синтаксис. Смотрите Именованные фрагменты для получения дополнительной информации.

Улучшенный модуль MySQL

Подготовленные запросы теперь правильно указывают на дробные секунды для столбцов DATETIME, TIME и TIMESTAMP с указателем десятичных знаков (например, TIMESTAMP(6) при использовании микросекунд). Раньше часть дробных секунд была просто опущена из возвращаемых значений.

Функции MySQL (PDO_MYSQL)

Подготовленные запросы теперь правильно указывают на дробные секунды для столбцов DATETIME, TIME и TIMESTAMP со спецификатором десятичных знаков (например, TIMESTAMP(6) при использовании микросекунд). Ранее, дробная часть секунд была просто опущена из возвращаемых значений. Обратите внимание, что это влияет только на использование PDO_MYSQL с отключённой эмуляцией подготовленных запросов (например, с использованием нативной функциональности). Запросы, использующие соединения, у которых задана опция PDO::ATTR_EMULATE_PREPARES=true (значение по умолчанию), не были затронуты данным исправлением ошибки и уже получали корректные значения долей секунды от движка.

Reflection

Экспорт объектов Reflection в строку теперь использует int) и bool) вместо integer and boolean, соответственно.

Стандартная библиотека PHP (SPL)

Если автозагрузчик SPL выбрасывает исключение, последующие автозагрузчики не будут выполняться. Раньше все автозагрузчики выполнялись, а исключения объединялись в цепочку вызовов.

SimpleXML

Математические операции, которые включают объекты SimpleXML, теперь будут обрабатывать текст как целое число (int) или число с плавающей точкой (float), в зависимости от того, что является более подходящим. Раньше значения обрабатывались как целые числа (integer) без каких-либо условий.

Входящие Cookies

Начиная с PHP 7.3.23 имена входящих cookie больше не декодируются из URL-закодированной строки из соображений безопасности.

Ядро PHP

Фильтрация данных

Явное использование констант FILTER_FLAG_SCHEME_REQUIRED и FILTER_FLAG_HOST_REQUIRED теперь объявлено устаревшим; так или иначе, они подразумевают использование FILTER_VALIDATE_URL.

Обработка изображений и GD

Функция image2wbmp() объявлена устаревшей.

Функции интернационализации

Использование Normalizer::NONE вызывает предупреждение об устаревшем поведении, если PHP не скомпилирован с ICU версии ≥ 56.

Мультибайтовые строки

Следующие недокументированные псевдонимы mbereg_*() объявлены устаревшими. Вместо этого используйте соответствующие варианты mb_ereg_*().

• mbregex_encoding()

• mbereg()

• mberegi()

• mbereg_replace()

• mberegi_replace()

• mbsplit()

• mbereg_match()

• mbereg_search()

• mbereg_search_pos()

• mbereg_search_regs()

• mbereg_search_init()

• mbereg_search_getregs()

• mbereg_search_getpos()

• mbereg_search_setpos()

Функции ODBC и DB2 (PDO_ODBC)

Настройка ini-файла pdo_odbc.db2_instance_name официально объявлено устаревшим. Опция устарела в документации, начиная с PHP 5.1.1.

Ядро PHP

Интерактивный отладчик PHP

Удалены неиспользуемые константы PHPDBG_FILE, PHPDBG_METHOD, PHPDBG_LINENO и PHPDBG_FUNC.

Менеджер процессов FastCGI

Теперь также доступна функция getallheaders().

Библиотека Client URL (cURL)

Теперь требуется библиотека libcurl версии ≥ 7.15.5.

Фильтрация данных

FILTER_VALIDATE_FLOAT теперь также поддерживает параметр thousand, который определяет набор разрешённых символов-разделителей для тысяч. Значение по умолчанию ("',.") полностью обратно совместимо с предыдущими версиями PHP.

FILTER_SANITIZE_ADD_SLASHES был добавлен в качестве псевдонима фильтра magic_quotes (FILTER_SANITIZE_MAGIC_QUOTES). Фильтр magic_quotes подлежит удалению в будущих версиях PHP.

FTP

Режим по умолчанию изменён на binary.

Функции интернационализации

Константа Normalizer::NONE объявлена устаревшей, когда PHP скомпилирован с ICU версии ≥ 56.

Введена константа Normalizer::FORM_KC_CF в качестве аргумента Normalizer::normalize() для нормализации NFKC_Casefold; доступна, когда есть ICU ≥ 56.

Объектная нотация JavaScript (JSON)

Добавлен новый флаг JSON_THROW_ON_ERROR, который можно использовать с json_decode() или json_encode() и заставляет эти функции выбрасывать новое исключение JsonException в случае возникновения ошибки, вместо того, чтобы устанавливать глобальное состояние ошибки, которое извлекается с помощью json_last_error() и json_last_error_msg(). JSON_PARTIAL_OUTPUT_ON_ERROR имеет приоритет над JSON_THROW_ON_ERROR.

Мультибайтовые строки

Конфигурационная опция --with-libmbfl больше недоступна.

ODBC (Unified)

Поддержка ODBCRouter и Birdstep, включая ini-директиву birdstep.max_links была удалена.

OPcache

Удалена ini-директива opcache.inherited_hack. Это значение уже игнорировалось с PHP 5.3.0.

OpenSSL

Добавлены опции потока ssl min_proto_version и max_proto_version, а также соответствующие с ними константы для возможных значений протокола TLS.

Регулярные выражения (совместимые с Perl)

Модуль PCRE был обновлён до PCRE2, что может привести к незначительным изменениям в поведении (например, диапазоны символов в классах теперь интерпретируются более строго) и дополняет существующий синтаксис регулярных выражений.

Функция preg_quote() теперь также экранирует символ '#'.

Microsoft SQL Server и функции Sybase (PDO_DBLIB)

Добавлен атрибут PDO::DBLIB_ATTR_SKIP_EMPTY_ROWSETS для автоматического пропуска пустых наборов строк.

Добавлен атрибут PDO::DBLIB_ATTR_TDS_VERSION который представляет версию TDS.

Столбцы DATETIME2 теперь обрабатываются как столбцы DATETIME.

Функции SQLite (PDO_SQLITE)

Базы данных SQLite3 теперь можно открыть в режиме только для чтения, установив новый атрибут PDO::SQLITE_ATTR_OPEN_FLAGS на значение PDO::SQLITE_OPEN_READONLY.

Обработка сессий

Функция session_set_cookie_params() теперь также поддерживает следующее объявление (сигнатуру):

Tidy

Сборка вместе » tidyp теперь также поддерживается прозрачно. Поскольку tidyp не предлагает API для получения даты релиза, tidy_get_release() и tidy::getRelease() возвращает значение 'unknown' в этом случае.

XML-парсер

Возвращаемое значение callback-функции xml_set_external_entity_ref_handler() больше не игнорируется, если модуль был собран с библиотекой libxml. Ранее возвращаемое значение игнорировалось, а парсинг никогда не прекращался.

Zip

Сборка с использованием libzip, входящего в PHP, не рекомендуется, но всё же возможна путём добавления --without-libzip в конфигурацию.

Сжатие Zlib

Добавлен параметр контекста zlib/level для обёртки compress.zlib, чтобы облегчить установку желаемого уровня сжатия.

Ядро PHP

Ядро PHP

<?php

class User
{
    public int $id;
    public string $name;
}

<?php

$factor = 10;
$nums = array_map(fn ($n) => $n * $factor, [1, 2, 3, 4]);
// $nums = array(10, 20, 30, 40);

<?php

class A {}
class B extends A {}

class Producer
{
    public function method(): A {}
}

class ChildProducer extends Producer
{
    public function method(): B {}
}

<?php

/**
 * Класс удовлетворяет принципу подстановки Б. Ли́сков (англ. Liskov Substitution Principle, LSP),
 * поскольку класс C принадлежит подтипу A,
 * но при объявлении класса B класс C ещё недоступен
 */
class A
{
    public function method(): A {}
}

class B extends A
{
    // Fatal error: Could not check compatibility between B::method():C and
    // A::method(): A, because class C is not available
    public function method(): С {}
}

class C extends B {}

<?php

$array['key'] ??= computeDefault();

// Предыдущая проверка на null с присваиванием — примерно то же, что:
if (!isset($array['key'])) {
    $array['key'] = computeDefault();
}

<?php

$parts = ['apple', 'pear'];

$fruits = ['banana', 'orange', ...$parts, 'watermelon'];
// ['banana', 'orange', 'apple', 'pear', 'watermelon'];

<?php

6.674_083e-11; // число с плавающей точкой
299_792_458;   // десятичное число
0xCAFE_F00D;   // шестнадцатеричное число
0b0101_1111;   // двоичное число

Модуль cURL

В дополнение к станадртным названиям файлов класс CURLFile теперь поддерживает потоковые обёртки, если модуль собрали с библиотекой libcurl >= 7.56.0.

Модуль Filter

Фильтр FILTER_VALIDATE_FLOAT теперь поддерживает параметры min_range и max_range, с тем же смыслом, что и фильтр FILTER_VALIDATE_INT.

Модуль FFI

FFI — новый модуль, который предлагает простой способ вызова библиотечных функций, доступа к встроенным переменным и способ создавать или обращаться к структурам данных, которые определили в библиотеках на языке Си.

Модуль GD

Добавили константу IMG_FILTER_SCATTER для применения рассеивающегося фильтра к изображениям.

Модуль Hash

Добавили поддержку алгоритма crc32c, который вычисляет «хеш» на основе полинома Кастаноли. С этой реализацией алгоритма CRC32 работают системы хранения наподобие iSCSI, SCTP, Btrfs и ext4.

Многобайтовые строки

Добавили функцию mb_str_split(), которая выполняет то же, что и функция str_split(), но работает с кодовыми точками, а не с байтами.

Модуль OPcache

Добавили поддержку предварительной загрузки кода.

Регулярные выражения, совместимые с синтаксисом языка Perl

Функции preg_replace_callback() и preg_replace_callback_array() теперь принимают дополнительный аргумент flags с поддержкой флагов PREG_OFFSET_CAPTURE и PREG_UNMATCHED_AS_NULL. Он повлияет на формат массива совпавших значений, передаваемого в callback-функцию.

Модуль PDO

Имя пользователя и пароль как часть DSN-строки разрешили указывать для драйверов mysql, mssql, sybase, dblib, firebird и oci. Раньше это поддерживалось только для драйвера pgsql. Конструктор будет приоритетнее, если имя пользователя с паролем указали и в конструкторе, и в DSN-строке.

В SQL-запросах разрешили экранировать вопросительные знаки, чтобы они не воспринимались как заполнители параметров. Запись ?? отправит один знак вопроса в базу данных, и разрешит, например при работе с СУБД PostgreSQL, указывать оператор ?, чтобы проверить, содержит ли столбец JSON конкретный ключ.

Драйвер PDO_OCI

Для драйвера теперь доступен метод PDOStatement::getColumnMeta().

Драйвер PDO_SQLite

Вызов PDOStatement::getAttribute(PDO::SQLITE_ATTR_READONLY_STATEMENT) проверит, доступен ли подготовленный запрос только для чтения, т. е. не изменяет ли запрос базу данных.

При установке PDO::setAttribute(PDO::SQLITE_ATTR_EXTENDED_RESULT_CODES, true) методы PDO::errorInfo() и PDOStatement::errorInfo() возвращают расширенные коды ошибок СУБД SQLite3.

SQLite3

Добавили метод SQLite3::lastExtendedErrorCode(), который получает последний расширенный код ошибки.

Добавили метод SQLite3::enableExtendedResultCodes($enable = true), который заставит метод SQLite3::lastErrorCode() возвращать расширенные коды ошибок.

Стандартные функции языка

<?php

// Метод возвращает массив с данными для сохранения целостного состояния объекта
public function __serialize(): array {}

// Восстанавливает состояние объекта из массива данных
public function __unserialize(array $data): void {}

<?php

proc_open(['php', '-r', 'echo "Привет, мир\n";'], $descriptors, $pipes);

<?php

// То же самое, что и 2>&1 в командной оболочке
proc_open($cmd, [1 => ['pipe', 'w'], 2 => ['redirect', 1]], $pipes);

// То же самое, что и 2>/dev/null или 2>nul в командной оболочке
proc_open($cmd, [1 => ['pipe', 'w'], 2 => ['null']], $pipes);

Reflection

• ReflectionReference

Ядро PHP

• get_mangled_object_vars()

• password_algos()

• sapi_windows_set_ctrl_handler()

GD

• imagecreatefromtga()

Многобайтовые строки

• mb_str_split()

OpenSSL

• openssl_x509_verify()

Управление процессами

• pcntl_unshare()

SQLite3

• SQLite3::backup()

• SQLite3Stmt::getSQL()

Ядро PHP

• PHP_WINDOWS_EVENT_CTRL_C

• PHP_WINDOWS_EVENT_CTRL_BREAK

Мультибайтовые строки

• MB_ONIGURUMA_VERSION

Сокеты

Добавлены следующие опции сокетов для FreeBSD:

• SO_LABEL

• SO_PEERLABEL

• SO_LISTENQLIMIT

• SO_LISTENQLEN

• SO_USER_COOKIE

Tidy

• TIDY_TAG_ARTICLE

• TIDY_TAG_ASIDE

• TIDY_TAG_AUDIO

• TIDY_TAG_BDI

• TIDY_TAG_CANVAS

• TIDY_TAG_COMMAND

• TIDY_TAG_DATALIST

• TIDY_TAG_DETAILS

• TIDY_TAG_DIALOG

• TIDY_TAG_FIGCAPTION

• TIDY_TAG_FIGURE

• TIDY_TAG_FOOTER

• TIDY_TAG_HEADER

• TIDY_TAG_HGROUP

• TIDY_TAG_MAIN

• TIDY_TAG_MARK

• TIDY_TAG_MENUITEM

• TIDY_TAG_METER

• TIDY_TAG_NAV

• TIDY_TAG_OUTPUT

• TIDY_TAG_PROGRESS

• TIDY_TAG_SECTION

• TIDY_TAG_SOURCE

• TIDY_TAG_SUMMARY

• TIDY_TAG_TEMPLATE

• TIDY_TAG_TIME

• TIDY_TAG_TRACK

• TIDY_TAG_VIDEO

Ядро PHP

Вычисления над числами с произвольной точностью BCMath

Теперь функции BCMath будут выдавать предупреждения, если передано число с ошибкой, например, "32foo". Подобный аргумент, как и раньше, будет интерпретирован как ноль.

CURL

Попытка сериализации класса CURLFile теперь создаст исключение. Ранее исключение выбрасывалось только при десериализации.

Использование CURLPIPE_HTTP1 объявлено устаревшим, и не будет поддерживаться с версии cURL 7.62.0.

Параметр $version функции curl_version() объявлен устаревшим. Если передаётся значение, не равное CURLVERSION_NOW по умолчанию, будет вызвано предупреждение, а параметр проигнорирован.

Дата и время

Вызов функции var_dump() или похожих отладочных функций на экземпляре класса DateTime или DateTimeImmutable больше не оставляет внутренние свойства объекта доступными для прямого считывания или записи при очередном обращении.

Сравнение объектов DateInterval (с использованием ==, < и т.д.) теперь создаёт предупреждение и всегда возвращает false. Ранее все объекты DateInterval считались одинаковыми, если у них не было свойств.

Intl

Значение параметров по умолчанию в функциях idn_to_ascii() и idn_to_utf8() теперь INTL_IDNA_VARIANT_UTS46 вместо устаревшего INTL_IDNA_VARIANT_2003.

MySQLi

Функциональность встроенного сервера была удалена. Она была сломана как минимум с PHP 7.0.

Недокументированное свойство mysqli::$stat было удалено в пользу использования mysqli::stat().

OpenSSL

Функция openssl_random_pseudo_bytes() теперь будет выбрасывать исключение в тех же ситуациях, что и функция random_bytes(). В частности, выбрасывается исключение Error, если количество запрошенных байтов меньше или равно нулю. Исключение Exception выбрасывается, если не получена достаточная случайность. Аргумент $crypto_strong гарантированно будет равен true, если функция ничего не выбрасывает, поэтому явно проверять его не нужно.

Регулярные выражения (совместимые Perl)

При использовании флага PREG_UNMATCHED_AS_NULL, завершающие несовпадающие подмаски теперь будут иметь значение null (или [null, -1], если включено сохранение позиции подмаски). Это означает, что размер $matches всегда будет одинаковым.

Объекты данных PHP (PDO)

Попытка сериализовать экземпляр PDO или PDOStatement теперь создаст Exception, а не PDOException, по аналогии с другими внутренними классами, которые не поддерживают сериализацию.

Reflection

Объекты Reflection теперь создают исключение, если попробовать их сериализовать. Сериализация объектов Reflection никогда не поддерживалась и приводила к повреждению объектов Reflection. Сейчас это было явно запрещено.

Изменились значения констант классов ReflectionClassConstant, ReflectionMethod и ReflectionProperty.

Стандартная библиотека PHP (SPL)

Вызов get_object_vars() с экземпляром ArrayObject теперь всегда будет возвращать свойства самого ArrayObject (или подкласса). Ранее он возвращал значения упакованного массива/объекта, если не был указан флаг ArrayObject::STD_PROP_LIST.

Другие затронутые операции:

• ReflectionObject::getProperties()

• reset(), current() и т.д. Используйте вместо этого методы Iterator.

• Вероятно, все остальное работает со свойствами объекта при доступе в виде списка, например, array_walk().

На приведение типа (array) эти изменения не повлияют. Они по-прежнему возвращают либо упакованный массив, либо свойства ArrayObject, в зависимости от того, используется ли флаг ArrayObject::STD_PROP_LIST.

Метод SplPriorityQueue::setExtractFlags() выбросит исключение, если передан ноль. Ранее это приводило к отлавливаемой фатальной ошибке при следующей операции извлечения.

ArrayObject, ArrayIterator, SplDoublyLinkedList и SplObjectStorage теперь поддерживают __serialize() и __unserialize() в дополнение к интерфейсу Serializable. Поэтому теперь созданные в более старых версиях PHP сериализованные данные, всё ещё могут быть неверно обработаны. Однако новые созданные сериализованные данные в PHP 7.4, не будут восприниматься в более старых версиях.

Лексер (Tokenizer)

Функция token_get_all() теперь отобразит метку T_BAD_CHARACTER в случае обнаружения непредвиденных символов в потоке меток.

Входящие Cookies

Начиная с PHP 7.4.11 имена входящих cookie больше не декодируются из URL-закодированной строки из соображений безопасности.

Ядро PHP

<?php
1 ? 2 : 3 ? 4 : 5;   // устарело
(1 ? 2 : 3) ? 4 : 5; // хорошо
1 ? 2 : (3 ? 4 : 5); // хорошо
?>

1 ? 2 ? 3 : 4 : 5 // хорошо

COM

Импорт библиотек типов с регистрацией констант без учёта регистра объявлен устаревшим.

Фильтрация

Фильтр FILTER_SANITIZE_MAGIC_QUOTES объявлен устаревшим, вместо него используйте FILTER_SANITIZE_ADD_SLASHES.

Многобайтовые строки

Передача нестрокового шаблона в mb_ereg_replace() объявлена устаревшей. В данный момент нестроковые значения интерпретируются как кодовые точки ASCII. В PHP 8 шаблон будет обрабатываться как строка.

Передача кодировки в качестве 3-го параметра в mb_strrpos() объявлена устаревшей. Вместо этого передавайте позицию как 0, а кодировку в 4-м параметре.

Облегчённый протокол доступа к каталогам (LDAP)

Функции ldap_control_paged_result_response() и ldap_control_paged_result() объявлены устаревшими. Для управления постраничным режимом используйте функцию ldap_search().

Reflection

Вызовы ReflectionType::__toString() теперь создают уведомление об устаревшей возможности. Этот метод объявлен устаревшим в пользу использования ReflectionNamedType::getName() в документации с PHP 7.1, но не выдавал соответствующего уведомления по техническим причинам.

Методы export() у всех классов Reflection объявлены устаревшими. Теперь создавайте объект Reflection и преобразуйте его в строку:

<?php
// Вместо ReflectionClass::export(Foo::class, false) используйте:
echo new ReflectionClass(Foo::class), "\n";

// Вместо $str = ReflectionClass::export(Foo::class, true) используйте:
$str = (string) new ReflectionClass(Foo::class);
?>

Сокеты

Флаги AI_IDN_ALLOW_UNASSIGNED и AI_IDN_USE_STD3_ASCII_RULES для функции socket_addrinfo_lookup() объявлены устаревшими из-за обновления glibc.

Улучшения производительности

Изменения обработки INI-файлов

zend.exception_ignore_args - новая INI-директива для включения или исключения аргументов из трассировок стека, полученных в исключениях.

opcache.preload_user - новая INI-директива для установки пользователя, из-под которого должен выполняться код предварительной загрузки, иначе это будет root (не допускается по соображениям безопасности).

Миграция на pkg-config

Множество модулей теперь используют исключительно pkg-config, чтобы определять зависимости библиотек. Как правило, это означает, что вместо --with-foo-dir=DIR используется только --with-foo. Пользовательские пути к библиотекам могут быть указаны либо путём добавления дополнительных каталогов в PKG_CONFIG_PATH, либо путём явного указания параметров компиляции через FOO_CFLAGS и FOO_LIBS.

Следующие модули и SAPI были затронуты этим изменением:

• CURL:

  • Опция --with-curl больше не принимает каталог.

• Enchant:

  • Опция --with-enchant больше не принимает каталог.

• FPM:

  • Опция --with-fpm-systemd теперь использует только pkg-config для проверок libsystem. Минимальная обязательная версия libsystemd - 209.

• GD:

  • Опция --with-gd переименована в --enable-gd (должен быть включён модуль или нет), а опция --with-external-gd использует внешнюю библиотеку libgd, вместо той, которая идёт в комплекте.

  • Опция --with-png-dir удалена. Наличие libpng теперь обязательно.

  • Опция --with-zlib-dir удалена. Наличие zlib теперь обязательно.

  • Опция --with-freetype-dir переименована в --with-freetype

  • Опция --with-jpeg-dir переименована в --with-jpeg

  • Опция --with-webp-dir переименована в --with-webp

  • Опция --with-xpm-dir переименована в --with-xpm

• IMAP:

  • Опция --with-kerberos-systemd больше не принимает каталог.

• Intl:

  • Опция --with-icu-dir удалена. Если передан --enable-intl, тогда всегда требуется наличие libicu.

• LDAP:

  • Опция --with-ldap-sasl больше не принимает каталог.

• Libxml:

  • Опция --with-libxml-dir удалена.

  • Опция --enable-libxml переименована в --with-libxml.

  • Опция --with-libexpat-dir переименована в --with-expat и больше не принимает каталог.

• LiteSpeed:

  • Опция --with-litespeed переименована в --enable-litespeed.

• Mbstring:

  • Опция --with-onig удалена. Если --disable-mbregex не указан, требуется libonig.

• ODBC:

  • Опция --with-iodbc больше не принимает каталог.

  • Опция --with-unixODBC без каталога теперь использует pkg-config (предпочтительно). Каталог по-прежнему можно указать для старых версий без libodbc.pc.

• OpenSSL:

  • Опция --with-openssl больше не принимает каталог.

• PCRE:

  • Опция --with-pcre-regex удалена. Вместо этого --with-external-pcre позволяет использовать внешнюю PCRE-библиотеку вместо встроенной.

• PDO_SQLite:

  • Опция --with-pdo-sqlite больше не принимает каталог.

• Readline:

  • Опция --with-libedit больше не принимает каталог.

• Sodium:

  • Опция --with-sodium больше не принимает каталог.

• SQLite3:

  • Опция --with-sqlite3 больше не принимает каталог.

• XSL:

  • Опция --with-xsl больше не принимает каталог.

• Zip:

  • Опция --with-libzip удалена.

  • Опция --enable-zip переименована в --with-zip.

Экранирование CSV

fputcsv(), fgetcsv(), SplFileObject::fputcsv(), SplFileObject::fgetcsv() и SplFileObject::setCsvControl() теперь принимаем пустую строку в аргументе $escape. Это отключит проприетарный механизм экранирования PHP.

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

Метод SplFileObject::getCsvControl() теперь также может возвращать пустую строку для третьего элемента массива, соответственно.

Фильтрация данных

Модуль filter больше не поддерживает ---with-pcre-dir для Unix-сборок и поэтому может быть спокойно собран для общего пользования с помощью ./configure.

GD

Поведение функции imagecropauto() в встроенной библиотеке libgd было синхронизировано с системной библиотекой libgd:

• IMG_CROP_DEFAULT в случае неудачного выполнения не заменяется на IMG_CROP_SIDES

• Пороговое значение кадрирования теперь рассчитывается из алгоритма в системной библиотеке libgd

Значение по умолчанию $modeimagecropauto() было изменено на IMG_CROP_DEFAULT; передача -1 теперь объявлена устаревшей.

imagescale() теперь поддерживает масштабирование с сохранением соотношения сторон до фиксированной высоты при передаче -1 в параметр $new_width.

Фреймворк хеш-кодов HASH

Модуль hash больше нельзя отключить, теперь он является неотъемлемой частью любой PHP-сборки, подобно модулю date.

Intl

Модуль intl теперь требует как минимум ICU 50.1.

Класс ResourceBundle теперь реализует Countable.

Облегчённый протокол доступа к каталогам (LDAP)

Поддержка nsldap и umich_ldap была удалена.

Libxml

Все модули на основе libxml теперь требуют libxml версии 2.7.6 или новее.

Многобайтовые строки

Библиотека oniguruma больше не идёт в комплекте с PHP, вместо неё в системе должна быть libonig. В качестве альтернативы можно указать ---disable-mbregex, чтобы отключить компонент mbregex.

OPcache

Конфигурационные опции --disable-opcache-file и --enable-opcache-file удалены в пользу использования INI-директивы opcache.file_cache

Хеширование паролей

Функции password_hash() и password_needs_rehash() теперь принимают обнуляемую строку (string) и целое число (int) в аргументе $algo.

PEAR

Установка PEAR (вместе с PECL) больше не включена по умолчанию. Её можно явно включить, используя --with-pear. Эта опция объявлена устаревшей и может быть удалена в будущем.

Reflection

Изменены числовые значения констант-модификаторов (IS_ABSTRACT, IS_DEPRECATED, IS_EXPLICIT_ABSTRACT, IS_FINAL, IS_IMPLICIT_ABSTRACT, IS_PRIVATE, IS_PROTECTED, IS_PUBLIC и IS_STATIC) в классах ReflectionClass, ReflectionFunction, ReflectionMethod, ReflectionObject и ReflectionProperty.

SimpleXML

Класс SimpleXMLElement теперь реализует Countable.

SQLite3

Встроенная в сборке библиотека libsqlite удалена. Для сборки модуля SQLite3 теперь требуется libsqlite3 ≥ 3.7.4. Чтобы собрать модуль PDO_SQLite обязательно требуется libsqlite3 ≥ 3.5.0.

Сериализация и десериализация SQLite3, SQLite3Stmt и SQLite3Result теперь явно запрещены. Раньше сериализация экземпляров этих классов была возможна, но десериализация делала объекты неиспользуемыми для дальнейшей работы.

Нотацию @param теперь также можно использовать для обозначения параметров SQL-запроса.

Zip

Встроенная библиотека libzip удалена. Теперь обязательно наличие в системе библиотеки libzip >= 0.11, чтобы собрать модуль zip.

Флаги команды configure

Команда configure теперь учитывает дополнительные переменные окружения CFLAGS и LDFLAGS.

Обработка CTRL

Комбинации клавиш CTRL +C и CTRL +BREAK в командной строке перехватывают путём установки функцией sapi_windows_set_ctrl_handler() функции-обработчика.

Функция proc_open() в ОС Windows принимает опцию "create_process_group". Это требуется, когда дочернему процессу необходимо обрабатывать события нажатия клавиши CTRL.

OPcache

Модуль OPcache теперь поддерживает произвольное количество отдельных кешей на каждого пользователя через INI-директиву opcache.cache_id. Процессы с одинаковым идентификатором кеша и пользователем используют один и тот же экземпляр OPcache.

stat

Улучшена реализация stat.

• Передаётся номер индексного дескриптора (inode), который опирается на индекс файла в NTFS.

• Номер устройства теперь исходит из серийного номера тома.

Обратите внимание, что на 64-битных системах оба значения извлекаются из системы в исходном виде. В 32-разрядных системах эти значения фиктивные, потому что могут превышать максимальное 32-разрядное целое число, разрешённое в PHP.

libsqlite3

libsqlite3 больше не компилируется статически в php_sqlite3.dll и php_pdo_sqlite.dll, но доступен как libsqlite3.dll. Обратитесь к инструкции по установке для SQLite3 и PDO_SQLITE соответственно.

Ядро PHP

Дата и время

• Были добавлены DateTime::createFromInterface() и DateTimeImmutable::createFromInterface().

• Добавлен спецификатор формата DateTime p, который аналогичен P, но возвращает Z, а не +00:00 для UTC.

DOM

Добавлены DOMParentNode и DOMChildNode с новыми API-интерфейсами обхода и управления.

Фильтрация данных

FILTER_VALIDATE_BOOL был добавлен в качестве псевдонима для FILTER_VALIDATE_BOOLEAN. Новое имя является предпочтительным, так как оно использует имя канонического типа.

Enchant

Добавлены enchant_dict_add(), enchant_dict_is_added() и LIBENCHANT_VERSION.

FPM

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

Hash

Теперь объекты HashContext можно сериализовать.

Функции интернационализации

Добавлены константы IntlDateFormatter::RELATIVE_FULL, IntlDateFormatter::RELATIVE_LONG, IntlDateFormatter::RELATIVE_MEDIUM и IntlDateFormatter::RELATIVE_SHORT.

LDAP

Добавлена функция ldap_count_references(), которая возвращает количество ссылочных сообщений в результатах поиска.

OPcache

Если ini-параметр opcache.record_warnings включён, OPcache будет записывать предупреждения во время компиляции и воспроизводить их при следующем включении, даже если они обслуживаются из кеша.

OpenSSL

Добавлена поддержка синтаксиса криптографических сообщений (CMS) (» RFC 5652), состоящего из функций для шифрования, дешифрования, подписи, проверки и чтения. API похож на API для функций PKCS #7 с добавлением новых констант кодирования: OPENSSL_ENCODING_DER, OPENSSL_ENCODING_SMIME и OPENSSL_ENCODING_PEM:

• openssl_cms_encrypt() шифрует сообщение в файле с сертификатами и выводит результат в предоставленный файл.
• openssl_cms_decrypt() расшифровывает сообщение S/MIME в файле и выводит результаты в предоставленный файл.
• openssl_cms_read() экспортирует файл CMS в массив сертификатов PEM.
• openssl_cms_sign() подписывает сообщение MIME в файле сертификатом и ключом и выводит результат в предоставленный файл.
• openssl_cms_verify() проверяет, что блок данных не повреждён, подписывающая сторона является тем, кем она являются и возвращает сертификаты подписывающих сторон.

Регулярные выражения (совместимые с Perl)

Добавлена функция preg_last_error_msg(), которая возвращает человекочитаемое сообщение о последней ошибке PCRE. Она дополняет preg_last_error(), которая возвращает целочисленное значение перечисления.

Reflection

• Следующие методы теперь могут возвращать информацию о значениях параметров внутренних функций по умолчанию:

  • ReflectionParameter::isDefaultValueAvailable()
  • ReflectionParameter::getDefaultValue()
  • ReflectionParameter::isDefaultValueConstant()
  • ReflectionParameter::getDefaultValueConstantName()

SQLite3

SQLite3::setAuthorizer() и соответствующие константы классов были добавлены, с помощью которых можно задать собственную callback-функцию для авторизации или запрета действия в базе данных.

Библиотека стандартных функций

• Добавлены функции str_contains(), str_starts_with() и str_ends_with(), которые проверяют, содержит ли haystack, начинается или заканчивается needle соответственно.

• Добавлена функция fdiv(), которая выполняет деление с плавающей точкой в соответствии с IEEE 754. Деление на ноль строго определено и возвращает одно из значений: Inf, -Inf или NaN.

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

• printf() и её производные теперь поддерживают спецификаторы формата %h и %H. Они работают как %g и %G, но всегда используют "." в качестве десятичного разделителя, а не определяют его с помощью локали LC_NUMERIC.

• printf() и её производные теперь поддерживают использование "*" в качестве ширины или точности, и в этом случае ширина/точность передаётся в качестве аргумента printf. Это также позволяет использовать точность -1 с %g, %G, %h и %H. Например, следующий код можно использовать для воспроизведения форматирования с плавающей точкой по умолчанию PHP:

  <?php
  printf("%.*H", (int) ini_get("precision"), $float);
  printf("%.*H", (int) ini_get("serialize_precision"), $float);
  ?>

• proc_open() теперь поддерживает дескрипторы псевдотерминала (PTY). Следующий код присоединяет stdin, stdout и stderr к одному и тому же PTY:

  <?php
  $proc = proc_open($command, [['pty'], ['pty'], ['pty']], $pipes);
  ?>

• proc_open() теперь поддерживает дескрипторы пары сокетов. Следующий код присоединяет отдельную пару сокетов к stdin, stdout и stderr:

  <?php
  $proc = proc_open($command, [['socket'], ['socket'], ['socket']], $pipes);
  ?>

  В отличие от каналов, у сокетов нет проблем с блокировкой ввода-вывода в Windows. Однако не все программы могут корректно работать с сокетами stdio.

• Функции сортировки теперь используют устойчивую сортировку, это означает, что сравниваемые элементы сохранят исходный порядок.

• array_diff(), array_intersect() и их производные теперь могут использоваться с одним массивом в качестве аргумента. Это означает, что теперь возможно следующее:

  <?php
  // Работает, даже если $excludes пуст:
  array_diff($array, ...$excludes);
  // Работает, даже если $array содержит только один массив:
  array_intersect(...$arrays);
  ?>

• Параметр flag в функции ob_implicit_flush() был изменён, и теперь принимает логическое значение (bool), а не целое число (int).

Лексер (Tokenizer)

PhpToken добавляет объектно-ориентированный интерфейс к PHP-лексеру (tokenizer). Он обеспечивает более единообразное и эргономичное представление, в то же время эффективнее и быстрее.

Zip

• Модуль Zip обновлён до версии 1.19.1.

• Новые методы ZipArchive::setMtimeName() и ZipArchive::setMtimeIndex() для установки времени изменения записи.

• Новый метод ZipArchive::registerProgressCallback() для предоставления обновлений во время закрытия архива.

• Новый метод ZipArchive::registerCancelCallback(), чтобы разрешить отмену во время закрытия архива.

• Новый метод ZipArchive::replaceFile() для замены содержимого записи.

• Новый метод ZipArchive::isCompressionMethodSupported(), чтобы проверить дополнительные возможности сжатия.

• Новый метод ZipArchive::isEncryptionMethodSupported(), чтобы проверить дополнительные функции шифрования.

• Добавлено свойство ZipArchive::lastId для получения значения индекса последней добавленной записи.

• Теперь ошибки можно проверить после закрытия и с помощью свойств ZipArchive::status и ZipArchive::statusSys или метода ZipArchive::getStatusString().

• Параметр 'remove_path' в ZipArchive::addGlob() и ZipArchive::addPattern() теперь обрабатывается как произвольный строковый префикс (для согласованности с 'add_path'), тогда как раньше он интерпретировался как имя каталога.

• Дополнительные функции сжатия/шифрования теперь перечислены в phpinfo.