PHP 8.6 Codex Changelog

Changed

INI Directives

Global

• mail.add_x_header

  INI directive default value set to 0

• opcache.jit

  INI directive default value changed from 1235 to disable

• opcache.enable_cli

  INI directive default value changed from 0 to 1

• mysqlnd.collect_memory_statistics

  INI directive default value set to 0

• mysqli.default_user

  INI directive default value set to ``

• mysqli.default_socket

  INI directive default value changed from /var/run/mysqld/mysqld.sock to ``

• mysqli.default_pw

  INI directive default value set to ``

• mysqli.default_host

  INI directive default value set to ``

• memory_limit

  INI directive default value changed from -1 to 128M

• mail.mixed_lf_and_crlf

  INI directive default value set to 0

• opcache.jit_buffer_size

  INI directive default value changed from 256M to 64M

• log_errors

  INI directive default value changed from 1 to 0

• include_path

  INI directive default value changed from .:/usr/share/php to .:

• ignore_repeated_source

  INI directive default value set to 0

• ignore_repeated_errors

  INI directive default value set to 0

• enable_dl

  INI directive default value set to 1

• session.use_strict_mode

  INI directive default value changed from 0 to 1

• zlib.output_compression

  INI directive default value set to 0

• zend.exception_string_param_max_len

  INI directive default value changed from 0 to 15

• zend.exception_ignore_args

  INI directive default value changed from 1 to 0

• zend.assertions

  INI directive default value changed from -1 to 1

• variables_order

  INI directive default value changed from GPCS to EGPCS

• user_dir

  INI directive default value set to ``

• unserialize_callback_func

  INI directive default value set to ``

• tidy.clean_output

  INI directive default value set to 0

• short_open_tag

  INI directive default value set to 1

• allow_url_include

  INI directive default value set to 0

• session.save_path

  INI directive default value changed from /var/lib/php/sessions to ""

• session.gc_probability

  INI directive default value changed from 0 to 1

• session.gc_divisor

  INI directive default value changed from 1000 to 100

• session.cookie_samesite

  INI directive default value set to Lax

• session.cookie_httponly

  INI directive default value set to 1

• request_order

  INI directive default value changed from GP to ``

• pgsql.auto_reset_persistent

  INI directive default value set to 0

• pdo_mysql.default_socket

  INI directive default value changed from /var/run/mysqld/mysqld.sock to /tmp/mysql.sock

• auto_append_file

  INI directive default value set to ``

• auto_prepend_file

  INI directive default value set to ``

• display_startup_errors

  INI directive default value set to 1

• display_errors

  INI directive default value set to 1

Constants

curl

• CURLAUTH_ANY

  Constant value changed from -17 to 4294967023

• CURLAUTH_ANYSAFE

  Constant value changed from -18 to 4294967022

• CURLVERSION_NOW

  Constant value changed from 10 to 11

• CURLSSH_AUTH_DEFAULT

  Constant value changed from -1 to 4294967295

• CURLSSH_AUTH_ANY

  Constant value changed from -1 to 4294967295

• CURLPROTO_ALL

  Constant value changed from -1 to 4294967295

gd

• GD_MINOR_VERSION

  Constant value changed from 3 to 4

• GD_VERSION

  Constant value changed from 2.3.3 to 2.4.0

• GD_RELEASE_VERSION

  Constant value changed from 3 to 0

pcre

• PCRE_VERSION

  Constant value changed from 10.42 2022-12-11 to 10.44 2024-06-07

• PCRE_VERSION_MINOR

  Constant value changed from 47 to 44

Classes

ext-soap

• SoapClient

  Cloning class objects is no longer allowed

Removals

Extensions

Global

• ext-xmlrpc

  Extension removed

• ext-PDO_Firebird

  Extension removed

Classes

ext-PDO_Firebird

• Pdo\Firebird

  Class removed

ext-xmlrpc

• XmlRpcServer

  Class removed

Functions

Core

• chroot

  Function removed

ext-xmlrpc

• xmlrpc_encode

  Function removed

• xmlrpc_set_type

  Function removed

• xmlrpc_server_register_method

  Function removed

• xmlrpc_server_register_introspection_callback

  Function removed

• xmlrpc_server_destroy

  Function removed

• xmlrpc_server_create

  Function removed

• xmlrpc_server_call_method

  Function removed

• xmlrpc_server_add_introspection_data

  Function removed

• xmlrpc_parse_method_descriptions

  Function removed

• xmlrpc_is_fault

  Function removed

• xmlrpc_get_type

  Function removed

• xmlrpc_encode_request

  Function removed

• xmlrpc_decode

  Function removed

• xmlrpc_decode_request

  Function removed

Newly added

INI Directives

Global

• error_include_args

  INI directive added

Constants

Core

• PHP_BUILD_PROVIDER

  Constant added

curl

• CURLINFO_POSTTRANSFER_TIME_T

  Constant added

• CURL_SEEKFUNC_CANTSEEK

  Constant added

• CURL_SEEKFUNC_FAIL

  Constant added

• CURL_SEEKFUNC_OK

  Constant added

• CURLFOLLOW_ALL

  Constant added

• CURLFOLLOW_FIRSTONLY

  Constant added

• CURLINFO_SIZE_DELIVERED

  Constant added

• CURLFOLLOW_OBEYCODE

  Constant added

• CURLINFO_HTTPAUTH_USED

  Constant added

• CURL_READFUNC_ABORT

  Constant added

• CURLOPT_SEEKFUNCTION

  Constant added

• CURLINFO_QUEUE_TIME_T

  Constant added

• CURLOPT_TCP_KEEPCNT

  Constant added

• CURLINFO_PROXYAUTH_USED

  Constant added

• CURLINFO_USED_PROXY

  Constant added

• CURLOPT_SSL_SIGNATURE_ALGORITHMS

  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_TUPLES_CHUNK

  Constant added

• PGSQL_CONNECTION_SSL_STARTUP

  Constant added

sockets

• EAI_CANCELED

  Constant added

• AF_UNSPEC

  Constant added

• EAI_SOCKTYPE

  Constant added

• EAI_FAIL

  Constant added

• EAI_FAMILY

  Constant added

• EAI_IDN_ENCODE

  Constant added

• EAI_INPROGRESS

  Constant added

• EAI_INTR

  Constant added

• EAI_NODATA

  Constant added

• EAI_NONAME

  Constant added

• EAI_NOTCANCELED

  Constant added

• EAI_OVERFLOW

  Constant added

• EAI_SERVICE

  Constant added

• TCP_USER_TIMEOUT

  Constant added

• EAI_SYSTEM

  Constant added

• EAI_BADFLAGS

  Constant added

• EAI_ALLDONE

  Constant added

• EAI_AGAIN

  Constant added

• EAI_ADDRFAMILY

  Constant added

• SO_DETACH_REUSEPORT_BPF

  Constant added

standard

• ARRAY_FILTER_USE_VALUE

  Constant added

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

  Constant added

• 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\Session

  Class added

• Openssl\OpensslException

  Exception class added

• Openssl\Psk

  Class added

Core

• Io\Poll\Context

  Class added

• Io\Poll\BackendUnavailableException

  Exception class added

• Io\IoException

  Exception class added

• StreamError

  Class added

• StreamException

  Exception class added

• StreamPollHandle

  Class added

• Io\Poll\FailedHandleAddException

  Exception class added

• Io\Poll\Watcher

  Class added

• Io\Poll\PollException

  Exception class added

• Io\Poll\InactiveWatcherException

  Exception class added

• Io\Poll\HandleAlreadyWatchedException

  Exception class added

• Io\Poll\InvalidHandleException

  Exception class added

• Io\Poll\FailedWatcherModificationException

  Exception class added

• Io\Poll\FailedPollWaitException

  Exception class added

• Io\Poll\FailedContextInitializationException

  Exception class added

• Io\Poll\FailedPollOperationException

  Exception class added

ext-uri

• Uri\WhatWg\UrlBuilder

  Class added

• Uri\Rfc3986\UriBuilder

  Class added

Functions

ext-gmp

• gmp_prevprime

  Function added

• gmp_powm_sec

  Function added

ext-intl

• locale_get_display_keyword_value

  Function added

• locale_get_display_keyword

  Function added

• grapheme_strrev

  Function added

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

ext-mysqli

• mysqli_quote_string

  Function added

ext-pgsql

• pg_close_stmt

  Function added

• pg_set_chunked_rows_size

  Function added

ext-snmp

• snmp_set_mib_option

  Function added

• snmp_set_string_output_format

  Function added

• snmp_set_output_option

  Function added

• snmp_init_mib

  Function added

Core

• clamp

  Function added

  PHP 8.6: New clamp function
  RFC: clamp v2
• stream_socket_get_crypto_status

  Function added

• stream_last_errors

  Function added

• stream_clear_errors

  Function added

ext-uri

• uri\whatwg\url_percent_encode

  Function added

Enums

ext-snmp

• Snmp\Output

  Enum added

• Snmp\StringOutput

  Enum added

• Snmp\OidOutput

  Enum added

• Snmp\Mib

  Enum added

Core

• StreamErrorMode

  Enum added

• Io\Poll\Event

  Enum added

• Io\Poll\Backend

  Enum added

• StreamErrorCode

  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

ext-uri

• Uri\WhatWg\UrlHostType

  Enum added

• Uri\Rfc3986\UriType

  Enum added

• Uri\Rfc3986\UriHostType

  Enum added

• Uri\WhatWg\UrlPercentEncodingMode

  Enum added

Interfaces

Core

• Io\Poll\Handle

  Interface added

Improvements

Functions

ext-filter

• filter_var_array

  Return type changed: array|false|null to array|false

    filter_var_array(
        array $array,
        array|int $options = FILTER_DEFAULT,
        bool $add_empty = true
  -   ): array|false|null
  +   ): array|false

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

• 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

ext-pcntl

• pcntl_signal

  • Parameter type changed for parameter #3 ($restart_syscalls): bool to ?bool
  • Parameter default value changed for position #3 ($restart_syscalls): true to null

    pcntl_signal(
        int $signal,
        $handler,
  -     bool $restart_syscalls = true
  +     ?bool $restart_syscalls = null
      ): bool

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

• 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

ext-sockets

• 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

• socket_cmsg_space

  Return type changed: ?int to int

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

Core

• 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

• 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

• header_register_callback

  Return type changed: bool to true

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

• 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

• 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

• stream_socket_pair

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

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

• 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

• 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

• 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

• 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

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

  Function deprecated

• mb_ereg_replace_callback

  Function deprecated

• mb_ereg_search_setpos

  Function deprecated

• mb_ereg_replace

  Function deprecated

• mb_ereg

  Function deprecated

• mb_ereg_match

  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_regs

  Function deprecated

• mb_eregi

  Function deprecated

• mb_eregi_replace

  Function deprecated

• mb_split

  Function deprecated

• mb_regex_set_options

  Function deprecated

• mb_regex_encoding

  Function deprecated

ext-mysqli

• mysqli_stmt_init

  Function deprecated

• mysqli_get_charset

  Function deprecated

ext-SPL

• spl_classes

  Function deprecated

• spl_object_hash

  Function deprecated

Core

• doubleval

  Function deprecated

• metaphone

  Function deprecated

• strcoll

  Function deprecated

• is_long

  Function deprecated

• is_integer

  Function deprecated

• is_double

  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