PHP 7.0 升级备注，php7.0升级备注-php手册-php.cn

PHP 7.0 升级备注，php7.0升级备注

PHP 7.0.0 beta1 发布了，在带来了引人注目的性能提升的同时，也带来了不少语言特性方面的改变。以下由 LCTT 翻译自对官方的升级备注，虽然目前还不是正式发布版，不过想必距离正式发布的特性已经差别不大了。（本文会持续追踪更新）

1. 向后不兼容的变化

语言变化

变量处理的变化

间接变量、属性和方法引用现在以从左到右的语义进行解释。一些例子：
1. $$foo['bar']['baz'] // 解释做 ($$foo)['bar']['baz'] 
2. $foo->$bar['baz'] // 解释做 ($foo->$bar)['baz']
3. $foo->$bar['baz']() // 解释做 ($foo->$bar)['baz']()
4. Foo::$bar['baz']() // 解释做 (Foo::$bar)['baz']()
要恢复以前的行为，需要显式地加大括号：
1. ${$foo['bar']['baz']}
2. $foo->{$bar['baz']}
3. $foo->{$bar['baz']}()
4. Foo::{$bar['baz']}()
全局关键字现在只接受简单变量。像以前的
1. global $$foo->bar;
现在要求如下写法：
1. global ${$foo->bar};
变量或函数调用的前后加上括号不再有任何影响。例如下列代码，函数调用结果以引用的方式传给一个函数
1. function getArray() { return [1, 2, 3]; }
3. $last = array_pop(getArray());
4. // Strict Standards: 只有变量可以用引用方式传递
5. $last = array_pop((getArray()));
6. // Strict Standards: 只有变量可以用引用方式传递
现在无论是否使用括号，都会抛出一个严格标准错误。以前在第二种调用方式下不会有提示。
数组元素或对象属性自动安装引用顺序创建，现在的结果顺序将不同。例如：
1. $array = [];
2. $array["a"] =& $array["b"];
3. $array["b"] = 1;
4. var_dump($array);
现在结果是 ["a" => 1, "b" => 1]，而以前的结果是 ["b" => 1, "a" => 1]。

list() 的变化

list() 不再以反序赋值，例如：
1. list($array[], $array[], $array[]) = [1, 2, 3];
2. var_dump($array);
现在结果是 $array == [1, 2, 3] ，而不是 [3, 2, 1]。注意仅赋值顺序变化了，而赋值仍然一致（LCTT 译注：即以前的 list()行为是从后面的变量开始逐一赋值，这样对与上述用法就会产生 [3,2,1] 这样的结果了。）。例如，类似如下的常规用法
1. list($a, $b, $c) = [1, 2, 3];
2. // $a = 1; $b = 2; $c = 3;
仍然保持当前的行为。
不再允许对空的 list() 赋值。如下全是无效的：
1. list() = $a;
2. list(,,) = $a;
3. list($x, list(), $y) = $a;
list() 不再支持对字符串的拆分（以前也只在某些情况下支持）。如下代码：
1. $string = "xy";
2. list($x, $y) = $string;
现在的结果是： $x == null 和 $y == null （没有提示），而以前的结果是： $x == "x" 和 $y == "y" 。此外， list() 现在总是可以处理实现了 ArrayAccess 的对象，例如：
1. list($a, $b) = (object) new ArrayObject([0, 1]);
现在的结果是： $a == 0 和 $b == 1。以前 $a 和 $b 都是 null。

foreach 的变化

foreach() 迭代不再影响数组内部指针，数组指针可通过 current()/next() 等系列的函数访问。例如：
1. $array = [0, 1, 2];
2. foreach ($array as &$val) {
3.  var_dump(current($array));
4. }
现在将指向值 int(0) 三次。以前的输出是 int(1)、int(2) 和 bool(false)。
在对数组按值迭代时，foreach 总是在对数组副本进行操作，在迭代中任何对数组的操作都不会影响到迭代行为。例如：
1. $array = [0, 1, 2];
2. $ref =& $array; // Necessary to trigger the old behavior
3. foreach ($array as $val) {
4.  var_dump($val);
5.  unset($array[1]);
6. }
现在将打印出全部三个元素 (0 1 2)，而以前第二个元素 1 会跳过 (0 2)。
在对数组按引用迭代时，对数组的修改将继续会影响到迭代。不过，现在 PHP 在使用数字作为键时可以更好的维护数组内的位置。例如，在按引用迭代过程中添加数组元素：
1. $array = [0];
2. foreach ($array as &$val) {
3.  var_dump($val);
4.  $array[1] = 1;
5. }
现在迭代会正确的添加了元素。如上代码输出是 "int(0) int(1)"，而以前只是 "int(0)"。
对普通（不可遍历的）对象按值或按引用迭代的行为类似于对数组进行按引用迭代。这符合以前的行为，除了如上一点所述的更精确的位置管理的改进。
对可遍历对象的迭代行为保持不变。

相关 RFC: https://wiki.php.net/rfc/php7_foreach

参数处理的变化

不能定义两个同名的函数参数。例如，下面的方法将会触发编译时错误：
1. public function foo($a, $b, $unused, $unused) {
2.  // ...
3. }
如上的代码应该修改使用不同的参数名，如：
1. public function foo($a, $b, $unused1, $unused2) {
2.  // ...
3. }
func_get_arg() 和 func_get_args() 函数不再返回传递给参数的原始值，而是返回其当前值（也许会被修改）。例如：
1. function foo($x) {
2.  $x++;
3.  var_dump(func_get_arg(0));
4. }
5. foo(1);
将会打印 "2" 而不是 "1"。代码应该改成仅在调用 func_get_arg(s) 后进行修改操作。
1. function foo($x) {
2.  var_dump(func_get_arg(0));
3.  $x++;
4. }
或者应该避免修改参数：
1. function foo($x) {
2.  $newX = $x + 1;
3.  var_dump(func_get_arg(0));
4. }
类似的，异常回溯也不再显示传递给函数的原始值，而是修改后的值。例如：
1. function foo($x) {
2.  $x = 42;
3.  throw new Exception;
4. }
5. foo("string");
现在堆栈跟踪的结果是：
1. Stack trace:
2. #0 file.php(4): foo(42)
3. #1 {main}
而以前是：
1. Stack trace:
2. #0 file.php(4): foo('string')
3. #1 {main}
这并不会影响到你的代码的运行时行为，值得注意的是在调试时会有所不同。

同样的限制也会影响到 debug_backtrace() 及其它检查函数参数的函数。

整数处理的变化

无效的八进制表示（包含大于7的数字）现在会产生编译错误。例如，下列代码不再有效：
1. $i = 0781; // 8 不是一个有效的八进制数字！
以前，无效的数字（以及无效数字后的任何数字）会简单的忽略。以前如上 $i 的值是 7，因为后两位数字会被悄悄丢弃。
二进制以负数镜像位移现在会抛出一个算术错误：
1. var_dump(1 >> -1);
2. // ArithmeticError: 以负数进行位移
向左位移的位数超出了整型宽度时，结果总是 0。
1. var_dump(1 64); // int(0)
以前上述代码的结果依赖于所用的 CPU 架构。例如，在 x86（包括 x86-64）上结果是 int(1)，因为其位移操作数在范围内。
类似的，向右位移的位数超出了整型宽度时，其结果总是 0 或 -1 （依赖于符号）：
1. var_dump(1 >> 64); // int(0)
2. var_dump(-1 >> 64); // int(-1)

相关 RFC: https://wiki.php.net/rfc/integer_semantics

字符串处理的变化

包含十六进制数字的字符串不会再被当做数字，也不会被特殊处理。参见例子中的新行为：
1. var_dump("0x123" == "291"); // bool(false) (以前是 true)
2. var_dump(is_numeric("0x123")); // bool(false) (以前是 true)
3. var_dump("0xe" + "0x1"); // int(0) (以前是 16)
5. var_dump(substr("foo", "0x1")); // string(3) "foo" (以前是 "oo")
6. // 注意：遇到了一个非正常格式的数字
filter_var() 可以用来检查一个字符串是否包含了十六进制数字，或这个字符串是否能转换为整数：
1. $str = "0xffff";
2. $int = filter_var($str, FILTER_VALIDATE_INT, FILTER_FLAG_ALLOW_HEX);
3. if (false === $int) {
4.  throw new Exception("Invalid integer!");
5. }
6. var_dump($int); // int(65535)
由于给双引号字符串和 HERE 文档增加了 Unicode 码点转义格式（Unicode Codepoint Escape Syntax），所以带有无效序列的 "\u{" 现在会造成错误：
1. $str = "\u{xyz}"; // 致命错误：无效的 UTF-8 码点转义序列
要避免这种情况，需要转义开头的反斜杠：
1. $str = "\\u{xyz}"; // 正确
不过，不跟随 { 的 "\u" 不受影响。如下代码不会生成错误，和前面的一样工作：
1. $str = "\u202e"; // 正确

错误处理的变化

现在有两个异常类： Exception 和 Error 。这两个类都实现了一个新接口： Throwable 。在异常处理代码中的类型指示也许需要修改来处理这种情况。
一些致命错误和可恢复的致命错误现在改为抛出一个 Error 。由于 Error 是一个独立于 Exception 的类，这些异常不会被已有的 try/catch 块捕获。

可恢复的致命错误被转换为一个异常，所以它们不能在错误处理里面悄悄的忽略。部分情况下，类型指示失败不再能忽略。
解析错误现在会生成一个 Error 扩展的 ParseError 。除了以前的基于返回值 / errorgetlast() 的处理，对某些可能无效的代码的 eval() 的错误处理应该改为捕获 ParseError 。
内部类的构造函数在失败时总是会抛出一个异常。以前一些构造函数会返回 NULL 或一个不可用的对象。
一些 E_STRICT 提示的错误级别改变了。

其它的语言变化

静态调用一个不兼容的 $this 上下文的非静态调用的做法不再支持。这种情况下，$this 是没有定义的，但是对它的调用是允许的，并带有一个废弃提示。例子：
1. class A {
2. public function test() { var_dump($this); }
3. }
5. // 注意：没有从类 A 进行扩展
6. class B {
7. public function callNonStaticMethodOfA() { A::test(); }
8. }
10. (new B)->callNonStaticMethodOfA();
12. // 废弃：非静态方法 A::test() 不应该被静态调用
13. // 提示：未定义的变量 $this
14. NULL
注意，这仅出现在来自不兼容上下文的调用上。如果类 B 扩展自类 A ，调用会被允许，没有任何提示。
不能使用下列类名、接口名和特殊名（大小写敏感）：
1. bool
2. int
3. float
4. string
5. null
6. false
7. true
这用于 class/interface/trait 声明、 class_alias() 和 use 语句中。

此外，下列类名、接口名和特殊名保留做将来使用，但是使用时尚不会抛出错误：
1. resource
2. object
3. mixed
4. numeric
yield 语句结构当用在一个表达式上下文时，不再要求括号。它现在是一个优先级在 “print” 和 “=>” 之间的右结合操作符。在某些情况下这会导致不同的行为，例如：
1. echo yield -1;
2. // 以前被解释如下
3. echo (yield) - 1;
4. // 现在被解释如下
5. echo yield (-1);
7. yield $foo or die;
8. // 以前被解释如下
9. yield ($foo or die);
10. // 现在被解释如下
11. (yield $foo) or die;
这种情况可以通过增加括号来解决。
移除了 ASP () 标签。

RFC: https://wiki.php.net/rfc/remove_alternative_php_tags
不支持以引用的方式对 new 的结果赋值。
不支持对一个来自非兼容的 $this 上下文的非静态方法的域内调用。细节参见： https://wiki.php.net/rfc/incompat_ctx 。
不支持 ini 文件中的 # 风格的备注。使用 ; 风格的备注替代。
$HTTP_RAW_POST_DATA 不再可用，使用 php://input 流替代。

标准库的变化

call_user_method() 和 call_user_method_array() 不再存在。
在一个输出缓冲区被创建在输出缓冲处理器里时， ob_start() 不再发出 E_ERROR，而是 E_RECOVERABLE_ERROR。
改进的 zend_qsort （使用 hybrid 排序算法）性能更好，并改名为 zend_sort。
增加静态排序算法 zend_insert_sort。
移除 fpm-fcgi 的 dl() 函数。
setcookie() 如果 cookie 名为空会触发一个 WARNING ，而不是发出一个空的 set-cookie 头。

其它

Curl:
- 去除对禁用 CURLOPT_SAFE_UPLOAD 选项的支持。所有的 curl 文件上载必须使用 curl_file / CURLFile API。
Date:
- 从 mktime() 和 gmmktime() 中移除 $is_dst 参数
DBA
- 如果键也没有出现在 inifile 处理器中，dba_delete() 现在会返回 false。
GMP
- 现在要求 libgmp 版本 4.2 或更新。
- gmp_setbit() 和 gmp_clrbit() 对于负指标返回 FALSE，和其它的 GMP 函数一致。
Intl:
- 移除废弃的别名 datefmt_set_timezone_id() 和 IntlDateFormatter::setTimeZoneID()。替代使用 datefmt_set_timezone() 和 IntlDateFormatter::setTimeZone()。
libxml:
- 增加 LIBXML_BIGLINES 解析器选项。从 libxml 2.9.0 开始可用，并增加了在错误报告中行号大于 16 位的支持。
Mcrypt
- 移除等同于 mcrypt_generic_deinit() 的废弃别名 mcrypt_generic_end()。
- 移除废弃的 mcrypt_ecb()、 mcrypt_cbc()、 mcrypt_cfb() 和 mcrypt_ofb() 函数，它们等同于使用 MCRYPT_MODE_* 标志的 mcrypt_encrypt() 和 mcrypt_decrypt() 。
Session
- session_start() 以数组方式接受所有的 INI 设置。例如， ['cache_limiter'=>'private'] 会设置 session.cache_limiter=private 。也支持 'read_and_close' 以在读取数据后立即关闭会话数据。
- 会话保存处理器接受使用 validate_sid() 和 update_timestamp() 来校验会话 ID 是否存在、更新会话时间戳。对旧式的用户定义的会话保存处理器继续兼容。
- 增加了 SessionUpdateTimestampHandlerInterface 。 validateSid()、 updateTimestamp() 定义在接口里面。
- session.lazy_write(默认是 On) 的 INI 设置支持仅在会话数据更新时写入。
Opcache
- 移除 opcache.load_comments 配置语句。现在文件内备注载入无成本，并且总是启用的。
OpenSSL:
- 移除 "rsa_key_size" SSL 上下文选项，按给出的协商的加密算法自动设置适当的大小。
- 移除 "CN_match" 和 "SNI_server_name" SSL 上下文选项。使用自动侦测或 "peer_name" 选项替代。
PCRE:
- 移除对 /e (PREG_REPLACE_EVAL) 修饰符的支持，使用 preg_replace_callback() 替代。
PDO_pgsql:
- 移除 PGSQL_ATTR_DISABLE_NATIVE_PREPARED_STATEMENT 属性，等同于 ATTR_EMULATE_PREPARES。
Standard:
- 移除 setlocale() 中的字符串类目支持。使用 LC_* 常量替代。 instead.
- 移除 set_magic_quotes_runtime() 及其别名 magic_quotes_runtime()。
JSON:
- 拒绝 json_decode 中的 RFC 7159 不兼容数字格式 - 顶层 (07, 0xff, .1, -.1) 和所有层的 ([1.], [1.e1])
- 用一个参数调用 json_decode 等价于用空的 PHP 字符串或值调用，转换为空字符串（NULL, FALSE）的结果是 JSON 格式错误。
Stream:
- 移除 set_socket_blocking() ，等同于其别名 stream_set_blocking()。
XSL:
- 移除 xsl.security_prefs ini 选项，使用 XsltProcessor::setSecurityPrefs() 替代。

2. 新功能

Core
- 增加了组式 use 声明。 (RFC: https://wiki.php.net/rfc/group_use_declarations)
- 增加了 null 合并操作符 (??)。 (RFC: https://wiki.php.net/rfc/isset_ternary)
- 在 64 位架构上支持长度 >= 2³¹ 字节的字符串。
- 增加了 Closure::call() 方法（仅工作在用户侧的类）。
- 在双引号字符串和 here 文档中增加了 \u{xxxxxx} Unicode 码点转义格式。
- define() 现在支持数组作为常量值，修复了一个当 define() 还不支持数组常量值时的疏忽。
- 增加了比较操作符 ()，即太空船操作符。 (RFC: https://wiki.php.net/rfc/combined-comparison-operator)
- 为委托生成器添加了类似协程的 yield from 操作符。 (RFC: https://wiki.php.net/rfc/generator-delegation)
- 保留的关键字现在可以用在几种新的上下文中。 (RFC: https://wiki.php.net/rfc/context_sensitive_lexer)
- 增加了标量类型的声明支持，并可以使用 declare(strict_types=1) 的声明严格模式。 (RFC:https://wiki.php.net/rfc/scalar_type_hints_v5)
- 增加了对加密级安全的用户侧的随机数发生器的支持。 (RFC: https://wiki.php.net/rfc/easy_userland_csprng)
Opcache
- 增加了基于文件的二级 opcode 缓存（实验性——默认禁用）。要启用它，PHP 需要使用 --enable-opcache-file 配置和构建，然后 opcache.file_cache= 配置指令就可以设置在 php.ini 中。二级缓存也许可以提升服务器重启或 SHM 重置时的性能。此外，也可以设置 opcache.file_cache_only=1 来使用文件缓存而根本不用 SHM（也许对于共享主机有用）；设置 opcache.file_cache_consistency_checks=0 来禁用文件缓存一致性检查，以加速载入过程，有安全风险。
OpenSSL
- 当用 OpenSSL 1.0.2 及更新构建时，增加了 "alpn_protocols" SSL 上下文选项来允许加密的客户端/服务器流使用 ALPN TLS 扩展去协商替代的协议。协商后的协议信息可以通过 stream_get_meta_data() 输出访问。
Reflection
- 增加了一个 ReflectionGenerator 类（yield from Traces，当前文件/行等等）。
- 增加了一个 ReflectionType 类来更好的支持新的返回类型和标量类型声明功能。新的 ReflectionParameter::getType() 和 ReflectionFunctionAbstract::getReturnType() 方法都返回一个 ReflectionType 实例。
Stream
- 添加了新的仅用于 Windows 的流上下文选项以允许阻塞管道读取。要启用该功能，当创建流上下文时，传递 array("pipe" => array("blocking" => true)) 。要注意的是，该选项会导致管道缓冲区的死锁，然而它在几个命令行场景中有用。

3. SAPI 模块的变化

FPM
- 修复错误 #65933 （不能设置超过1024字节的配置行）。
- Listen = port 现在监听在所有地址上（IPv6 和 IPv4 映射的）。

4. 废弃的功能

Core
- 废弃了 PHP 4 风格的构建函数（即构建函数名必须与类名相同）。
- 废弃了对非静态方法的静态调用。
OpenSSL
- 废弃了 "capture_session_meta" SSL 上下文选项。在流资源上活动的加密相关的元数据可以通过 stream_get_meta_data() 的返回值访问。

5. 函数的变化

parse_ini_file():
parse_ini_string():
- 添加了扫描模式 INISCANNERTYPED 来得到 yield 类型的 .ini 值。
unserialize():
- 给 unserialize 函数添加了第二个参数 (RFC: https://wiki.php.net/rfc/secure_unserialize) 来指定可接受的类： unserialize($foo, ["allowed_classes" => ["MyClass", "MyClass2"]]);
proc_open():
- 可以被 proc_open() 使用的最大管道数以前被硬编码地限制为 16。现在去除了这个限制，只受限于 PHP 的可用内存大小。
- 新添加的仅用于 Windows 的配置选项 "blocking_pipes" 可以用于强制阻塞对子进程管道的读取。这可以用于几种命令行应用场景，但是它会导致死锁。此外，这与新的流的管道上下文选项相关。
array_column():
- 该函数现在支持把对象数组当做二维数组。只有公开属性会被处理，对象里面使用 __get() 的动态属性必须也实现 __isset() 才行。
stream_context_create()
- 现在可以接受一个仅 Windows 可用的配置 array("pipe" => array("blocking" => )) 来强制阻塞管道读取。该选项应该小心使用，该平台有可能导致管道缓冲区的死锁。

6. 新函数

GMP
- 添加了 gmp_random_seed()。
PCRE:
- 添加了 preg_replace_callback_array 函数。 (RFC: https://wiki.php.net/rfc/preg_replace_callback_array)
Standard . 添加了整数除法 intdiv() 函数。 . 添加了重置错误状态的 error_clear_last() 函数。
Zlib: . 添加了 deflate_init()、 deflate_add()、 inflate_init()、 inflate_add() 函数来运行递增和流的压缩/解压。

7. 新的类和接口

（暂无）

8. 移除的扩展和 SAPI

sapi/aolserver
sapi/apache
sapi/apache_hooks
sapi/apache2filter
sapi/caudium
sapi/continuity
sapi/isapi
sapi/milter
sapi/nsapi
sapi/phttpd
sapi/pi3web
sapi/roxen
sapi/thttpd
sapi/tux
sapi/webjames
ext/mssql
ext/mysql
ext/sybase_ct
ext/ereg

更多细节参见：

https://wiki.php.net/rfc/removal_of_dead_sapis_and_exts
https://wiki.php.net/rfc/remove_deprecated_functionality_in_php7

注意：NSAPI 没有在 RFC 中投票，不过它会在以后移除。这就是说，它相关的 SDK 今后不可用。

9. 扩展的其它变化

Mhash
- Mhash 今后不是一个扩展了，使用 function_exists("mhash") 来检查器是否可用。

10. 新的全局常量

Core . 添加 PHP_INT_MIN
Zlib
- 添加的这些常量用于控制新的增量deflate_add() 和 inflate_add() 函数的刷新行为：
- ZLIB_NO_FLUSH
- ZLIB_PARTIAL_FLUSH
- ZLIB_SYNC_FLUSH
- ZLIB_FULL_FLUSH
- ZLIB_BLOCK
- ZLIB_FINISH
GD
- 移除了 T1Lib 支持，这样由于对 T1Lib 的可选依赖，如下将来不可用：
函数：
- imagepsbbox()
- imagepsencodefont()
- imagepsextendedfont()
- imagepsfreefont()
- imagepsloadfont()
- imagepsslantfont()
- imagepstext()
资源：
- 'gd PS font'
- 'gd PS encoding'

11. INI 文件处理的变化

Core
- 移除了 asp_tags ini 指令。如果启用它会导致致命错误。
- 移除了 always_populate_raw_post_data ini 指令。

12. Windows 支持

Core
- 在 64 位系统上支持原生的 64 位整数。
- 在 64 位系统上支持大文件。
- 支持 getrusage()。
ftp
- 所带的 ftp 扩展总是共享库的。
- 对于 SSL 支持，取消了对 openssl 扩展的依赖，取而代之仅依赖 openssl 库。如果在编译时需要，会自动启用 ftp_ssl_connect()。
odbc
- 所带的 odbc 扩展总是共享库的。

13. 其它变化

Core
- NaN 和 Infinity 转换为整数时总是 0，而不是未定义和平台相关的。
- 对非对象调用方法会触发一个可捕获错误，而不是致命错误；参见： https://wiki.php.net/rfc/catchable-call-to-member-of-non-object
- zend_parse_parameters、类型提示和转换，现在总是用 "integer" 和 "float"，而不是 "long" 和 "double"。
- 如果 ignore_user_abort 设置为 true ，对应中断的连接，输出缓存会继续工作。