Account for changes introduced in PHP 8.6

[jrfnl]

This is just an issue to keep track of which of the implemented RFCs for PHP 8.6 have been addressed.

This list should be updated when additional RFCs are accepted/implemented.

To Do

• Allow Object Property Writes on Objects Referenced by Constants
• Limit maximum number of filter chains
• #[\Override] for class constants
• Add Locale::getDisplayKeyword and Locale::getDisplayKeywordValue functions
• Polling API
• Debugable Enums
• Secure Session Configuration Defaults
• enum SortDirection
• DocComments For Function Parameters
• Add Form Feed in Trim Functions
• isReadable/Writeable Reflection methods
• TLS Session Resumption Support for Streams
• Display Function Arguments in Errors
• Partial Function Application, v2
  • Partial Function Application: Handling of Optional Parameters
• Closure optimizations
• Readonly Property Defaults
• Deprecations for PHP 8.6
  Note: these may not all be fully implemented yet! PRs to detect the deprecation will only be accepted after the deprecation has been merged into PHP Core.
  Sublist:
  • Deprecate returning from a finally block
  • Deprecate using certain names as identifiers to reserve them as keywords
    • Deprecate using “let” as an identifier
    • Deprecate using “is” as an identifier
    • Deprecate using “_” as a constant and compile time alias
  • Passing objects which are interpreted as arrays
    • Passing objects for $array parameter of array_walk() and array_walk_recursive() - PR - commit
    • Passing objects for $options parameter of deflate_init() and inflate_init() - PR - commit
    • Passing objects as parameters to the zlib.inflate and zlib.deflate stream filters - PR - commit
    • Passing objects as parameters to the bzip2.decompress and bzip2.compress stream filters - PR - commit
    • Passing objects for $vars parameter of mb_convert_variables() - PR - commit
    • Passing objects for $data parameter of http_build_query() - PR - commit
  • Deprecate is_subclass_of with string when $allow_string is false
  • Deprecate is_a with string when $allow_string is false
  • Deprecate ReflectionProperty::setValue() and ReflectionProperty::setRawValue() with wrong types - PR - commit + commit
  • Deprecate ReflectionMethod::invoke() and ReflectionMethod::invokeArgs() with objects for static methods - PR - commit
  • Deprecate ArrayIterator methods that inherit ArrayObject implementation - PR - commit
  • Deprecate SplFileObject CSV methods
  • Deprecate passing a $sessionhandler object to session_set_save_handler() which does not contain the create_sid() and validateId() methods - PR - commit

Aside from the RFCs, there are also the changes which were made outside of the RFC process and are listed in:

• The PHP 8.6 Upgrading guide.
• The PHP 8.5 to 8.6 Migration guide (once available)
• PHP 8.6 NEWS/Changelog
• Changelog

Claimed

• Deprecate returning values from __construct() and __destruct()
  Status: WIP
  Owner: @jrfnl
• Oniguruma maintenance end and end of mbregex
  Status: WIP
  Owner: @jrfnl
• grapheme_strrev: strrev for grapheme cluster
  Status: WIP
  Owner: @jrfnl
• Add "clamp()" function
  Status: WIP
  Owner: @jrfnl
• New function mysqli_quote_string
  Status: WIP
  Owner: @jrfnl
• Duration class
  Status: WIP
  Owner: @jrfnl
• Deprecations for PHP 8.6
  Note: these may not all be fully implemented yet! PRs to detect the deprecation will only be accepted after the deprecation has been merged into PHP Core.
  Sublist:
  • Deprecate using certain names as identifiers to reserve them as keywords
    • Deprecate using “namespace” as a class constant name - PR - commit
      Status: WIP
      Owner: @jrfnl
    • Deprecate the possibility to name a function “readonly” - PR - commit
      Status: WIP
      Owner: @jrfnl
  • Deprecate function aliases with non-canonical type name
    • Deprecate is_double(), an alias of is_float() - PR - commit
      Status: WIP
      Owner: @jrfnl
    • Deprecate is_integer(), an alias of is_int() - PR - commit
      Status: WIP
      Owner: @jrfnl
    • Deprecate is_long(), an alias of is_int() - PR - commit
      Status: WIP
      Owner: @jrfnl
    • Deprecate doubleval(), an alias of floatval() - PR - commit
      Status: WIP
      Owner: @jrfnl
  • Deprecate define() with $case_insensitive being specified - PR - commit
    Status: WIP
    Owner: @jrfnl
  • Deprecate strcoll() - PR - commit
    Status: WIP
    Owner: @jrfnl
  • Deprecate SORT_LOCALE_STRING flag for sort() functions - PR - commit
    Status: WIP
    Owner: @jrfnl
  • Deprecate metaphone function - PR - commit
    Status: WIP
    Owner: @jrfnl
  • Deprecate spl_classes() - PR - commit
    Status: WIP
    Owner: @jrfnl
  • Deprecate spl_object_hash - PR - commit
    Status: WIP
    Owner: @jrfnl
  • Deprecate mysqli::stmt_init() - PR - commit
    Status: WIP
    Owner: @jrfnl
  • Deprecate mysqli_get_charset() - PR - commit
    Status: WIP
    Owner: @jrfnl

Additionally, an initial scan of the UPGRADING file for additional list-based updates to be made is ongoing and owned by @jrfnl.

Has PR

Nothing yet

Reviewed and concluded non-sniffable

• Deprecations for PHP 8.6
  Sublist:
  • Deprecate the list() construct RFC rejected
  • Deprecate using certain names as identifiers to reserve them as keywords
    • Deprecate using “in”, “out”, and “inout” as identifiers RFC rejected
    • Deprecate using “_” as a function name and the _() function alias for gettext() RFC rejected
  • Deprecate dechunk filter RFC rejected

Delayed to later PHP version

Nothing yet

Status yet to be determined

These are RFCs which have either not yet been implemented or are still in voting at this time.
Once their final status for PHP 8.6 is determined, they will either be moved to the "To Do" list or removed from this ticket.

Accepted, not yet (fully) implemented

• Minimum supported versions for PHP 8.6
• Stream Error Handling Improvements
• Followup Improvements for ext/uri
• SNMP improvements for encryption protocols, mib reset, and controlling output
• Add pack()/unpack() endianness modifiers for floating-point numbers
• Add pack()/unpack() support for endianness modifiers on integers
• Deprecations for PHP 8.6
  Sublist:
  • Deprecate returning from a finally block
  • Deprecate using certain names as identifiers to reserve them as keywords
    • Deprecate using “let” as an identifier
    • Deprecate using “is” as an identifier
    • Deprecate using “_” as a constant and compile time alias
  • Deprecate is_subclass_of with string when $allow_string is false
  • Deprecate is_a with string when $allow_string is false
  • Deprecate SplFileObject CSV methods

In voting

All votes have been closed

Process

If anyone starts work on updating PHPCompatibility to handle any of these issues, please either update the above list (if you can) or leave a comment below, so one of the maintainers can update the list.

Once PHP 8.6 comes out, individual issues should be opened for the changes which remain at that point in time.

Guidelines

• When in doubt how to address something and/or if your approach is the right one: ask.
  This also means that it is perfectly acceptable to open an dedicated issue to discuss a particular change in more detail.
• PRs which address RFCs should only contain the changes for one RFC per PR. One RFC may warrant multiple PRs depending on the nature of the changes.
  Exception: when a RFC builds onto a previous RFC, combining the necessary changes into one PR addressing the cumulative changes to PHP is fine.
• PRs not directly related to RFCs may address multiple changes in one go, as long as the changes are logically closely related (like adding a range of new constants to be detected).
• Please include relevant change justification and links in each commit message.
  Typically this means that a commit message should include:
  • Text snippet from the PHP UPGRADING guide/changelog/migration guide or the RFC to back up the change being made.
  • A link to the RFC (if applicable).
  • A link to the exact UPGRADING guide/changelog/migration guide section which documents the change in PHP Core.
  • A link to the PR to PHP Core which proposed the change (if applicable).
  • A link to the commit which added the change to PHP Core.
• Changes which were proposed/accepted for PHP, but have not been merged into PHP Core yet, should not be detected by PHPCompatibility (yet).
  The commit to PHP Core should always come first, PHPCompatibility follows.