====== Request for Comments ====== This page gives an overview of the current RFCs for PHP. To create a new RFC, see [[rfc:howto|How To Create an RFC]]. Note: An RFC is effectively "owned" by the person that created it. If you want to make changes, get permission from the creator. If no agreement can be found, the only course of action is to create a competing RFC. In this case the old RFC page should be modified to become an intermediate page that points to all the competing RFC's. A new page in this RFC namespace will automatically be loaded with an RFC [[rfc:template|template]]. Customize as needed. ===== In voting phase ===== ===== Under Discussion ===== This section is for RFCs that have been announced on the PHP "internals" mail list. * [[rfc:list_reference_assignment|list() Reference Assignment]]\\ This RFC proposes a new syntax to enable reference assignment with list(). (Created 2013/10/25, withdrawn 2014-05-15, Commandeered and Reopened: 2016-12-30) * [[rfc:hash-context.as-resource|HashContext as Object]] \\ Change Hash Contexts to use Objects instead of Resources * [[rfc:throwable-code-generalization|Throwable code's type generalization]] \\ Change Throwable::getCode() & co. so that they can be of any type (Created: 2016-12-18) * [[rfc:soap_get_location|SoapClient getLocation]] \\ Add getLocation method to SoapClient (Created: 2016-12-06) * [[rfc:distrust-sha1-certificates|Distrust SHA-1 Certificates]] \\ Distrust SHA-1 starting in PHP 7.2 (Created: 2016-11-25) * [[rfc:object-typehint|Object typehint]] \\ Proposes adding ''object'' type-hint and return-type (Created: 2016-08-12) * [[rfc:arrayiterator-improvements|ArrayIterator improvements]] \\ Proposes adding ''ArrayIterator::seekKey()'' and ''ArrayIterator::prev()'' (Created: 2016-11-21) * [[rfc:parameter-no-type-variance|Parameter No Type Variance]] \\ Allow subclasses to drop parameter type constraints. (Created: 2016-11-21) * [[rfc:abolish-narrow-margins|Abolish Narrow Margins]] \\ Proposal to abolish 50%+1 votes (Created 2016-11-17) * [[rfc:deprecations_php_7_2|Deprecations for PHP 7.2]] \\ Functions and features to be deprecated in PHP 7.2 (Created 2015-12-28) * [[rfc:namespace_scoped_declares|Namespace-scoped declares]] \\ Add ability to specify declare directives at the namespace level. (Created: 2016-09-20) * [[rfc:uniqid|Improve uniqid() uniqueness.]] \\ Improve uniqid() uniqueness (Created: 2016-09-12) * [[rfc::deprecate-pear-include-composer|Deprecate PEAR/PECL & Replace with composer/pickle]] \\ Proposes replacing pear/pecl with composer/pickle (Created: 2016-09-01) * [[rfc:umaintained_extensions]] \\ Cleaning up unmaintained extensions * [[rfc:remove_utf_8_decode_encode]] \\ Remove utf8_decode() and utf8_encocde() * [[rfc:add_str_begin_and_end_functions|Add str_begins() and str_ends() functions]] \\ Add functions to check if a string begins with, or ends with, a given substring (Created 2016-08-01) * [[rfc:constant_redefinition|Exception on constant redefintion]] \\ Throw Exception on Attempt of Constant Redefinition (Created 2016-06-10) * [[rfc:array_change_keys|array_change_keys()]] \\ Add method to simplify re-keying an array (Created 2016-05-29) * [[rfc:intersection_types|Intersection Types]] (Discussion began 2016-04-28) * [[rfc:lexical-anon|Anonymous Class Lexical Scope]] \\ Anonymous Class Lexical Scope (Created 2016-04-19) * [[rfc:callableconstructors|Callable constructors]] \\ Allow constructors to be called as a callable (Created 2015-02-25) * [[rfc: traits-with-interfaces|Traits with interfaces]] \\ Allow traits to explicitly implement interfaces (Created 2016-02-17) * [[rfc: adopt-code-of-conduct|Adopt Code of Conduct]] \\ This RFC proposes that the PHP project should adopt a formal code of conduct for its members. (Re-created 2016-01-21) * [[rfc:friend-classes|Class Friendship]] \\ A proposal to add class friendship (Created 2015-12-10) * [[rfc: token-get-always-tokens|Normalize token_get_all() output]] \\ Allows specifying flag to normalize output of token_get_all() * [[rfc:on_demand_name_mangling|On-demand Name Mangling]] \\ Replaces automatic super-global name mangling with an on-demand approach for those apps requiring it. (Updated 2016-01-08) * [[rfc:array_key_first_last_index|Add array_key_(first|last|index) functions]] \\ Add functions to get the first/last/indexed array key and value. (Created 2016-01-01) * [[rfc:secure_serialization|Secure serialization by authentication code]] \\ Add authentication code protection to serialization. * [[rfc:list_default_value|Default Value in List Assignment Syntax]] \\ Allow set default values when using list assignment * [[rfc:list-syntax-trailing-commas|Trailing commas in list syntax]]\\ Allow for trailing commas in all list syntax (Created 2015-11-03) * [[rfc:sql_injection_protection|Automatic SQL injection protection]] \\ This RFC enables automatic detection of SQL queries that are issued with a non-constant query parameter-string, with configurable evasive action on detection (i.e. ignore/log/throw). * [[rfc:improved_error_callback_mechanism|Improved Error Callback Mechanism]] \\ This RFC aims to give extensions that intercept errors a better way to register their callbacks. (Created 2015-03-13) * [[rfc:consistent_function_names|Introduce consistent function names]] \\ This RFC proposes to have consistent function names that accord CORDING_STANDARDS. * [[rfc:introduce_design_by_contract|Introduce Design by Contract]]\\ This RFC is vote only RFC for 2 Design by Contract introduction proposals. * [[rfc:DbC|Native Design by Contract support as annotation]] \\ This RFC proposes native Design by Contract support to PHP (Created 2015/02/04) * [[rfc:DbC2|Native Design by Contract support as definition]] \\ This RFC proposes native Design by Contract support to PHP (Created 2015/02/10) * [[rfc:script_only_include|Introduce script only require/include ]] \\ Introduce script only include/require to prevent script inclusion. (Created 2015-02-10) * [[rfc:allow_url_include|Precise URL include control]]\\ This RFC proposes precise URL include control. * [[rfc:comparable|Comparable]]\\ A proposal to add a Comparable interface for userspace object comparisons. * [[rfc:deprecate_ini_set_get_aliases| Deprecate INI set/get aliases]] \\ This RFC proposes INI set/get alias function deprecation. (Created 2015-01-28) * [[rfc:additional-splat-usage|Additional splat operator usage]]\\ Allow splat operator to be used in array literals. (Created 2014-11-03) * [[rfc:github-pr|GitHub Pull Requests Triage Team]]\\ Define a process for triaging GitHub pull requests. (Created 2014-10-30) * [[rfc:checkdnsrr-default-type|Change checkdnsrr() $type argument behavior]]\\ This RFC proposes that the default behavior of the checkdnsrr() function be changed such that it no longer checks only for MX records by default. (Created 2014-09-19) * [[rfc:heredoc-scanner-loosening|Loosening heredoc/nowdoc scanner]]\\ More permissive scanner rules for heredoc/nowdoc (Created 2014-08-29) * [[rfc:binary_string_comparison|Binary String Comparison]]\\ Non-strict binary string comparison * [[rfc:password_hash_spec|password_hash function behavior]]\\ Current password_hash()'s hash function has password length limitation. (Created 2014-07-23) * [[rfc:reflectionparameter.typehint|ReflectionParameter Typehint accessors]]\\ New API for accessing typehints on a reflection parameter. * [[rfc:secure-session-options-by-default|Secure Session Options]]\\ This RFC proposes secure options for session module as default (Vote period: 2014/02/14 - 2014/02/21) (Created: 2014/02/01) * [[rfc:unified-crypto-source|Unify crypto source INI setting]]\\ This RFC proposes unified crypto source settings. (Created 2014/02/13) * [[rfc:nophptags|Make PHP open tag optional for better security]]\\ This RFC proposes option (php.ini and CLI opts) for removing PHP tags (list() (Created 2016-04-07) * [[rfc:invalid_strings_in_arithmetic|Warn about invalid strings in arithmetic]] \\ Produce E_NOTICE or E_WARNING when using invalid numeric strings with arithmetic operators (Created 2016-01-08) * [[rfc:list_keys|Allow specifying keys in list()]] \\ Adds syntax to help unpacking associative arrays into variables (Created 2016-01-17) * [[rfc:iterable|Iterable]] \\ Iterable pseudo-type accepting arrays or objects implementing Traversable (Created 2016-06-10) * [[rfc: negative-string-offsets|Generalize support of negative string offsets]] \\ Add support for negative string offsets everywhere it makes sense (Created 2016-01-23) * [[rfc:closurefromcallable|Closure from callable function]] \\ Add a function to create closures from callables without reflection * [[rfc: deprecate_mb_ereg_replace_eval_option|Deprecate mb_ereg_replace eval option]] \\ This RFC aims at deprecating the e option that mb_ereg_replace and mb_eregi_replace provide. * [[rfc:mcrypt-viking-funeral|Deprecate (and remove) Mcrypt]] \\ Let's get rid of ext/mcrypt, which is abandonware and inhibits the growth of the language, as soon as humanly possible. (Created 2016-01-09) * [[rfc: openssl_aead|OpenSSL AEAD support]] \\ Adds support for AEAD cipher modes (GCM and CCM) to openssl_decrypt and openssl_encrypt. * [[rfc:void_return_type|Void Return Type]] \\ Adds a void return type to require that a function does not return a value. (Revived 2015-10-04, originally created 2015-02-14) * [[rfc:class_const_visibility|Class constant visibility modifiers]] \\ Introduce class constants visibility modifiers that mirror properties and methods. (Created 2015/09/13) * [[rfc:octal.overload-checking|Octal Overflow Protection]] \\ Stop quietly ignoring overflows in octal number parsing (Created: 2016-04-12) * [[rfc:rng_fixes|RNG fixes and changes]] \\ Fixes and improvements to the random number generation subsystems (Created 2016-06-14) * [[rfc::curl_http2_push|Add HTTP/2 Server Push support to ext/curl]] (Created 2015/10/01) * [[rfc:intl.timezone.get-windows-id|TimeZone::getWindowsID]] (Created (2016/03/15) * [[rfc:multiple-catch|Multi catch]] \\ Catching multiple exception types in a single catch statement (Created 2016/03/06) * [[rfc:forbid_dynamic_scope_introspection|Forbid dynamic calls to scope introspection functions]] (Created 2016-05-01) * [[rfc:new-curl-error-functions|Add curl_multi_errno(), curl_share_errno() and curl_share_strerror()]] (Created: 2016-04-29) * [[rfc:throw_error_in_extensions|Throw Error in Extensions]] \\ Convert E_ERROR and E_RECOVERABLE_ERROR to throw Error in extensions (Created 2016-06-14) * [[rfc:Precise float value|More precise float value handling]] \\ This RFC proposes more precise float value handling. * [[rfc:additional-context-in-pcntl-signal-handler|Additional Context in pcntl_signal Handler]] \\ Adds a second array argument to ''pcntl_signal'' handler (Created 2016-06-14) * [[rfc:session-create-id|Add session_create_id()]] \\ Add session_create_id() function (Created 2016-04-07) * [[rfc:session-gc|Add session_gc()]] \\ Add session_gc() function (Created 2016-04-06) ==== PHP 7.0 ==== * [[rfc:Random-Function-Exceptions|Random Functions throwing Exceptions]] \\ This RFC proposes that the random_* functions should throw exceptions on failure. * [[rfc:throwable-interface|Throwable Interface]] \\ Proposes a modification to the exception hierarchy for PHP 7, introducing a Throwable interface and Error class. * [[rfc:context_sensitive_lexer|Context Sensitive Lexer]]\\ Proposal to have a context sensitive lexer for PHP with support for semi-reserved words (Created 2015-02-15) * [[rfc:preg_replace_callback_array|Add preg_replace_callback_array function]]\\ A RFC proposing each pattern can easily have a specific callback. * [[rfc:easy_userland_csprng|Reliable User-land CSPRNG]]\\ A proposal to add a reliable CSPRNG (Created 2015-02-20) * [[rfc:anonymous_classes|Anonymous Class Support]]\\ This RFC proposes support for anonymous classes. * [[rfc:generator-delegation|Generator Delegation]] \\ This RFC proposes new syntax to delegate generator function operations to sub-iterators/generators (Created 2015-03-01) * [[rfc:reserve_more_types_in_php_7|Reserve More Type Names in PHP 7]] \\ Reserves ''int'', ''float'', ''string'', ''bool'', ''true'', ''false'' and ''null'' in class names or namespaces. (Created 2015-02-18) * [[rfc:internal_constructor_behaviour|Constructor behaviour of internal classes]]\\ Cleanup undesirable behaviour of constructors internal classes. (Created 2015-03-01) * [[rfc:reclassify_e_strict|Reclassify E_STRICT notices]]\\ This RFC proposes to reclassify our few existing E_STRICT notices to different categories. (Created 2015-02-22) * [[rfc:remove_php4_constructors|Remove PHP 4 Constructors]]\\ Stop recognizing methods with the same name as the defining class as constructors. (Created 2014-11-17; Voting closed 2015-03-10) * [[rfc:date.timezone_warning_removal|Remove the date.timezone warning]] \\ (Created 2015-01-27) * [[rfc:combined-comparison-operator|Combined Comparison (Spaceship) Operator]] \\ Proposes a new comparison operator, ''%%<=>%%'' (Created 2014-02-12, revived 2015-01-19) * [[rfc:php7_foreach|Fix "foreach" behavior]] \\ The RFC defines foreach statement behavior for the cases where is wasn't defined before and implementation provided inconsistent results. (Created 2015-01-29) * [[rfc:removal_of_dead_sapis_and_exts| Removal of dead SAPIs and extensions]]\\ Consideration about removing the unsupported SAPIs and extensions with unsupported dependencies. * [[rfc:remove_deprecated_functionality_in_php7|Remove deprecated functionality in PHP 7]]\\ Proposes to remove functionality that has been deprecated in the PHP 5.x cycle in PHP 7. (Created 2014-09-11) * [[rfc:jsond|Jsond]] \\ Whether jsond should replace the current json extension. (Created 2015-01-11) * [[rfc:json_preserve_fractional_part|Preserve Fractional Part in JSON encode]] \\ Adds a new option for JSON encode to preserve fractional part on float numbers. * [[rfc:return_types|Return Type Declarations]]\\ Adds return types to functions, methods and closures. (Created 2014-03-20) * [[rfc:fast_zpp|Fast Parameter Parsing API]]\\ Fast API in addition to zend_parse_parameters(). (Created 2014-05-23) * [[rfc:unicode_escape|Unicode Codepoint Escape Syntax]]\\ Adds an escape sequence syntax for Unicode codepoints to string literals. (Created 2014-11-24) * [[rfc:native-tls|Native TLS]]\\ Native TLS for internal globals in TS mode * [[rfc:isset_ternary|Null Coalesce Operator]]\\ Adds the coalesce operator, ''??'' * [[rfc:integer_semantics|Integer Semantics]]\\ Improves cross-platform consistency in PHP for some operations dealing with integers * [[rfc:zpp_fail_on_overflow|ZPP Failure on Overflow]]\\ Make ''zend_parse_parameters'' fail if a float value out of bounds, or NaN, is passed where an integer is expected. (Created 2014-09-22) * [[rfc:phpng|Move the phpng branch into master]]\\ Embrace the phpng codebase as the basis for the future major version of PHP. (Created 2014-07-20) * [[rfc:abstract_syntax_tree|Abstract Syntax Tree]]\\ Proposes the introduction of an Abstract Syntax Tree (AST) as an intermediary structure in our compilation process. * [[rfc:uniform_variable_syntax|Uniform Variable Syntax]]\\ Introduces an internally consistent and complete variable syntax. * [[rfc:size_t_and_int64_next|64 bit platform improvements for string length and integer]]\\ Integer and String modifications for full 64 bit support * [[rfc:closure_apply|Closure::call]]\\ Proposes a new method on the ''Closure'' class to allow calling bound to an object without pre-binding * [[rfc:fix_list_behavior_inconsistency|Fix list() behavior inconsistency]]\\ Enable or disable string handling in list() operator * [[rfc:remove_alternative_php_tags|Remove alternative PHP tags]]\\ Removes ASP and script tags * [[rfc:switch.default.multiple]]\\ Disallow multiple defaults in switch statements * [[rfc:catchable-call-to-member-of-non-object|Catchable "call to a member function of a non-object"]]\\ Turns this fatal error into E_RECOVERABLE (Created 2014-04-26) * [[rfc:secure_unserialize|Filtered unserialize()]]\\ Add option to ignore all or some objects to unserialize() (Created 2013/03/30) * [[rfc:intl.char|ICU IntlChar class]]\\ Adds an IntlChar class an intl_char_*() functions to the Intl extension. * [[rfc:session-lock-ini|Introduce session_start() INI options as array]]\\ Introduce session_start() options * [[rfc:remove_hex_support_in_numeric_strings|Remove hex support in numeric strings]] \\ Removes support for hexadecimal numbers in numeric string conversions. (Created 2014-08-19) * [[rfc:expectations|Expectations]]\\ This RFC proposes adding BC zero-cost assertions. (Created 2013-11-01) * [[rfc:group_use_declarations|Group Use Declarations]] \\ The RFC adds improvements to current PHP namespace implementation by introducing group use declarations. (Created 2015-01-28) * [[rfc:engine_exceptions_for_php7|Exceptions in the engine]]\\ This RFC proposes to allow the use of exceptions in the engine. (Created 2014-09-30) * [[rfc:generator-return-expressions|Generator Return Expressions]] \\ This RFC proposes the ability to specify and access return values from Generator functions * [[rfc:scalar_type_hints_v5|Scalar Type Hints v0.5]] \\ This RFC proposes a mixed-mode scalar type system * [[rfc:continue_ob|Continue output buffering]] \\ Let the output buffer stack be usable despite an aborted connection * [[rfc:intdiv|intdiv()]]\\ This RFC proposes adding an intdiv() function for integer division. (Created 2014-07-15) * [[rfc:session.user.return-value|Fix handling of custom session handler return values]]\\ Make false actually mean failure, not success. * [[rfc:gc_fn_pointer|Turn gc_collect_cycles into function pointer]] \\ Proposes to turn gc_collect_cycles into function pointer for extensions to hook into. (Created 2012-12-11) ==== PHP 5.6 ==== * [[rfc:debug-info|__debugInfo() magic method]]\\ Support get_debug_info hook for userspace classes * [[rfc:pow-operator|Exponential operator]]\\ Exponential operator * [[rfc:use_function|Importing namespaced functions]]\\ Proposes to allow importing namespaced functions through a new `use function` sequence. * [[rfc:const_scalar_exprs|Constant Scalar Expressions (with constants)]]\\ This RFC proposes adding support for Constant Scalar Expressions with support for constants being operands. * [[rfc:incompat_ctx|Remove calls from incompatible context]]\\ Calls from incompatible context deprecated in 5.6 (will be removed in next version). * [[rfc:variadics|Dedicated syntax for variadic functions]]\\ This RFC introduces a dedicated syntax for variadic functions. * [[rfc:argument_unpacking|Argument unpacking]]\\ This RFC proposes a syntax for argument unpacking. * [[rfc:operator_overloading_gmp|Internal operator overloading and GMP improvements]]\\ Add support for operator overloading in internal classes and improve GMP using it * [[rfc:phpdbg|phpdbg]]\\ Distribute phpdbg with PHP, a PHP debugger * [[rfc:slim_post_data|Slim POST data]]\\ Use a temp PHP stream for HTTP payload. * [[rfc:crypt_function_salt|Crypt() function salt]]\\ This RFC proposes changing crypt() function's salt parameter treatment. * [[rfc:fpm_change_hat|Apparmor change_hat functionality for php-fpm]]\\ Proposes to add the possibility to change to a different hat under the apparmor LSM * [[rfc:tls-peer-verification|TLS Peer Verification]]\\ Enable peer verification by default for encrypted client streams. * [[rfc::improved-tls-defaults|Improved TLS Defaults]]\\ Implement more secure defaults for encrypted stream transfers * [[rfc:default_encoding|Default character encoding]]\\ Default character encoding handling in PHP. * [[rfc:pack_unpack_64bit_formats|64 bit format codes for pack() and unpack()]]\\ Adds format codes for converting 64 bit integers to and from binary strings. * [[rfc:timing_attack|Timing attack safe string comparison function]]\\ New function to perform time-constant string comparison (Created 2013/12/22) ==== PHP 5.5 ==== * [[rfc:generators|Generators]]\\ This RFC proposes adding generators as a simple and boilerplate-free way of defining iterators. * [[rfc:finally|support finally keyword]]\\ Add try catch finally supporting * [[rfc:class_name_scalars|Resolve class names to scalars via class keyword]]\\ A proposal to use ::class after type names to resolve FQ class names as scalar * [[rfc:foreachlist|foreach_variable supporting T_LIST]]\\ This extends PHP's language parser to support T_LIST in foreach_variable * [[rfc:constdereference|Const array/string dereference]] \\ A little improvement to make things consistent * [[rfc:empty_isset_exprs|Allow arbitrary expression arguments to empty() and isset()]]\\ Proposes to allow ''empty(getArray())'' etc. * [[rfc:optimizerplus|Integrating Optimizer+ into the PHP distribution]]\\ This RFC proposes to integrate the Zend Optimizer+ opcode cache into the PHP distribution * [[rfc:hash_pbkdf2|Adding hash_pbkdf2 function]]\\ This RFC proposes adding a hash_pbkdf2 function to the hash package * [[rfc:password_hash|Add Simplified Password Hashing]]\\ This RFC proposes adding 3 new functions to the core to expose a much simplified password hashing API. * [[rfc:remove_preg_replace_eval_modifier|Remove preg_replace /e modifier]]\\ This RFC aims at deprecating and subsequently removing the /e modifier (PREG_REPLACE_EVAL) that preg_replace provides. * [[rfc:uconverter|Add UConverter]]\\ A proposal to add ICU::UConverter functionality to ext/intl * [[rfc:mysql_deprecation|ext/mysql deprecation]]\\ Formally deprecating ext/mysql in PHP. * [[rfc:cookie_max-age|Cookie Max-Age attribute]]\\ Cookie Max-Age attribute * [[rfc:curl-file-upload|Fix cURL file uploading API]]\\ Fix insecure cURL file uploading API * [[rfc:sendrecvmsg|Add recvmsg() and sendmsg() to ext/sockets]]\\ Wrap sendmsg() and recvmsg(), with support for a limited number of message types * [[rfc:cli_process_title|PHP CLI changing process title support]]\\ Setting PHP CLI process titles for visibility in 'top' or 'ps' * [[rfc:foreach-non-scalar-keys|Allow non-scalar keys in foreach]]\\ This RFC proposes to remove the type restrictions on foreach iteration * [[rfc:array_column|Add array_column() function]]\\ This RFC proposes a new array function that returns the values of the specified column from a multi-dimensional array. * [[rfc:curl-wrappers-removal-rfc|Removal of curl-wrappers]]\\ This RFC is about removing the curl stream wrappers of the PHP as of 5.5 and to move it on PECL for any eventual improvements. * [[rfc:strict_sessions|Strict Sessions]]\\ This RFC proposes an additional security measure for preventing session fixation. ==== PHP 5.4 ==== Note: Many RFCs in this list have been [[todo:php54:vote|mass voted]]. * [[rfc:instance-method-call|Instantiating a class and calling methods/accessing properties on same command]]\\ A proposal to add support to instantiating a class and calling its methods or accessing its properties on same command. * [[rfc:HorizontalReuse|Traits]]\\ Traits is a mechanism for code reuse in single inheritance languages such as PHP. A Trait is intended to reduce some limitations of single inheritance by enabling a developer to reuse sets of methods freely in several independent classes living in different class hierarchies. This RFC proposes a basic version of Traits. * [[rfc:closures:object-extension|Closures: Object Extension]]\\ How to extend closures to work with $this and objects. * [[rfc:shortsyntaxforarrays|Short syntax for arrays]]\\ This RFC will discuss an language enhancement for simple and easy array definition. * [[rfc:functionarraydereferencing|Function array dereferencing]]\\ You know, like foo()['bar'] * [[rfc:shortags|Short tags in templates]]\\ This RFC discusses ways to enable short tags template syntax in a way that would be easy for users and compatible with XML users' requirements. * [[rfc:indirect-method-call-by-array-var|Indirect method call by array variable]]\\ $arr = array('Class', 'method'); $arr(); * [[rfc:binnotation4ints|Supporting Binary Notation for Integers]]\\ This extends PHP's syntax to support binary notation for integers just as it already does for decimal, octal, and hexadecimal representations. * [[rfc:builtinwebserver|Built-in web server]]\\ This RFC discusses the web server that is built into PHP itself, for development purpose. * [[rfc:removal-of-deprecated-features|Removal of deprecated features]]\\ RFC about removing legacy features in the next version of PHP * [[rfc:improved-parser-error-message|Improve parser error messages]]\\ Improve parser error message readability. * [[rfc:session_upload_progress|Session upload progress]]\\ Using sessions to provide upload progress feedback to users. * [[rfc:session-oo|Object oriented session handlers]]\\ A proposal to allow session_set_save_handler() to accept an object, and expose the original session handler. * [[rfc:allow_multiple_simultaneous_syslog_connections|Allow Multiple Simultaneous Syslog Connections]]\\ This RFC propose enhancement to syslog function in order to allow multiple simultaneous connections by using resources. * [[rfc:streammetadata|Stream meta-data]]\\ RFC defines handler for setting metadata on stream URL. * [[rfc:error-formatting-for-developers|Error message formatting for development]]\\ This RFC discusses error message formatting to aid developers. * [[rfc:performanceimprovements|Zend Engine Performance Improvements]]\\ Proposes Zend Engine changes which together make up to 20% performance improvement on synthetic benchmarks and some real-life applications * [[rfc:runtimecache|Run Time Cache]]\\ offers an implementation of run-time caching technique which may improve performance of repeatable code * [[rfc:zendsignals|Zend Signal Handling]]\\ Improve stability and speed when running under any forking SAPI by adding deferred signal handling to the Zend Engine. * [[rfc:dtrace|DTrace Probes for PHP]]\\ Provide DTrace probes for PHP. * [[rfc:new-output-api|New Output API]]\\ An RFC about the New Output API * [[rfc:callable|Callable type hint]]\\ Callable type hint * [[rfc:ldap_modify_batch|LDAP: Add ldap_modify_batch]] \\ This RFC proposes adding a lower-level modification function to the LDAP extension. ==== PHP 5.3 ==== * [[rfc:closures|Closures]]\\ This RFC proposes Closures and lambda functions for PHP. * [[rfc:namespaceresolution|Namespace resolution order]] * [[rfc:namespaceseparator|RFC on what namespace separator to choose]] * [[rfc:heredoc-with-double-quotes|HEREDOC with double quotes]]\\ This RFC is about allowing double quote syntax similar to single-quotes in NOWDOC as a HEREDOC syntax variant (in PHP 5.3) * [[rfc:lsb_parentself_forwarding|LSB parent::/self:: forwarding]]\\ Changes how parent:: and self:: work with LSB by making them forwarding. * [[rfc:calltimebyref|call_time_pass_by_reference]]\\ This RFC proposes that call_time_pass_by_reference be switched off by default in PHP 5.3. * [[rfc:e-user-deprecated-warning|New error level E_USER_DEPRECATED]] \\ This RFC proposes to introduce a new userspace error level similar to E_DEPRECATED for user level deprecation warnings * [[rfc:rounding|Rounding in PHP]]\\ Make round() produce predictable results on all platforms and fix some problems in the process. * [[rfc:autoload_include|Alternative to include/require for autoloaders]]\\ This RFC aims to offer an alternative solution to the well known fopen() “hack” used in autoloaders in order to verify the existence of files inside the include path * [[rfc:fpm|FPM SAPI]]\\ This RFC discusses FPM SAPI and its inclusion to the core PHP distribution. * [[rfc:fpm:ini_syntax|FPM INI syntax]]\\ This RDV discusses the replacement of FPM configuration file from XML to INI. * [[rfc:newinis|New INI Files]]\\ A proposal for two new INI files which will replace the current INI's packaged with PHP. One focused on production deployments and the other focused on development deployments. * [[rfc:array_count_handlers|count_elements handler vs count()]]\\ Internal change to allow some optimization and add consistency. ===== Declined ===== * [[rfc:user_defined_session_serializer|User defined session serializer]] \\ Implement user defined session serializer interface (Created: 2016-11-17) * [[rfc:php_engine_constant|Add PHP Engine Identifier Constant]] (Created 2016/02/03) * [[rfc:add_validate_functions_to_filter|Add validation functions to filter module]] \\ Add functions suitable for input validations. (Created 2016-08-03) * [[rfc:escaping_operator|New operator for context-dependent escaping]] \\ New operator for HTML escaping and other contexts. (Created 2016-07-14) * [[rfc:session-use-strict-mode|Enable session.use_strict_mode by default]] \\ Enable session.use_strict_mode by default. (Created 2016-07-05) * ''[[rfc:var_type|var_type()]]'' \\ Successor for ''gettype()'' function (Created: 2016-06-25) * ''[[rfc:var_info|var_info()]]'' \\ Extended version of ''var_type()'' function (Created: 2016-06-26) * [[rfc:ReflectionTypeImprovements]] \\ Improve ReflectionType's support for nullable and named types. * [[rfc:typed-properties|Typed Properties]] \\ Allow class properties to be typed (Created 2016-03-16) * [[rfc:union_types|Union Types]]\\ A proposal to add union types (Discussion began 2016-04-13) * [[rfc:callable-types|Callable prototypes]] \\ Callable prototypes (Created 2015-08-27) * [[rfc:functional-interfaces|Functional Interfaces]] \\ Functional Interfaces (Created 2016-04-17) * [[rfc:attributes|PHP Attributes]] \\ Native support for annotation (Discussion began 2016-04-22) * [[rfc:var_deprecation|''var'' Deprecation]] \\ Deprecating ''var'' in favor of ''public'' (Created 2016-03-10) * [[rfc:precise_session_management|Precise Session Management]]\\ Make session management precise. (Created 2015/03/21 ) * [[rfc:number_format_separator|Number Format Separator]] \\ Enable for numerical literals to be formatted for better readability (Created 2015-12-20) * [[rfc:json_numeric_as_string|JSON numeric as string]]\\ Proposes new options for dealing with the JSON number conversion problem by converting data to string. * [[rfc:in_operator|In Operator]] \\ This RFC proposes a new operator for contains checks. * [[rfc:coercive_sth|Coercive Scalar Type Hints]]\\ A proposal to add user-land coercive scalar type hints, and change internal function behavior to align with them (Created 2015-02-21) * [[rfc:variadic_empty|Make empty() a Variadic]]\\ A proposal to make empty() accept any number of arguments (Created 2015-02-20) * [[rfc:error_handler_callback_parameters_passed_by_reference|Allow error_handler callback parameters to be passed by reference]] \\ (Created 2015-01-26) * [[rfc:pecl_http|pecl_http]]\\ Whether to add pecl_http v2 to the core * [[rfc:skipparams|Skipping optional parameters]] \\ Skipping optional parameters in function calls (Created 2012-04-13) * [[rfc:php57|PHP 5.7]] \\ Proposes a final minor version of PHP 5, PHP 5.7, with no new features but added deprecation notices. (Created 2014-12-15) * [[rfc:objkey|Using objects as keys]]\\ Allows to use objects as keys for arrays. (Created 2014-10-26) * [[rfc:abstract_final_class|Abstract final classes / Static classes]]\\ Language enhancement to support "abstract final classes" or "static classes". (Created 2014-11-26) * [[rfc:aliases_by_reflection|Access to aliases definition by reflection]] \\ Extends reflection for a getDefinedAliases() methods. (Created 2014/10/09) * [[rfc:safe_cast|Safe Casting Functions]]\\ Adds a set of safe casting functions for scalar types (Created 2014-10-21) * [[rfc:loop_or|Loop + or control structure]]\\ Adds a default block to loops to be executed in the event that the loop is never entered. * [[rfc:bare_name_array_literal|Bare Name Array Literal]]\\ A shorter new syntax for array key-value pairs (Created 2014-06-01) * [[rfc:bare_name_array_dereference|Bare Name Array Dereference]]\\ A shorter new syntax for dereferencing arrays with string keys (Created 2014-06-01) * [[rfc:arrayof|Array Of]]\\ Proposed syntax for Type-Hinting against the contents or an array (Created 2014/01/15) * [[rfc:secure-html-escape|Improve HTML escape]]\\ This RFC proposes more secure HTML escape by escaping "/" (Vote period: 2014/02/16 - 2014/02/22) (Created 2014/02/02) * [[rfc:multibyte_char_handling|Multibyte Char Handling]]\\ This RFC proposes the way to handle multibyte chars. (Created 2014/01/16) * [[rfc:altmbstring|Alternative mbstring implementation using ICU]]\\ A proposal to completely rewrite mbstring extension with ICU. (Created 2011/04/06) * [[rfc:size_t_and_int64|64 bit platform improvements for string length and integer]]\\ Integer and String modifications for full 64 bit support * [[rfc:alpanumeric_decrement|Alphanumeric Decrement]]\\ This will add support for decrementing alphanumeric strings (“ab”, for example) to complement the existing incrementing behaviour. (Created 2013/12/16) * [[rfc:engine_exceptions|Exceptions in the engine]]\\ This RFC proposes to allow the use of exceptions in the engine. (Postponed to PHP 6.) * [[rfc:keywords_as_identifiers|Extended keyword support]]\\ This RFC proposes to widen keyword support. * [[rfc:instance_counter|Class instances counter]]\\ This RFC proposes a new function returning a list with class names and their instance counter. * [[rfc:trailing-comma-function-args]]\\ Allow a trailing comma in function calls, similar to array declarations * [[rfc:array_part|Add an array_part() function]]\\ Adds a function to extract multi-dimensional slices * [[rfc:splclassloader|SplClassLoader]]\\ Merge implementation of first proposal of PHP Standards Recommendation (PSR) into SPL core * [[rfc:annotations|Annotations]]\\ Class Metadata feature (aka Annotations) support in PHP * [[rfc:ifsetor|ifsetor() Operator]]\\ This RFC proposes an operator that efficiently implements (isset($foo) ? $foo : $bar) as ifsetor($foo, $bar) * [[http://marc.info/?l=php-internals&m=121397217528280&w=2|Method overloading]] * [[rfc:NonBreakableTraits|Non-breakable Traits]]\\ This RFC is a extension to the basic proposal. It includes the notion of trait-local methods and properties. * [[rfc:functiongetentropy|Function getEntropy]]\\ Feature request for a new userspace function providing a truly random value. * [[rfc:propertygetsetsyntax-v1.2|Property Accessors Syntax]]\\ RFC for the addition of C#-style get/set accessors to PHP * [[rfc:propertygetsetsyntax-alternative-typehinting-syntax|Alternative typehinting syntax for accessors]]\\ Proposes an improved typehinting syntax for the accessors proposal. * [[rfc:automatic_property_initialization|Automatic Property Initialization]]\\ This RFC proposes automatic assignments of constructor arguments to properties. (Created 2013/09/27) * [[rfc:default_ctor|Default parent constructors]] \\ The RFC proposes that the parent constructors, destructors and clone operations were always callable even if not defined in parent class. (Created 2014-11-05) ===== Withdrawn ===== * [[rfc:use-php_mt_rand|Use php_mt_rand() where php_rand() is used]]\\ This RFC proposes replacing php_rand() function to php_mt_rand(). (Created 2014-07-17) * [[rfc:revisit-trailing-comma-function-args|Revisit trailing commas in function arguments]]\\ Revisit trailing commas in function arguments (Created 2015-10-07) * [[rfc:short_closures|Short Closures (''~>'' operator)]] \\ This RFC proposes an operator for shorter Closures. * [[rfc:reflectionparameter-getclassname| ReflectionParameter::getClassName()]] \\ Add reflection method to access to a class name in a type hint (Created 2015-01-30) * [[rfc:bigint|Big Integer Support]]\\ Adds Big Integer support to PHP (Created 2014-06-20) * [[rfc:scalar_type_hints|Scalar Type Hints]] \\ Adds four type hints for scalar types. (Created 2014-12-14) * [[rfc:deprecate-ini-functions|Deprecate function that modify INI]]\\ There are number of functions that modify INI value. Let them deprecate and use ini_get()/ini_set(). (Other RFC is proposed) * [[rfc:sync|pecl_sync]]\\ Whether PHP should support locking mechanism on its core * [[rfc:function_referencing|Function Referencing as Closures]]\\ Proposes a new syntax to allow referencing functions and methods as closures * [[rfc:readonly_properties|Readonly Properties]]\\ Adds a ''readonly'' specifier to make properties writeable within a class, but only readable from outside (Created 2014-10-24) * [[rfc:strict_argcount|Strict Argument Count On Function Calls]] \\ This RFC proposes to sensibly add a strict argument count check for function calls on PHP7 (Created 2015-02-20) * [[rfc:scalar_type_hinting_with_cast|Add scalar type hinting with casts]]\\ This RFC proposes adding scalar type hinting with casting to provide more robust parameter hinting. (Re-opened 2014-07-13) * [[rfc:session-read_only-lazy_write|Sessions: Improve original RFC about lazy_write]]\\ An attempt at redesigning the accepted solution from [[rfc:session-lock-ini]]. * [[rfc:gmp_number|Make GMP number work like PHP number]]\\ Make compatible PHP number * [[rfc:const_scalar_expressions2|Constant Scalar Expressions (re-opening)]]\\ This RFC proposes adding support for Constant Scalar Expressions. * [[rfc:function_autoloading|Function Autoloading]]\\ This RFC proposes to refactor the existing autoloading mechanism to support function and constant autoloading. * [[rfc:protocol_type_hinting|Structural Type Hinting]]\\ This RFC proposes a new type-hint format to allow run-time checking of Structural Types. * [[rfc:const_scalar_expressions|Constant Scalar Expressions]]\\ This RFC proposes adding support for Constant Scalar Expressions. * [[rfc:request-tempnam|Modify tempnam() to handle directories and auto-cleanup]]\\ Add TEMPNAM_DIR and TEMPNAM_REQUEST options to tempnam() * [[rfc:parameter_type_casting_hints|Parameter Type Casting Hints]]\\ This RFC proposes adding type casting hints to function declarations. * [[rfc:voting_who|Who can vote?]]\\ Define the participants of the voting process. * [[rfc:magicquotes_finale|Magic Quotes in PHP, the Finalé]]\\ A safe, orderly manner for getting rid of Magic Quotes. * [[rfc:returntypehint2|Return value type hint]]\\ Return type hinting * [[rfc:object_cast_magic|Cast and Assign Magic Methods]]\\ Feature request to expose object_cast, get and set to PHP land code via two new magic methods * [[rfc:mysqlnd_localhost_override|Add mysqlnd.localhost_override option]]\\ This RFC proposes to add mysqlnd.localhost_override to more easily override localhost when connecting to a MySQL database. * [[rfc:useas|Allow use T_AS in closure use statement]]\\ Allow user use a alias name for lexical variable of closure * [[rfc:strncmpnegativelen|strn(case)cmp supporting a negative length as its third paramter]]\\ This extends PHP's string function strn(case)cmp to support a negative length as parameter * [[rfc:nested_classes|Nested Class Support]]\\ This RFC proposes support for nested classes, following on from Anonymous Classes. * [[rfc:jsonserializable | Extending the JsonSerializable interface]] \\ This RFC aims to allow creation of an object through JSON (Created 2015-07-13) * [[rfc:array-to-string|Improve array to string conversion]] \\ Proposes alternative behaviors for array to string zval conversion. (Created 2015/01/10) * [[rfc:intl.charset-detector|IntlCharsetDetector]] \\ Wrap ICU's UCharsetDetector (Created: 2016-04-11) ===== Inactive ===== This section is for RFCs that have been deferred, obsoleted, or appear to have been abandoned. Sorry if your RFC is added here and you feel it is still active; please move it back to the appropriate section. * [[rfc:basic_scalar_types|Basic Scalar Types]]\\ A RFC proposing pure scalar types (Created 2015-03-11) * [[rfc:peclversioning|PECL versioning]]\\ This RFC, about tackling the versioning issues in PECL extensions, has been implemented across PECL for several months. But what should be done about extension versioning in the PHP core? * [[rfc:protectedlookup|Improve consistency of protected member lookups]]\\ This RFC proposes to eliminate an inconsistency in the way protected class members are resolved. * [[rfc:drop_sql.safe_mode|Drop sql.safe_mode]]\\ Dropping a php.ini setting affecting two extensions * [[rfc:get-random|Get Random]]\\ This RFC talks about how to get a (better) random string in PHP * [[rfc:error-optimizations|Error optimizations]]\\ A way to optimize the formatting of our errors * [[rfc:autofunc|Function autoloading through spl_autoload*]]\\ This RFC introduces a potential implementation for function autoloading which would be consistent with what we have for autoloading classes. (Created 2011/08/05) * [[rfc:cli-strict|CLI options for strict and quiet modes]]\\ This RFC proposes a ''-W'' option to turn on maximum error reporting, and a ''-Q'' option for no error reporting. (Created 2011/07/05) * [[rfc:logicalshiftoperator|Add Logical Shift Operators]]\\ Add logical shift operators for bitwise shifting of strings (Created 2011/07/18) * [[rfc:grisu3-strtod|Faster strtod algorithm]]\\ This RFC proposes to add the Grisu3 strtod algorithm as an optional feature to PHP. (Created 2011/07/15) * [[rfc:isset-set-operator|Isset Set Operator]]\\ This RFC proposes new operators for handling unset/falsey variables. * [[rfc:object_cast_to_types|Scalar Type Casting Magic Methods]]\\ This RFC proposes a set of new scalar type casting magic methods for classes. * [[rfc:docblockparser|docBlock Parser]]\\ Proposal to add docBlock parsing to the Reflection extension * [[rfc:annotations-in-docblock|Annotations in doc block]]\\ Class Metadata feature (aka Annotations) support in PHP through DocBlock * [[rfc:objectarrayliterals|Object and Array Literals]]\\ This RFC proposes first-class, inline object and array literals similar to JSON. * [[rfc:weakreferences|Weak References]]\\ This RFC proposes the introduction of Weak References in PHP via a new SPL class. * [[rfc:pdov1|PDO Version 1 Improvements]]\\ This RFC proposes a set of improvements to be made to PDO. * [[rfc:taint|Tainted variables]]\\ This RFC proposes an implementation of variable tainting in PHP. * [[rfc:static-classes|Static classes]]\\ This RFC proposes the introduction of static classes for PHP * [[rfc:class_casting_to_scalar|class casting to scalar]]\\ This RFC proposes a way to do like __toString(), for other scalar types * [[rfc:autodefine|Autodefinition]]\\ This RFC proposes the ability to define missing definitions (generalization of autoload). * [[rfc:linecontrol|Line Markers in PHP]]\\ This RFC proposes the introduction of line markers in PHP. * [[rfc:autoboxing|Autoboxing]]\\ Autoboxing feature in PHP * [[rfc:socketactivation|Systemd socket activation]]\\ Systemd socket activation support for PHP-FPM (Created 2012/10/18) * [[rfc:deprecated-modifier|Add a deprecated modifier for functions]]\\ Add a deprecated modifier for functions (Created 2012/12/25) * [[rfc:prototype_checks|Clarifying/Improving the prototype checks]]\\ This RFC discusses the current state of prototype checks, and gives some directions for discussion and improvement. (Created 2011/09/19) * [[rfc:jenkins|Introducing Jenkins]]\\ This RFC proposes using Jenkins as a Continuous Ingtegration environment for the php project. (Created 2011/11/01) * [[rfc:anonymous_catch|Support for anonymous catch-statements]]\\ This RFC proposes adding catch-statements without variables, and fully anonymous catches. (Created 2013/06/25) * [[rfc:errors_as_exceptions|Errors as Exceptions]]\\ This RFC discusses the conversion of errors to exceptions (Created 2011/04/06) * [[rfc:traitsmodifications|Proposed modifications to traits]]\\ This RFC proposes three modifications to traits: increasing separation and consistency of inheritance vs. trait composition, adding trait-local scope, and extending ''use'' syntax. (Created 2011/04/06) * [[rfc:datetime_tostring|Add toString to DateTime]]\\ A proposal to add toString to DateTime (Created 2012/09/01) * [[rfc:propertygetsetsyntax-as-implemented|Property get/set syntax]]\\ This RFC proposes to add a C# style property get/set syntax to PHP classes. (Created 2011-12-21 - document index) * [[rfc:optional-t-function|Make T_FUNCTION in method declarations optional.]]\\ A proposal for removing the requirement to use T_FUNCTION in method declarations. (Created 2011/04/06) * [[rfc:jsonable|Jsonable interface]]\\ Feature request to allow support json_(encode|decode) to handle Object instance conversions. * [[rfc:extensionsiberia|Siberia]]\\ This RFC proposes to create a cemetery for dead extensions (PECL or core). * [[rfc:array_delete|array_delete]]\\ This RFC proposes adding array_delete() as an intuitive API for array element deletion. (Created 2012/08/22) * [[rfc:enhanced_error_handling|Enhanced Error Handling]]\\ This offers a concept and implementation to let the user (php coder) choose between php_error, exception et al while retaining backwards compatibility (Created 2009/12/27) * [[rfc:typechecking|Parameter (and Return) value type hints/checks]]\\ Several RFC that propose to complete the actual parameter type hints/checks (and an implementation for return value type hints). (Created 2009/07/03) * [[rfc:tls|Native TLS in ZTS]]\\ Improving performance of ZTS builds by using native thread local storage. (Created 2008/08/24) * [[rfc:better_benchmarks|Better benchmarks for PHP]]\\ A proposal for replacing current bench.php benchmarking script. (Created 2009/04/03) * [[rfc:remove_zend_api|Remove reliance of Zend API]]\\ A proposal to remove the use of the Zend API in PHP libraries. (Created 2009/03/29) * [[rfc:php_native_interface|PHP Native Interface]]\\ Provide complete alternative to writing libraries interfaces using the Zend API libraries. (Created 2009/04/05) * [[rfc:fcallfcall|Function call chaining]]\\ Function call chaining implementation. (Created 2010/01/30) * [[rfc:source_files_without_opening_tag|Source files without opening tag]]\\ This RFC proposes a way to support source code files without tag. * [[rfc:namedparameters|Named Parameters (obsolete)]]\\ Dummy RFC for named parameters, superseded by [[rfc:named_params|Named Parameters]]. * [[rfc:lemon|Lemon as a language parser]]\\ This RFC discusses the switch from YACC/Bison to lemon for the main language parser * [[rfc:ast_based_parsing_compilation_process|Moving to an AST-based parsing/compilation process (obsolete)]]\\ Proposal for AST-based compilation process. Superseded by the [[rfc:abstract_syntax_tree|Astract Syntax Tree RFC]]. (Created 2012/09/04) ===== Obsolete ===== * [[rfc:deprecate_mcrypt_rand|Deprecate MCRYPT_RAND]] \\ This RFC proposes the deprecation of MCRYPT_RAND in favor of selecting cryptographically secure pseudo-random number generators.