Everything
php
timwolla
Contributor Directory
RFCs
Language and policy proposals from this contributor
RFCs are part of the process by which decisions are made about PHP. For more information about the RFC
process as well as viewing a full list of RFCs please visit the RFC section.
Deprecations for PHP 8.6
The RFC proposes to deprecate the listed functionality in PHP 8.6 and remove it in PHP 9 (except where otherwise noted).
Deprecate the list() construct?
Yes
23 Votes (49%)
No
23 Votes (49%)
Abstain
1 Votes (2%)
Deprecate returning from a finally block?
Yes
39 Votes (85%)
No
3 Votes (7%)
Abstain
4 Votes (9%)
Deprecate using let as an identifier?
Yes
24 Votes (55%)
No
11 Votes (25%)
Abstain
9 Votes (20%)
Deprecate using namespace as a class constant name?
Yes
29 Votes (66%)
No
8 Votes (18%)
Abstain
7 Votes (16%)
Deprecate using in, out, and inout as identifiers?
Yes
8 Votes (18%)
No
21 Votes (48%)
Abstain
15 Votes (34%)
Deprecate using is as an identifier?
Yes
29 Votes (64%)
No
10 Votes (22%)
Abstain
6 Votes (13%)
Deprecate the possibility to name a function readonly?
Yes
39 Votes (93%)
No
1 Votes (2%)
Abstain
2 Votes (5%)
Deprecate using _ as a constant and compile time alias?
Yes
34 Votes (79%)
No
4 Votes (9%)
Abstain
5 Votes (12%)
Deprecate using _ as a function name and the _() function alias for gettext()?
Yes
10 Votes (23%)
No
22 Votes (51%)
Abstain
11 Votes (26%)
Passing objects for $array parameter of array_walk() and array_walk_recursive()?
Yes
41 Votes (93%)
No
3 Votes (7%)
Abstain
0 Votes (0%)
Passing objects for $options parameter of deflate_init() and inflate_init()?
Yes
39 Votes (89%)
No
4 Votes (9%)
Abstain
1 Votes (2%)
Passing objects as parameters to the zlib.inflate and zlib.deflate stream filters?
Yes
38 Votes (86%)
No
4 Votes (9%)
Abstain
2 Votes (5%)
Passing objects as parameters to the bzip2.decompress and bzip2.compress stream filters?
Yes
38 Votes (86%)
No
4 Votes (9%)
Abstain
2 Votes (5%)
Passing objects for $vars parameter of mb_convert_variables()?
Yes
39 Votes (91%)
No
2 Votes (5%)
Abstain
2 Votes (5%)
Passing objects for $data parameter of http_build_query()?
Yes
21 Votes (48%)
No
10 Votes (23%)
Abstain
13 Votes (30%)
Deprecate is_double()?
Yes
40 Votes (91%)
No
2 Votes (5%)
Abstain
2 Votes (5%)
Deprecate is_integer()?
Yes
39 Votes (89%)
No
2 Votes (5%)
Abstain
3 Votes (7%)
Deprecate is_long()?
Yes
39 Votes (89%)
No
2 Votes (5%)
Abstain
3 Votes (7%)
Deprecate doubleval()?
Yes
38 Votes (86%)
No
2 Votes (5%)
Abstain
4 Votes (9%)
Deprecate define() with $case_insensitive being specified?
Yes
41 Votes (93%)
No
0 Votes (0%)
Abstain
3 Votes (7%)
Deprecate is_subclass_of with string when $allow_string is false?
Yes
37 Votes (84%)
No
0 Votes (0%)
Abstain
7 Votes (16%)
Deprecate is_a with string when $allow_string is false?
Yes
38 Votes (86%)
No
0 Votes (0%)
Abstain
6 Votes (14%)
Deprecate strcoll()?
Yes
39 Votes (87%)
No
2 Votes (4%)
Abstain
4 Votes (9%)
Deprecate SORT_LOCALE_STRING flag for sort() functions?
Yes
38 Votes (88%)
No
2 Votes (5%)
Abstain
3 Votes (7%)
Deprecate Metaphone Function?
Yes
20 Votes (45%)
No
8 Votes (18%)
Abstain
16 Votes (36%)
Deprecate dechunk filter?
Yes
18 Votes (40%)
No
15 Votes (33%)
Abstain
12 Votes (27%)
Deprecate ReflectionProperty::setValue() and ReflectionProperty::setRawValue() with wrong types?
Yes
43 Votes (93%)
No
1 Votes (2%)
Abstain
2 Votes (4%)
Deprecate ReflectionMethod::invoke() and ReflectionMethod::invokeArgs() with objects for static methods?
Yes
39 Votes (91%)
No
3 Votes (7%)
Abstain
1 Votes (2%)
Deprecate ArrayIterator methods that inherit ArrayObject implementation?
Yes
42 Votes (98%)
No
1 Votes (2%)
Abstain
0 Votes (0%)
Deprecate spl_classes()?
Yes
43 Votes (100%)
No
0 Votes (0%)
Abstain
0 Votes (0%)
Deprecate spl_object_hash()?
Yes
26 Votes (57%)
No
9 Votes (20%)
Abstain
11 Votes (24%)
Deprecate SplFileObject CSV methods?
Yes
25 Votes (56%)
No
5 Votes (11%)
Abstain
15 Votes (33%)
Deprecate mysqli::stmt_init, mysqli_stmt_init, and mysqli_stmt::__construct without the second argument?
Yes
40 Votes (93%)
No
0 Votes (0%)
Abstain
3 Votes (7%)
Deprecate mysqli_get_charset()?
Yes
43 Votes (100%)
No
0 Votes (0%)
Abstain
0 Votes (0%)
Deprecate passing a $sessionhandler object to session_set_save_handler() which does not contain the create_sid() and validateId() methods?
Yes
26 Votes (62%)
No
2 Votes (5%)
Abstain
14 Votes (33%)
Partial Function Application for instance of non-static methods ("$this")
Partial Function Application enabled convenient creation of Closures that just defer to an existing function with some parameters already filled in with the rem...
Explicit fallthrough for ''switch''
This RFC proposes to add a fallthrough; marker to switch to prevent accidental fallthrough, helping to avoid bugs while making intentional fallthrough visible a...
#[\NonExhaustive] marker
The elevator pitch for the RFC. The first paragraph of this section will be rendered slightly larger to give it emphasis.
Release Manager Selection
The current policy about the Release Manager Selection process is using unclear and confusing terminology and allows for decisions to be made that no longer mat...
Accept php/policies PR #28 (Clarify policy for Release Manager Selection) at commit d887ee1e1ece6a46d1d621d2d551474cb15ea161?
Yes
17 Votes (63%)
No
6 Votes (22%)
Abstain
4 Votes (15%)
Clarify discussion and voting period rules
The current written policy governing the RFC process no longer matches the current process practiced and expected by the community.
Accept php/policies PR #23 (Clarify discussion and voting period rules) at commit c087d812e694a9fb1371b871c4372305f0cb5cbe?
Yes
24 Votes (77%)
No
6 Votes (19%)
Abstain
1 Votes (3%)
Abstain voting option for RFCs
It is commonly the case that RFC voters do not feel strongly about an individual RFC, but the current voting guidelines make it impossible to express this.
Accept php/policies PR #20 (Add Abstain voting option and update phrasing for the voting) at commit de94b7a132c4a74e54e7848914203f1849231697?
Yes
27 Votes (68%)
No
7 Votes (18%)
Abstain
6 Votes (15%)
Throwable Hierarchy Policy for Extensions
PHP has a number of de facto rules and policies around the use of exceptions in extensions, for example not to use SPL exceptions in new code, but no official d...
Accept php/policies PR #17 (Add Throwable policy) at commit cf4cfb3ea95e3a59a56a395e1fae00ff9722e0cd?
Yes
25 Votes (96%)
No
1 Votes (4%)
Casing of acronyms in class and method names
The results of the Class Naming RFC decided that class names should be written in PascalCase (Upper Camel Case), with the exception of acronyms, which should be...
Adopt the updated class naming policy and adjust the new names introduced in PHP 8.4?
yes
23 Votes (96%)
no
1 Votes (4%)
Deprecations for PHP 8.4
The RFC proposes to deprecate the listed functionality in PHP 8.4 and remove it in PHP 9 (except where otherwise noted).
Formally deprecate and remove the aforementioned DOMDocument and DOMEntity properties?
Yes
36 Votes (100%)
No
0 Votes (0%)
Remove DOMImplementation::getFeature($feature, $version)
Yes
38 Votes (100%)
No
0 Votes (0%)
Deprecate DOM_PHP_ERR constant?
Yes
37 Votes (100%)
No
0 Votes (0%)
Deprecate unserialize()’s ‘S’ tag?
Yes
36 Votes (100%)
No
0 Votes (0%)
Deprecate the INI settings ‘session.sid_length’ and ‘session.sid_bits_per_character’?
Yes
35 Votes (100%)
No
0 Votes (0%)
Deprecate SplFixedArray::__wakeup()?
Yes
36 Votes (100%)
No
0 Votes (0%)
Deprecate xml_set_object() and xml_set_*_handler() with string method names
Yes
33 Votes (100%)
No
0 Votes (0%)
Deprecate passing null and false to dba_key_split()
Yes
33 Votes (100%)
No
0 Votes (0%)
Deprecate passing incorrect data types for options to ext/hash functions
Yes
33 Votes (100%)
No
0 Votes (0%)
Deprecate constants SUNFUNCS_RET_STRING, SUNFUNCS_RET_DOUBLE, and SUNFUNCS_RET_TIMESTAMP?
Yes
32 Votes (100%)
No
0 Votes (0%)
Deprecate passing a non-empty string to the $escape parameter
Yes
26 Votes (93%)
No
2 Votes (7%)
Remove the E_STRICT Error Level and Deprecate the E_STRICT constant?
Yes
29 Votes (85%)
No
5 Votes (15%)
Deprecate strtok()?
Yes
6 Votes (18%)
No
27 Votes (82%)
Deprecate returning non-string values from a user output buffer handler?
Yes
23 Votes (85%)
No
4 Votes (15%)
Deprecate producing output in a user output handler?
Yes
25 Votes (93%)
No
2 Votes (7%)
Deprecate using an array as the $data argument for file_put_contents()
Yes
20 Votes (57%)
No
15 Votes (43%)
Deprecate mysqli_ping() and mysqli::ping()?
Yes
27 Votes (100%)
No
0 Votes (0%)
Deprecate mysqli_refresh(), mysqli::refresh() and related constants?
Yes
27 Votes (96%)
No
1 Votes (4%)
Deprecate mysqli_kill() and mysqli::kill()?
Yes
27 Votes (96%)
No
1 Votes (4%)
Deprecate the second parameter to mysqli_store_result()?
Yes
31 Votes (100%)
No
0 Votes (0%)
Deprecate lcg_value()?
Yes
29 Votes (94%)
No
2 Votes (6%)
Deprecate uniqid()?
Yes
14 Votes (38%)
No
23 Votes (62%)
Deprecate md5(), sha1(), md5_file(), and sha1_file()?
Yes
18 Votes (46%)
No
21 Votes (54%)
Deprecate passing E_USER_ERROR to trigger_error()
Yes
27 Votes (93%)
No
2 Votes (7%)
Deprecate using a single underscore as a class name?
Yes
28 Votes (80%)
No
7 Votes (20%)
Deprecate SOAP_FUNCTIONS_ALL constant and passing it to SoapServer::addFunction()?
Yes
28 Votes (97%)
No
1 Votes (3%)
Deprecate returning values from __construct() and __destruct()
A class constructor and destructor (Lifecycle Functions) are special in that they are not meant to be used like regular methods and called manually. Observing t...
Deprecate returning values from __construct() and __destruct()?
Yes
39 Votes (100%)
No
0 Votes (0%)
Abstain
0 Votes (0%)
enum SortDirection
PHPs standard library has no type-safe way to express sort direction. Today we use the integer constants SORT_ASC and SORT_DESC (which only work with array_mult...
Implement the SortDirection enum as outlined in the RFC?
Yes
22 Votes (85%)
No
2 Votes (8%)
Abstain
2 Votes (8%)
Partial Function Application: Handling of Optional Parameters
The accepted Partial Function Application RFC proposed inheriting the optionality of ?-placeholdered parameters. This results in inconsistent user-facing behavi...
Make all ? placeholders in PFA required parameters?
Yes
25 Votes (96%)
No
0 Votes (0%)
Abstain
1 Votes (4%)
Duration class
Measuring and defining elapsed time is a ubiquitous concept in programming languages. Use cases where accurately defining such duration include defining timeout...
Implement the Time\Duration class as outlined in the RFC?
Yes
35 Votes (92%)
No
1 Votes (3%)
Abstain
2 Votes (5%)
Should the mathematical operation methods of Time\Duration use full or abbreviated names?
multiplyBy, divideBy, negate, absolute
30 Votes (86%)
mul, divBy, neg, abs
2 Votes (6%)
Abstain
3 Votes (9%)
Deprecations for PHP 8.5
The RFC proposes to deprecate the listed functionality in PHP 8.5 and remove it in PHP 9 (except where otherwise noted).
Deprecate semicolon-terminated case statements?
Yes
22 Votes (69%)
No
10 Votes (31%)
Deprecate non-standard cast names?
Yes
32 Votes (100%)
No
0 Votes (0%)
Deprecate attributes applying to multiple class properties/constants
Yes
5 Votes (21%)
No
19 Votes (79%)
Deprecate backticks as an alias for shell_exec?
Yes
21 Votes (72%)
No
8 Votes (28%)
Deprecate the __sleep() and __wakeup() magic methods?
Yes
18 Votes (67%)
No
9 Votes (33%)
Deprecate using values null as an array offset and when calling array_key_exists()?
Yes
25 Votes (89%)
No
3 Votes (11%)
Deprecate __debugInfo() returning null?
Yes
22 Votes (81%)
No
5 Votes (19%)
Deprecate constant redeclaration?
Yes
31 Votes (100%)
No
0 Votes (0%)
Deprecate closure binding issues?
Yes
29 Votes (100%)
No
0 Votes (0%)
Enact follow-up phase of the Path to Saner Increment/Decrement operators RFC?
Yes
23 Votes (85%)
No
4 Votes (15%)
Deprecate the report_memleaks INI directive?
Yes
23 Votes (92%)
No
2 Votes (8%)
Deprecate the register_argc_argv INI directive and make in default to Off in PHP 8.5, then hardcode it to Off for all non-CLI-related SAPIs on PHP 9 (while keeping it hardcoded to On for CLI-related ones)?
Yes
27 Votes (100%)
No
0 Votes (0%)
Remove disable_classes INI setting?
Yes
26 Votes (100%)
No
0 Votes (0%)
Deprecate Reflection*::setAccessible()?
Yes
24 Votes (100%)
No
0 Votes (0%)
Deprecate ReflectionParameter::allowsNull()?
Yes
9 Votes (47%)
No
10 Votes (53%)
Deprecate ReflectionClass::getConstant() for missing constants?
Yes
25 Votes (100%)
No
0 Votes (0%)
Deprecate ReflectionProperty::getDefaultValue() for properties without default values?
Yes
22 Votes (92%)
No
2 Votes (8%)
Deprecate ArrayObject and ArrayIterator with objects?
Yes
26 Votes (100%)
No
0 Votes (0%)
Deprecate SplObjectStorage::contains(), SplObjectStorage::attach(), and SplObjectStorage::detach()?
Yes
17 Votes (89%)
No
2 Votes (11%)
Deprecate passing spl_autoload_call() to spl_autoload_unregister()?
Yes
23 Votes (100%)
No
0 Votes (0%)
Deprecate non-canonical type names for settype()?
Yes
8 Votes (44%)
No
10 Votes (56%)
Deprecate the $exclude_disabled parameter of get_defined_functions()?
Yes
23 Votes (100%)
No
0 Votes (0%)
Deprecate passing null to readdir(), rewinddir(), and closedir()?
Yes
24 Votes (89%)
No
3 Votes (11%)
Deprecate passing string which are not one byte long to ord()?
Yes
20 Votes (83%)
No
4 Votes (17%)
Deprecate passing integers outside the interval [0, 255] to chr()?
Yes
21 Votes (95%)
No
1 Votes (5%)
Formally deprecate socket_set_timeout?
Yes
22 Votes (100%)
No
0 Votes (0%)
Deprecate the $http_response_header predefined variable?
Yes
22 Votes (92%)
No
2 Votes (8%)
Deprecate FILTER_DEFAULT constant?
Yes
12 Votes (55%)
No
10 Votes (45%)
Emit a deprecation notice when using the default value for the $filter argument of the filter_*() functions?
Yes
9 Votes (47%)
No
10 Votes (53%)
Deprecate special build system support for drivers without a driver manager?
Yes
16 Votes (100%)
No
0 Votes (0%)
Deprecate ODBCVER checks?
Yes
15 Votes (100%)
No
0 Votes (0%)
Deprecate PDO’s uri: scheme?
Yes
22 Votes (100%)
No
0 Votes (0%)
Deprecate PDO::ERRMODE_WARNING constant?
Yes
8 Votes (40%)
No
12 Votes (60%)
Deprecate driver specific PDO constants and methods?
Yes
17 Votes (74%)
No
6 Votes (26%)
Deprecate statement transaction state specific PDO constants?
Yes
17 Votes (100%)
No
0 Votes (0%)
Deprecate finfo_close()?
Yes
24 Votes (92%)
No
2 Votes (8%)
Deprecate xml_parser_free()?
Yes
22 Votes (92%)
No
2 Votes (8%)
Deprecate curl_close()?
Yes
23 Votes (88%)
No
3 Votes (12%)
Deprecate curl_share_close()?
Yes
23 Votes (88%)
No
3 Votes (12%)
Deprecate imagedestroy()?
Yes
23 Votes (92%)
No
2 Votes (8%)
Deprecate key_length parameter of openssl_pkey_derive()?
Yes
24 Votes (100%)
No
0 Votes (0%)
Deprecate intl.error_level INI setting?
Yes
22 Votes (100%)
No
0 Votes (0%)
Formally deprecate mysqli_execute?
Yes
22 Votes (100%)
No
0 Votes (0%)
Deprecate building ext/ldap against Oracle LDAP?
Yes
19 Votes (100%)
No
0 Votes (0%)
Deprecate the $context parameter for finfo_buffer()?
Yes
24 Votes (100%)
No
0 Votes (0%)
Deprecate DATE_RFC7231 and DateTimeInterface::RFC7231?
Yes
22 Votes (100%)
No
0 Votes (0%)
Make OPcache a non-optional part of PHP
Since OPcaches integration into the Open Source PHP project with PHP 5.5, OPcache has become an essential part of PHP, running PHP in production without OPcache...
Make OPcache a non-optional part of PHP?
yes
30 Votes (100%)
no
0 Votes (0%)
Clone with v2
Both readonly properties and the cloning of objects are commonplace in a lot of PHP applications, but these two concepts dont fully work together in all cases.
Implement clone-with as outlined in the RFC?
Yes
16 Votes (80%)
No
4 Votes (20%)
Marking return values as important (#[\NoDiscard])
PHPs error handling mechanism of choice in newer APIs is the use of Exceptions, where forgetting to handle the failure case results in a very obvious error, whe...
Implement the #[\NoDiscard] attribute as described?
Yes
18 Votes (82%)
No
4 Votes (18%)
Implement the (void) cast to reliably suppress #[\NoDiscard]?
Yes
18 Votes (90%)
No
2 Votes (10%)
Support Closures in constant expressions
Several PHP constructs are limited to accept constant expressions only. These expressions may only contain a limited number of operations that can roughly be su...
Support Closures in constant expressions as proposed?
Yes
19 Votes (100%)
No
0 Votes (0%)
First Class Callables in constant expressions
The Support Closures in constant expressions RFC added support for Closures in constant expressions. The RFC left supporting First Class Callables (FCC), which ...
Support first class callables in constant expressions as proposed?
Yes
29 Votes (100%)
No
0 Votes (0%)
Correctly name the rounding mode and make it an Enum
There are eight rounding modes in the current master branch (8.4):
Add the RoundingMode enum as described?
Yes
34 Votes (100%)
No
0 Votes (0%)
Increasing the default BCrypt cost
PHP's default BCrypt cost for password_hash is unchanged since the addition of the password hashing API in PHP 5.5 which was 11 years ago.
Increase the default BCrypt cost?
Yes
25 Votes (100%)
No
0 Votes (0%)
Increase the default BCrypt cost to?
11 (less than 160ms per hash)
12 Votes (46%)
12 (less than 330ms per hash)
14 Votes (54%)
Marking overridden methods (#[\Override])
When implementing an interface or inheriting from another class PHP performs various checks to ensure that implemented methods are compatible with the constrain...
Implement the #[\Override] attribute as described?
Yes
22 Votes (96%)
No
1 Votes (4%)
Make unserialize() emit a warning for trailing bytes
PHP silently accepts trailing bytes after a valid serialization payload when unserializing. This is undesirable.
Make unserialize() emit a E_WARNING if the input contains trailing bytes?
Yes
20 Votes (100%)
No
0 Votes (0%)
Improve unserialize() error handling
PHP's current error reporting in unserialize() is very inconsistent, making it hard to reliably handle errors that occur during unserialization.
Add the \UnserializationFailedException and wrap any Throwables in PHP 8.x?
Yes
20 Votes (63%)
No
12 Votes (38%)
Increase the severity of emitted E_NOTICE to E_WARNING in PHP 8.x?
Yes
33 Votes (94%)
No
2 Votes (6%)
Throw \UnserializationFailedException instead of emitting E_NOTICE/E_WARNING in PHP 9.0?
Yes
23 Votes (74%)
No
8 Votes (26%)
Randomizer Additions
This RFC proposes to add new building block methods to \Random\Randomizer that implement commonly useful operations that are either verbose or very hard to impl...
Add Randomizer::getBytesFromString()?
Yes
18 Votes (100%)
No
0 Votes (0%)
Add Randomizer::nextFloat(), Randomizer::getFloat(), and the IntervalBoundary enum?
Yes
16 Votes (94%)
No
1 Votes (6%)
let construct (Block Scoping)
This RFC proposes the introduction of the let() construct, a new language construct for managing lifetimes of variables. It allows developers to define a block ...
Add the let construct for block-scoping?
Yes
13 Votes (39%)
No
15 Votes (45%)
Abstain
5 Votes (15%)
Random migration
While random number generation in PHP has been improved by a series of Random Extension RFCs, the old insecure methods remain, and need to be migrated to a more...