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

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

To Do

• Correctly name the rounding mode and make it an Enum
• Lazy Objects
  Review note: at this moment probably not sniffable as this only adds class constants and methods on (pre-)existing classes.
• DOM HTML5 parsing and serialization
• New 4 rounding modes to round() function
• Improve callbacks in ext/dom and ext/xsl
• Opt-in DOM spec-compliance
• PDO Driver specific SQL parser
• Add stream open functions to XML{Reader,Writer} (was: Add openStream() to XML{Reader,Writer})
• New ext-dom features in PHP 8.4
• Deprecations for PHP 8.4
  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:
  • Formally deprecate Soft-deprecated DOMDocument and DOMEntity properties
  • Remove DOMImplementation::getFeature($feature, $version)
  • unserialize()'s 'S' tag
  • Deprecate SplFixedArray::__wakeup()
  • Deprecate passing incorrect data types for options to ext/hash functions

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

• The PHP 8.4 Upgrading guide.
• The PHP 8.3 to 8.4 Migration guide
• PHP 8.4 NEWS/Changelog
• Changelog

Claimed

• Property hook improvements
  Status: will need to wait until it becomes clear how this will be supported in PHPCS itself and PHPCSUtils.
  Owner: @jrfnl
• Property access hooks
  Status: will need to wait until it becomes clear how this will be supported in PHPCS itself and PHPCSUtils.
  Owner: @jrfnl
  Sub-tasks:
  • property hooks
• #[\Deprecated] Attribute
  This RFC proposes an attribute to mark declarations as deprecated
  Status: TODO / needs a good think, see Further improve attribute detection/flagging #1935
  Owner: @jrfnl
• Deprecate GET/POST sessions
  Status: WIP
  Owner: @jrfnl

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

Has PR

• Add bcdivmod to BCMath - PR PHP 8.4 | RemovedConstants: detect use of CURLOPT_BINARYTRANSFER #1786
• Fix up BCMath Number Class / Change GMP bool cast behavior - PR PHP 8.4 | NewClasses: detect use of BcMath\Number (RFC) #1765
  Note: the change in GMP cast behaviour is deemed unsniffable as it would require variable tracing.
• Support object type in BCMath - PR PHP 8.4 | NewClasses: detect use of BcMath\Number (RFC) #1765
• Asymmetric visibility v2 - PR PHP 8.4 | Detect use of asymmetric visibility  #1809
• Property access hooks
  Sub-tasks:
  • properties in interfaces - PR PHP 8.4 | ✨ New PHPCompatibility.Interfaces.NewPropertiesInInterfaces sniff (RFC) #1814
  • final properties - PR PHP 8.4 | ✨ New PHPCompatibility.Classes.NewFinalProperties sniff (RFC) #1815
  • abstract properties - PR PHP 8.4 | ✨ New PHPCompatibility.Classes.NewAbstractProperties sniff #1901
• new MyClass()->method() without parentheses - PR PHP 8.4 | ✨ New PHPCompatibility.Syntax.NewClassMemberAccessWithoutParentheses sniff [RFC] #1903
• Deprecate implicitly nullable parameter types - PRs PHP 8.4 | ✨ New PHPCompatibility.FunctionDeclarations.RemovedImplicitlyNullableParam sniff (RFC) #1694 + PHP 8.4 | FunctionDeclarations/RemovedOptionalBeforeRequiredParam: flag implicitly nullable parameters #1699
• Adding bcround, bcfloor and bcceil to BCMath - PR PHP 8.4 | NewFunctions: detect use of new BCMath functions (RFC) #1735
• Transform exit() from a language construct into a standard function - PRs Composer: raise the minimum supported PHPCS + PHPCSUtils versions + fix test failures #1806 + PHP 8.4 | Handle "Exit as function call" in various sniffs #1807
• Grapheme cluster for str_split function: grapheme_str_split - PR PHP 8.4 | NewFunctions: detect use of new grapheme_str_split() function (RFC) #1750
• Multibyte for ucfirst and lcfirst functions - PR PHP 8.4 | NewFunctions: detect use of new mb_[uc|lc]first() functions (RFC) #1753
• Add http_(get|clear)_last_response_headers() function - PR PHP 8.4 | NewFunctions: detect use of new http_*_last_response_header() functions (RFC) #1756
• RFC1867 for non-POST HTTP verbs - PR PHP 8.4 | NewFunctions/NewClasses: detect use of new request_parse_body() functionality (RFC) #1760
• XML_OPTION_PARSE_HUGE - PR PHP 8.4 | NewConstants: detect use of XML_OPTION_PARSE_HUGE (RFC) #1734
• Multibyte for trim function mb_trim, mb_ltrim and mb_rtrim - PR PHP 8.4 | NewFunctions: detect use of new mb_*trim() functions (RFC) #1766
• PDO driver specific sub-classes - PR PHP 8.4 | NewClasses: add support for PDO driver specific subclasses (RFC) #1755
• Dedicated StreamBucket class - PR PHP 8.4 | NewClasses: detect use of new StreamBucket class (RFC) #1752
  👉 Note: the RFC includes a proposal to deprecate the $datalen property in the return value in favour of the (new) $dataLength property.
  This proposal, however, is slated for the next PHP version (8.5 or 9.0), not for PHP 8.4.
• Unbundle the imap, pspell, and oci8 extensions - IMAP PR PHP 8.4: account for removed extension IMAP (RFC) #1751, OCI8 PR PHP 8.4: account for removed extension OCI8 (RFC) #1754, PSpell PR PHP 8.4: account for removed extension PSpell (RFC) #1757
• Raising zero to the power of negative number - PR PHP 8.4 | NewFunctions: detect use of new fpow() function (RFC) #1774
  Note: no sniff will be created to check ** and pow() operations for 0 with a negative power as it is deemed unlikely that any such calculations with both numbers hard-coded will ever be found and PHPCS is not suitable for variable value tracing throughout a codebase.
• array_find - PR PHP 8.4 | NewFunctions: detect use of new array functions (RFC) #1771
• Make the GMP class final - PR PHP 8.4 | ForbiddenExtendingFinalPHPClass: detect classes extending GMP class (RFC) #1739
• Deprecations for PHP 8.4
  • Deprecate DOM_PHP_ERR Constant - PR PHP 8.4 | RemovedConstants: detect use of DOM_PHP_ERR (RFC) #1761
  • session.sid_length and session.sid_bits_per_character - PR PHP 8.4 | RemovedIniDirectives: detect use of session.sid_* (RFC) #1758
  • xml_set_object() and xml_set_*_handler() with string method names - PR PHP 8.4 | ✨ New PHPCompatibility.ParameterValues.RemovedXmlSetHandlerCallbackUnset sniff (RFC) #1744, PR PHP 8.4 | RemovedFunctions: detect use of xml_set_object (RFC) #1763
  • Passing null and false to dba_key_split() - PR PHP 8.4 | ✨ New PHPCompatibility.ParameterValues.RemovedDbaKeySplitNullFalse sniff (RFC) #1745
  • Constants SUNFUNCS_RET_STRING, SUNFUNCS_RET_DOUBLE, SUNFUNCS_RET_TIMESTAMP - PR PHP 8.4 | RemovedConstants: detect use of SUNFUNCS_RET_* constants (RFC) #1768
  • Deprecate proprietary CSV escaping mechanism - PR PHP 7.4/8.4 | ✨ New PHPCompatibility.ParameterValues.RemovedProprietaryCSVEscaping sniff #1787
  • Deprecate E_STRICT Constant - PR PHP 8.4 | RemovedConstants: detect use of E_STRICT (RFC) #1772
  • Deprecate mysqli_ping() and mysqli::ping() - PR PHP 8.4 | RemovedFunctions: detect use of mysqli_ping (RFC) #1769
  • Deprecate mysqli_refresh() - PR PHP 8.4 | RemovedFunctions: detect use of mysqli_refresh (RFC) #1773 (function) + PR PHP 8.4 | RemovedConstant: detect use of MYSQLI_REFRESH_* (RFC) #1782 (constants)
  • Deprecate mysqli_kill() - PR PHP 8.4 | RemovedFunctions: detect use of mysqli_kill (RFC) #1776
  • Deprecate the second parameter to mysqli_store_result() - PR PHP 8.4 | RemovedFunctionParameters: detect use of mysqli_store_result $mode (RFC) #1740 (see PR PHP 8.1 | RemovedConstants: account for PHP 8.1 changes #1319 about the constant)
  • Deprecate lcg_value() - PR PHP 8.4 | RemovedFunctions: detect use of lcg_value (RFC) #1781
  • Deprecate passing E_USER_ERROR to trigger_error() - PR PHP 8.4 | ✨ New PHPCompatibility.ParameterValues.RemovedTriggerErrorLevel sniff (RFC) #1741
  • Deprecate using a single underscore _ as a class name - PR PHP 8.4 | ✨ New PHPCompatibility.Classes.ForbiddenClassNameUnderscore sniff (RFC) #1742
  • Deprecate SOAP_FUNCTIONS_ALL constant and passing it to SoapServer::addFunction() - PR PHP 8.4 | RemovedConstants: detect use of SOAP_FUNCTIONS_ALL (RFC) #1775

Reviewed and concluded non-sniffable

• Change how JIT is disabled by default
  Review notes: This is a change to the default value of ini configuration settings. Previously the opcache.jit_buffer_size (INI_SYSTEM) ini would need to be set to a non-0 value to enable JIT. Now the opcache.jit (INI_ALL but only when not set to disable) ini will need to be changed from disable to any of the other valid values.
  As these ini configuration changes cannot be made at run-time, but must be made in a php.ini file, there is nothing to sniff for.
• A new JIT implementation based on IR Framework
  Review notes: doesn't appear to have any sniffable implications.
• Increasing the default BCrypt cost
  Review notes: this has no impact on userland code, other than in performance. As the cost is included in the hash, the password hashes are cross-version compatible anyhow.

  Note that password_hash() returns the algorithm, cost and salt as part of the returned hash.
  Therefore, all information that's needed to verify the hash is included in it.
  This allows the verify function to verify the hash without needing separate storage for the salt or algorithm information.
  Source: https://www.php.net/manual/en/function.password-verify.php

Delayed to later PHP version

• (in part) Dedicated StreamBucket class
  👉 Note: the RFC includes a proposal to deprecate the $datalen property in the return value in favour of the (new) $dataLength property.
  This proposal, however, is slated for the next PHP version (8.5 or 9.0), not for PHP 8.4.
• Deprecations for PHP 8.4
  Sublist:
  • Deprecate returning non-string values from a user output handler [Landed in 8.5]
  • Deprecate producing output in a user output handler [Landed in 8.5]

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.4 is determined, they will either be moved to the "To Do" list or removed from this ticket.

Accepted, not yet (fully) implemented

Feature freeze is in effect. Anything which didn't make it in yet, is delayed to a future PHP version.

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.4 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.