PHP 8.6 Codex Changelog

Changed

INI Directives

Global

• session.cookie_httponly

  INI directive default value changed from 0 to 1

• session.use_strict_mode

  INI directive default value changed from 0 to 1

• session.cookie_samesite

  INI directive default value set to Lax

Classes

ext-soap

• SoapClient

  Cloning class objects is no longer allowed

Constants

gd

• GD_VERSION

  Constant value changed from 2.0.35 to 2.4.0

• GD_RELEASE_VERSION

  Constant value changed from 35 to 0

• GD_MINOR_VERSION

  Constant value changed from 0 to 4

Newly added

INI Directives

Global

• error_include_args

  INI directive added

Constants

curl

• CURL_READFUNC_ABORT

  Constant added

• CURL_SEEKFUNC_CANTSEEK

  Constant added

• CURL_SEEKFUNC_FAIL

  Constant added

• CURL_SEEKFUNC_OK

  Constant added

• CURLINFO_SIZE_DELIVERED

  Constant added

• CURLOPT_SEEKFUNCTION

  Constant added

mysqli

• MYSQLI_OPT_COMPRESS

  Constant added

openssl

• OPENSSL_RSA_PSS_SALTLEN_AUTO

  Constant added

• OPENSSL_RSA_PSS_SALTLEN_DIGEST

  Constant added

• OPENSSL_RSA_PSS_SALTLEN_MAX

  Constant added

pgsql

• PGSQL_CONNECTION_SSL_STARTUP

  Constant added

sockets

• EAI_CANCELED

  Constant added

• AF_UNSPEC

  Constant added

• TCP_USER_TIMEOUT

  Constant added

• EAI_ADDRFAMILY

  Constant added

• EAI_AGAIN

  Constant added

• EAI_ALLDONE

  Constant added

• EAI_BADFLAGS

  Constant added

• EAI_FAIL

  Constant added

• EAI_SOCKTYPE

  Constant added

• EAI_SERVICE

  Constant added

• EAI_OVERFLOW

  Constant added

• EAI_NOTCANCELED

  Constant added

• EAI_NONAME

  Constant added

• EAI_NODATA

  Constant added

• EAI_INTR

  Constant added

• EAI_INPROGRESS

  Constant added

• EAI_IDN_ENCODE

  Constant added

• EAI_FAMILY

  Constant added

• EAI_SYSTEM

  Constant added

standard

• STREAM_CRYPTO_STATUS_NONE

  Constant added

• ARRAY_FILTER_USE_VALUE

  Constant added

  PHP 8.6: array_filter function's $mode throws ValueError on invalid values
• STREAM_CRYPTO_STATUS_WANT_READ

  Constant added

• STREAM_CRYPTO_STATUS_WANT_WRITE

  Constant added

Classes

ext-date

• Time\Duration

  Class added

• Time\TimeException

  Exception class added

ext-intl

• IntlNumberRangeFormatter

  Class added

ext-openssl

• Openssl\OpensslException

  Exception class added

• Openssl\Psk

  Class added

• Openssl\Session

  Class added

Core

• StreamError

  Class added

• StreamException

  Exception class added

• StreamPollHandle

  Class added

• Io\Poll\HandleAlreadyWatchedException

  Exception class added

• Io\IoException

  Exception class added

• Io\Poll\BackendUnavailableException

  Exception class added

• Io\Poll\Context

  Class added

• Io\Poll\FailedContextInitializationException

  Exception class added

• Io\Poll\FailedHandleAddException

  Exception class added

• Io\Poll\FailedPollOperationException

  Exception class added

• Io\Poll\FailedPollWaitException

  Exception class added

• Io\Poll\FailedWatcherModificationException

  Exception class added

• Io\Poll\InactiveWatcherException

  Exception class added

• Io\Poll\InvalidHandleException

  Exception class added

• Io\Poll\PollException

  Exception class added

• Io\Poll\Watcher

  Class added

ext-uri

• Uri\Rfc3986\UriBuilder

  Class added

• Uri\WhatWg\UrlBuilder

  Class added

Functions

ext-gmp

• gmp_prevprime

  Function added

• gmp_powm_sec

  Function added

ext-intl

• locale_get_display_keyword

  Function added

• grapheme_strrev

  Function added

  PHP 8.6: New grapheme_strrev function
  RFC: grapheme_strrev: strrev for grapheme cluster
• locale_get_display_keyword_value

  Function added

ext-mysqli

• mysqli_quote_string

  Function added

ext-snmp

• snmp_set_output_option

  Function added

• snmp_init_mib

  Function added

• snmp_set_mib_option

  Function added

• snmp_set_string_output_format

  Function added

Core

• stream_socket_get_crypto_status

  Function added

• stream_last_errors

  Function added

• stream_clear_errors

  Function added

• clamp

  Function added

  PHP 8.6: New clamp function
  RFC: clamp v2

Enums

ext-snmp

• Snmp\Mib

  Enum added

• Snmp\OidOutput

  Enum added

• Snmp\Output

  Enum added

• Snmp\StringOutput

  Enum added

Core

• StreamErrorCode

  Enum added

• StreamErrorMode

  Enum added

• StreamErrorStore

  Enum added

• SortDirection

  Enum added

  PHP 8.6: New SortDirection Enum
  RFC: enum SortDirection
• SortDirection

  Enum added

  PHP 8.6: New SortDirection Enum
  RFC: enum SortDirection
• Io\Poll\Backend

  Enum added

• Io\Poll\Event

  Enum added

ext-uri

• Uri\Rfc3986\UriHostType

  Enum added

• Uri\Rfc3986\UriType

  Enum added

• Uri\WhatWg\UrlHostType

  Enum added

Interfaces

Core

• Io\Poll\Handle

  Interface added

Improvements

Functions

ext-gd

• imageaffinematrixget

  Parameter type added for parameter #2 ($options): array|float

  - imageaffinematrixget(int $type, $options): array|false
  + imageaffinematrixget(int $type, array|float $options): array|false

ext-json

• json_decode

  PHP 8.6: JSON: json_decode error/exception message now indicates the location of the error
• json_last_error_msg

  PHP 8.6: JSON: json_decode error/exception message now indicates the location of the error

ext-ldap

• ldap_free_result

  Return type changed: bool to true

  - ldap_free_result(LDAP\Result $result): bool
  + ldap_free_result(LDAP\Result $result): true

ext-openssl

• openssl_sign

  • Optional parameter added - #6: int $salt_length = OPENSSL_RSA_PSS_SALTLEN_AUTO

   openssl_sign(
       string $data,
       &$signature,
       $private_key,
       string|int $algorithm = OPENSSL_ALGO_SHA1,
  -    int $padding = 0
  +    int $padding = 0,
  +    int $salt_length = OPENSSL_RSA_PSS_SALTLEN_AUTO
     ): bool

• openssl_encrypt

  Parameter type changed for parameter #7 ($aad): string to ?string

    openssl_encrypt(
        string $data,
        string $cipher_algo,
        string $passphrase,
        int $options = 0,
        string $iv = "",
        &$tag = null,
  -     string $aad = "",
  +     ?string $aad = "",
        int $tag_length = 16
      ): string|false

• openssl_decrypt

  Parameter type changed for parameter #7 ($aad): string to ?string

    openssl_decrypt(
        string $data,
        string $cipher_algo,
        string $passphrase,
        int $options = 0,
        string $iv = "",
        ?string $tag = null,
  -     string $aad = ""
  +     ?string $aad = ""
      ): string|false

• openssl_verify

  • Optional parameter added - #6: int $salt_length = OPENSSL_RSA_PSS_SALTLEN_AUTO

   openssl_verify(
       string $data,
       string $signature,
       $public_key,
       string|int $algorithm = OPENSSL_ALGO_SHA1,
  -    int $padding = 0
  +    int $padding = 0,
  +    int $salt_length = OPENSSL_RSA_PSS_SALTLEN_AUTO
     ): int|false

ext-pgsql

• pg_close_stmt

  Parameter type changed for parameter #1 ($connection): Pgsql\Connection to PgSql\Connection

  - pg_close_stmt(Pgsql\Connection $connection, string $statement_name): PgSql\Result|false
  + pg_close_stmt(PgSql\Connection $connection, string $statement_name): PgSql\Result|false

ext-readline

• readline_completion_function

  Return type changed: bool to true

  - readline_completion_function(callable $callback): bool
  + readline_completion_function(callable $callback): true

ext-snmp

• snmp_set_oid_numeric_print

  Parameter type changed for parameter #1 ($format): int to Snmp\OidOutput|int

  - snmp_set_oid_numeric_print(int $format): true
  + snmp_set_oid_numeric_print(Snmp\OidOutput|int $format): true

• snmp_set_oid_output_format

  Parameter type changed for parameter #1 ($format): int to Snmp\OidOutput|int

  - snmp_set_oid_output_format(int $format): true
  + snmp_set_oid_output_format(Snmp\OidOutput|int $format): true

ext-sockets

• socket_cmsg_space

  Return type changed: ?int to int

    socket_cmsg_space(
        int $level,
        int $type,
        int $num = 0
  -   ): ?int
  +   ): int

• socket_addrinfo_lookup

  • Optional parameter added - #4: &$error_code = null

   socket_addrinfo_lookup(
       string $host,
       ?string $service = null,
  -    array $hints = []
  +    array $hints = [],
  +    &$error_code = null
     ): array|false

Core

• stream_socket_pair

  • Optional parameter added - #4: $context = null

   stream_socket_pair(
       int $domain,
       int $type,
  -    int $protocol
  +    int $protocol,
  +    $context = null
     ): array|false

• trim

  Parameter default value changed for position #2 ($characters): " \n\r\t\v\x00" to " \f\n\r\t\v\x00"

  PHP 8.6: trim, ltrim, rtrim, chop functions now trim Form-Feed (\f) by default
  RFC: Add Form Feed in trim Functions

  - trim(string $string, string $characters = " \n\r\t\v\x00"): string
  + trim(string $string, string $characters = " \f\n\r\t\v\x00"): string

• register_tick_function

  Return type changed: bool to true

  - register_tick_function(callable $callback, mixed ...$args): bool
  + register_tick_function(callable $callback, mixed ...$args): true

• stream_select

  • Optional parameter added - #6: $context = null

   stream_select(
       ?array &$read,
       ?array &$write,
       ?array &$except,
       ?int $seconds,
  -    ?int $microseconds = null
  +    ?int $microseconds = null,
  +    $context = null
     ): int|false

• stream_is_local

  • Optional parameter added - #2: $context = null

  - stream_is_local($stream): bool
  + stream_is_local($stream, $context = null): bool

• stream_copy_to_stream

  • Optional parameter added - #5: $context = null

   stream_copy_to_stream(
       $from,
       $to,
       ?int $length = null,
  -    int $offset = 0
  +    int $offset = 0,
  +    $context = null
     ): int|false

• array_filter

  Parameter default value changed for position #3 ($mode): 0 to ARRAY_FILTER_USE_VALUE

  PHP 8.6: array_filter function's $mode throws ValueError on invalid values

    array_filter(
        array $array,
        ?callable $callback = null,
  -     int $mode = 0
  +     int $mode = ARRAY_FILTER_USE_VALUE
      ): array

• rtrim

  Parameter default value changed for position #2 ($characters): " \n\r\t\v\x00" to " \f\n\r\t\v\x00"

  PHP 8.6: trim, ltrim, rtrim, chop functions now trim Form-Feed (\f) by default
  RFC: Add Form Feed in trim Functions

  - rtrim(string $string, string $characters = " \n\r\t\v\x00"): string
  + rtrim(string $string, string $characters = " \f\n\r\t\v\x00"): string

• chop

  Parameter default value changed for position #2 ($characters): " \n\r\t\v\x00" to " \f\n\r\t\v\x00"

  PHP 8.6: trim, ltrim, rtrim, chop functions now trim Form-Feed (\f) by default
  RFC: Add Form Feed in trim Functions

  - chop(string $string, string $characters = " \n\r\t\v\x00"): string
  + chop(string $string, string $characters = " \f\n\r\t\v\x00"): string

• header_register_callback

  Return type changed: bool to true

  - header_register_callback(callable $callback): bool
  + header_register_callback(callable $callback): true

• ltrim

  Parameter default value changed for position #2 ($characters): " \n\r\t\v\x00" to " \f\n\r\t\v\x00"

  PHP 8.6: trim, ltrim, rtrim, chop functions now trim Form-Feed (\f) by default
  RFC: Add Form Feed in trim Functions

  - ltrim(string $string, string $characters = " \n\r\t\v\x00"): string
  + ltrim(string $string, string $characters = " \f\n\r\t\v\x00"): string

ext-zip

• zip_entry_close

  Return type changed: bool to true

    #[\Deprecated]
  - zip_entry_close($zip_entry): bool
  + zip_entry_close($zip_entry): true

Deprecations

Functions

ext-mbstring

• mb_ereg_search_regs

  Function deprecated

• mb_split

  Function deprecated

• mb_regex_set_options

  Function deprecated

• mb_regex_encoding

  Function deprecated

• mb_eregi_replace

  Function deprecated

• mb_ereg

  Function deprecated

• mb_eregi

  Function deprecated

• mb_ereg_match

  Function deprecated

• mb_ereg_replace

  Function deprecated

• mb_ereg_replace_callback

  Function deprecated

• mb_ereg_search

  Function deprecated

• mb_ereg_search_getpos

  Function deprecated

• mb_ereg_search_getregs

  Function deprecated

• mb_ereg_search_init

  Function deprecated

• mb_ereg_search_pos

  Function deprecated

• mb_ereg_search_setpos

  Function deprecated

ext-mysqli

• mysqli_get_charset

  Function deprecated

• mysqli_stmt_init

  Function deprecated

ext-SPL

• spl_object_hash

  Function deprecated

• spl_classes

  Function deprecated

Core

• strcoll

  Function deprecated

• doubleval

  Function deprecated

• is_double

  Function deprecated

• is_integer

  Function deprecated

• is_long

  Function deprecated

• metaphone

  Function deprecated

Constants

mbstring

• MB_ONIGURUMA_VERSION

  Constant deprecated

  var_dump(MB_ONIGURUMA_VERSION);
  // 6.9.9

  Constant MB_ONIGURUMA_VERSION is deprecated since 8.6, because the underlying library is no longer maintained

standard

• SORT_LOCALE_STRING

  Constant deprecated

  var_dump(SORT_LOCALE_STRING);
  // 5

  Constant SORT_LOCALE_STRING is deprecated since 8.6, use one of the Collator::*sort*() methods instead