PHP RFC: Deprecate mb_ereg_replace eval option


This RFC aims at deprecating the e option that mb_ereg_replace and mb_eregi_replace provide.


The e option evaluates arbitrary PHP code it can easily be exploited if user input is not carefully validated or sanitized.

Didn't we already do that?

No. Around 4 years ago a RFC was passed to deprecate a similar options in preg_replace. This was executed in PHP 5.5 (deprecation) respectively PHP 7 (removal). That a similar option is present in mb_ereg_replace was apparently overlooked.


Emit an E_DEPRECATED error whenever mb_ereg_replace or mb_eregi_replace is called with the e option.

Backward Incompatible Changes

Once the feature is actually removed, any code relying on it will break. Whether silently or with an error will be left to decide in the removal RFC.

The suggested replacement, mb_ereg_replace_callback is has only been available since PHP 5.4.1. Projects which support both PHP 5.3 and PHP 7.1 may need two code paths to avoid deprecation warnings.

There is no mb_eregi_replace_callback function. Code using it will have to be converted to use mb_ereg_replace_callback with the i option.

Future Scope

The removal of this feature is not part of this RFC. This should be done, when a release, where this is possible, is actually on the agenda.

Proposed Voting Choices

Should an E_DEPRECATED error be emitted whenever mb_ereg_replace or mb_eregi_replace is called with the e option?

This vote will require a 50%+1 majority.

Voting opened on January 28th 2016, to close on February 4th.

Deprecate mb_ereg_replace eval option
Real name Yes No
aharvey (aharvey)  
ajf (ajf)  
bishop (bishop)  
colinodell (colinodell)  
danack (danack)  
fa (fa)  
gasolwu (gasolwu)  
guilhermeblanco (guilhermeblanco)  
jhdxr (jhdxr)  
leigh (leigh)  
levim (levim)  
mightyuhu (mightyuhu)  
nikic (nikic)  
ocramius (ocramius)  
pmjones (pmjones)  
ryat (ryat)  
sammyk (sammyk)  
stas (stas)  
tpunt (tpunt)  
Final result: 19 0
This poll has been closed.

Patches and Tests

A patch is available: <https://github.com/php/php-src/pull/1994> (merged).


rfc/deprecate_mb_ereg_replace_eval_option.txt · Last modified: 2017/09/22 13:28 by