Fix list() behavior inconsistency View as Markdown

Implemented (PHP 7.0)
Authors
Dmitry Stogov, dmitry@zend.com
Date
2014-09-11
Version
1.0
Source
wiki.php.net/rfc/fix_list_behavior_inconsistency

Vote

Fix list() behavior inconsistency? closed
don't fix
0
disable string handling in all cases
17
enable string handling in all cases
16
33 voters
ab enable string handling in all cases 2014-10-03 18:55
aharvey enable string handling in all cases 2014-09-25 16:58
ajf disable string handling in all cases 2014-09-25 08:48
auroraeosrose enable string handling in all cases 2014-09-26 16:31
bukka enable string handling in all cases 2014-09-29 21:37
bwoebi enable string handling in all cases 2014-09-25 09:58
datibbaw disable string handling in all cases 2014-09-25 08:53
daverandom enable string handling in all cases 2014-09-26 10:12
derick enable string handling in all cases 2014-09-25 09:19
dmitry enable string handling in all cases 2014-09-26 13:10
fmk enable string handling in all cases 2014-09-26 17:06
gwynne disable string handling in all cases 2014-09-26 08:15
hywan disable string handling in all cases 2014-09-26 09:09
jedibc disable string handling in all cases 2014-09-29 11:17
kalle disable string handling in all cases 2014-09-25 11:27
kassner disable string handling in all cases 2014-09-25 20:25
keyur disable string handling in all cases 2014-10-02 18:05
klaussilveira disable string handling in all cases 2014-10-03 00:44
krakjoe enable string handling in all cases 2014-09-27 15:02
laruence enable string handling in all cases 2014-09-25 07:47
leigh disable string handling in all cases 2014-09-25 07:56
levim enable string handling in all cases 2014-09-26 21:36
lstrojny disable string handling in all cases 2014-09-25 14:56
mbeccati disable string handling in all cases 2014-09-28 15:46
mike disable string handling in all cases 2014-09-26 07:18
nikic enable string handling in all cases 2014-09-25 09:28
pajoye disable string handling in all cases 2014-09-26 13:25
patrickallaert disable string handling in all cases 2014-09-29 09:41
pierrick enable string handling in all cases 2014-09-25 15:57
rasmus disable string handling in all cases 2014-10-01 02:40
rdlowrey enable string handling in all cases 2014-09-25 19:36
remi disable string handling in all cases 2014-09-25 15:37
stas enable string handling in all cases 2014-09-25 08:56

Discussions on the mailing list

[RFC] Fix list() behavior inconsistency
by Dmitry Stogov · 6 messages
[VOTE] Fix list() behavior inconsistency
by Dmitry Stogov · 37 messages

RFC text

Copied from wiki.php.net, last synchronized Oct 13, 2026 11:51 UTC

Introduction

According to PHP documentation list() construct doesn't work with strings. However in some cases it works.

$ php -r 'list($a,$b) = "aa";var_dump($a,$b);'
NULL
NULL
$ php -r '$a[0]="ab"; list($a,$b) = $a[0]; var_dump($a,$b);'
string(1) "a"
string(1) "b"

This behavior caused by implementation feature and wasn't made on purpose.

Proposal

Make list() behave with strings in consistent way. There are two options:

Disable string handling in all cases

This will disable undocumented feature and it may break some existing PHP code.

Enable string handling in all cases

This will make the following code work.

list($a,$b) = "str";

Instead of assignment NULL into $a and $b, it'll assign 's' and 't' characters. However, it also may break some existing PHP code.

Backward Incompatible Changes

Both options may affect existing PHP code.

Proposed PHP Version(s)

PHP7

Vote

This project requires a 2/3 majority, between first and second or third options.

Voting started on 2014-09-25 and ends 2014-10-02.

Vote: Fix list() behavior inconsistency? — don't fix: 0 · disable string handling in all cases: 17 · enable string handling in all cases: 16 (closed)

Implementation

Support for strings has been removed for all cases. Support for ArrayAccess has been added for all cases (previously it was not supported for temporary variables).

https://github.com/php/php-src/commit/7c7b9184b1fdf7add1715079f22241bc1185fcb0