PHP 7.0 升级备注

jopen 9年前

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

 PHP 7.0 升级备注

1. 向后不兼容的变化

语言变化

变量处理的变化

  • 间接变量、属性和方法引用现在以从左到右的语义进行解释。一些例子:

    $$foo['bar']['baz'] // 解释做 ($$foo)['bar']['baz']     $foo->$bar['baz']   // 解释做 ($foo->$bar)['baz']  $foo->$bar['baz']() // 解释做 ($foo->$bar)['baz']()  Foo::$bar['baz']()  // 解释做 (Foo::$bar)['baz']()

    要恢复以前的行为,需要显式地加大括号:

    ${$foo['bar']['baz']}  $foo->{$bar['baz']}  $foo->{$bar['baz']}()  Foo::{$bar['baz']}()
  • 全局关键字现在只接受简单变量。像以前的

    global $$foo->bar;

    现在要求如下写法:

    global ${$foo->bar};
  • 变量或函数调用的前后加上括号不再有任何影响。例如下列代码,函数调用结果以引用的方式传给一个函数

    function getArray() { return [1, 2, 3]; }    $last = array_pop(getArray());  // Strict Standards: 只有变量可以用引用方式传递  $last = array_pop((getArray()));  // Strict Standards: 只有变量可以用引用方式传递

    现在无论是否使用括号,都会抛出一个严格标准错误。以前在第二种调用方式下不会有提示。

  • 数组元素或对象属性自动安装引用顺序创建,现在的结果顺序将不同。例如:

    $array = [];  $array["a"] =& $array["b"];  $array["b"] = 1;  var_dump($array);

    现在结果是 ["a" => 1, "b" => 1],而以前的结果是 ["b" => 1, "a" => 1]。

相关的 RFC:

list() 的变化

  • list() 不再以反序赋值,例如:

    list($array[], $array[], $array[]) = [1, 2, 3];  var_dump($array);

    现在结果是 $array == [1, 2, 3] ,而不是 [3, 2, 1]。注意仅赋值顺序变化了,而赋值仍然一致(LCTT 译注:即以前的 list()行为是从后面的变量开始逐一赋值,这样对与上述用法就会产生 [3,2,1] 这样的结果了。)。例如,类似如下的常规用法

    list($a, $b, $c) = [1, 2, 3];  // $a = 1; $b = 2; $c = 3;

    仍然保持当前的行为。

  • 不再允许对空的 list() 赋值。如下全是无效的:

    list() = $a;  list(,,) = $a;  list($x, list(), $y) = $a;
  • list() 不再支持对字符串的拆分(以前也只在某些情况下支持)。如下代码:

    $string = "xy";  list($x, $y) = $string;

    现在的结果是: $x == null 和 $y == null (没有提示),而以前的结果是: $x == "x" 和 $y == "y" 。此外, list() 现在总是可以处理实现了 ArrayAccess 的对象,例如:

    list($a, $b) = (object) new ArrayObject([0, 1]);

    现在的结果是: $a == 0 和 $b == 1。 以前 $a 和 $b 都是 null。

相关 RFC:

foreach 的变化

  • foreach() 迭代不再影响数组内部指针,数组指针可通过 current()/next() 等系列的函数访问。例如:

    $array = [0, 1, 2];  foreach ($array as &$val) {      var_dump(current($array));  }

    现在将指向值 int(0) 三次。以前的输出是 int(1)、int(2) 和 bool(false)。

  • 在对数组按值迭代时,foreach 总是在对数组副本进行操作,在迭代中任何对数组的操作都不会影响到迭代行为。例如:

    $array = [0, 1, 2];  $ref =& $array; // Necessary to trigger the old behavior  foreach ($array as $val) {      var_dump($val);      unset($array[1]);  }

    现在将打印出全部三个元素 (0 1 2),而以前第二个元素 1 会跳过 (0 2)。

  • 在对数组按引用迭代时,对数组的修改将继续会影响到迭代。不过,现在 PHP 在使用数字作为键时可以更好的维护数组内的位置。例如,在按引用迭代过程中添加数组元素:

    $array = [0];  foreach ($array as &$val) {      var_dump($val);      $array[1] = 1;  }

    现在迭代会正确的添加了元素。如上代码输出是 "int(0) int(1)",而以前只是 "int(0)"。

  • 对普通(不可遍历的)对象按值或按引用迭代的行为类似于对数组进行按引用迭代。这符合以前的行为,除了如上一点所述的更精确的位置管理的改进。

  • 对可遍历对象的迭代行为保持不变。

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

参数处理的变化

  • 不能定义两个同名的函数参数。例如,下面的方法将会触发编译时错误:

    public function foo($a, $b, $unused, $unused) {      // ...  }

    如上的代码应该修改使用不同的参数名,如:

    public function foo($a, $b, $unused1, $unused2) {      // ...  }
  • func_get_arg() 和 func_get_args() 函数不再返回传递给参数的原始值,而是返回其当前值(也许会被修改)。例如:

    function foo($x) {      $x++;      var_dump(func_get_arg(0));  }  foo(1);

    将会打印 "2" 而不是 "1"。代码应该改成仅在调用 func_get_arg(s) 后进行修改操作。

    function foo($x) {      var_dump(func_get_arg(0));      $x++;  }

    或者应该避免修改参数:

    function foo($x) {      $newX = $x + 1;      var_dump(func_get_arg(0));  }
  • 类似的,异常回溯也不再显示传递给函数的原始值,而是修改后的值。例如:

    function foo($x) {      $x = 42;      throw new Exception;  }  foo("string");

    现在堆栈跟踪的结果是:

    Stack trace:  #0 file.php(4): foo(42)  #1 {main}

    而以前是:

    Stack trace:  #0 file.php(4): foo('string')  #1 {main}

    这并不会影响到你的代码的运行时行为,值得注意的是在调试时会有所不同。

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

相关 RFC: https://wiki.php.net/phpng

整数处理的变化

  • 无效的八进制表示(包含大于7的数字)现在会产生编译错误。例如,下列代码不再有效:

    $i = 0781; // 8 不是一个有效的八进制数字!

    以前,无效的数字(以及无效数字后的任何数字)会简单的忽略。以前如上 $i 的值是 7,因为后两位数字会被悄悄丢弃。

  • 二进制以负数镜像位移现在会抛出一个算术错误:

    var_dump(1 >> -1);  // ArithmeticError: 以负数进行位移
  • 向左位移的位数超出了整型宽度时,结果总是 0。

    var_dump(1 << 64); // int(0)

    以前上述代码的结果依赖于所用的 CPU 架构。例如,在 x86(包括 x86-64) 上结果是 int(1),因为其位移操作数在范围内。

  • 类似的,向右位移的位数超出了整型宽度时,其结果总是 0 或 -1 (依赖于符号):

    var_dump(1 >> 64);  // int(0)  var_dump(-1 >> 64); // int(-1)

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

字符串处理的变化

  • 包含十六进制数字的字符串不会再被当做数字,也不会被特殊处理。参见例子中的新行为:

    var_dump("0x123" == "291");     // bool(false)     (以前是 true)  var_dump(is_numeric("0x123"));  // bool(false)     (以前是 true)  var_dump("0xe" + "0x1");        // int(0)          (以前是 16)    var_dump(substr("foo", "0x1")); // string(3) "foo" (以前是 "oo")  // 注意:遇到了一个非正常格式的数字

    filter_var() 可以用来检查一个字符串是否包含了十六进制数字,或这个字符串是否能转换为整数:

    $str = "0xffff";  $int = filter_var($str, FILTER_VALIDATE_INT, FILTER_FLAG_ALLOW_HEX);  if (false === $int) {      throw new Exception("Invalid integer!");  }  var_dump($int); // int(65535)
  • 由于给双引号字符串和 HERE 文档增加了 Unicode 码点转义格式(Unicode Codepoint Escape Syntax), 所以带有无效序列的 "\u{" 现在会造成错误:

    $str = "\u{xyz}"; // 致命错误:无效的 UTF-8 码点转义序列

    要避免这种情况,需要转义开头的反斜杠:

    $str = "\\u{xyz}"; // 正确

    不过,不跟随 { 的 "\u" 不受影响。如下代码不会生成错误,和前面的一样工作:

    $str = "\u202e"; // 正确

相关 RFC:

错误处理的变化

  • 现在有两个异常类: Exception 和 Error 。这两个类都实现了一个新接口: Throwable 。在异常处理代码中的类型指示也许需要修改来处理这种情况。

  • 一些致命错误和可恢复的致命错误现在改为抛出一个 Error 。由于 Error 是一个独立于 Exception 的类,这些异常不会被已有的 try/catch 块捕获。

    可恢复的致命错误被转换为一个异常,所以它们不能在错误处理里面悄悄的忽略。部分情况下,类型指示失败不再能忽略。

  • 解析错误现在会生成一个 Error 扩展的 ParseError 。除了以前的基于返回值 / errorgetlast() 的处理,对某些可能无效的代码的 eval() 的错误处理应该改为捕获 ParseError 。

  • 内部类的构造函数在失败时总是会抛出一个异常。以前一些构造函数会返回 NULL 或一个不可用的对象。

  • 一些 E_STRICT 提示的错误级别改变了。

相关 RFC:

其它的语言变化

  • 静态调用一个不兼容的 $this 上下文的非静态调用的做法不再支持。这种情况下,$this 是没有定义的,但是对它的调用是允许的,并带有一个废弃提示。例子:

    class A {      public function test() { var_dump($this); }  }    // 注意:没有从类 A 进行扩展  class B {      public function callNonStaticMethodOfA() { A::test(); }  }    (new B)->callNonStaticMethodOfA();    // 废弃:非静态方法 A::test() 不应该被静态调用  // 提示:未定义的变量 $this  NULL

    注意,这仅出现在来自不兼容上下文的调用上。如果类 B 扩展自类 A ,调用会被允许,没有任何提示。

  • 不能使用下列类名、接口名和特殊名(大小写敏感):

    bool  int  float  string  null  false  true

    这用于 class/interface/trait 声明、 class_alias() 和 use 语句中。

    此外,下列类名、接口名和特殊名保留做将来使用,但是使用时尚不会抛出错误:

    resource  object  mixed  numeric
  • yield 语句结构当用在一个表达式上下文时,不再要求括号。它现在是一个优先级在 “print” 和 “=>” 之间的右结合操作符。在某些情况下这会导致不同的行为,例如:

    echo yield -1;  // 以前被解释如下  echo (yield) - 1;  // 现在被解释如下  echo yield (-1);    yield $foo or die;  // 以前被解释如下  yield ($foo or die);  // 现在被解释如下  (yield $foo) or die;

    这种情况可以通过增加括号来解决。

  • 移除了 ASP (<%) 和 script (<script language=php>) 标签。

    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。
    </li>
  • Date:

    • 从 mktime() 和 gmmktime() 中移除 $is_dst 参数
    • </ul> </li>
    • DBA

      • 如果键也没有出现在 inifile 处理器中,dba_delete() 现在会返回 false。
      • </ul> </li>
      • GMP

        • 现在要求 libgmp 版本 4.2 或更新。
        • gmp_setbit() 和 gmp_clrbit() 对于负指标返回 FALSE,和其它的 GMP 函数一致。
        • </ul> </li>
        • Intl:

          • 移除废弃的别名 datefmt_set_timezone_id() 和 IntlDateFormatter::setTimeZoneID()。替代使用 datefmt_set_timezone() 和 IntlDateFormatter::setTimeZone()。
          • </ul> </li>
          • libxml:

            • 增加 LIBXML_BIGLINES 解析器选项。从 libxml 2.9.0 开始可用,并增加了在错误报告中行号大于 16 位的支持。
            • </ul> </li>
            • Mcrypt

              • 移除等同于 mcrypt_generic_deinit() 的废弃别名 mcrypt_generic_end()。
              • 移除废弃的 mcrypt_ecb()、 mcrypt_cbc()、 mcrypt_cfb() 和 mcrypt_ofb() 函数,它们等同于使用 MCRYPT_MODE_* 标志的 mcrypt_encrypt() 和 mcrypt_decrypt() 。
              • </ul> </li>
              • 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 设置支持仅在会话数据更新时写入。
                • </ul> </li>
                • Opcache

                  • 移除 opcache.load_comments 配置语句。现在文件内备注载入无成本,并且总是启用的。
                  • </ul> </li>
                  • OpenSSL:

                    • 移除 "rsa_key_size" SSL 上下文选项,按给出的协商的加密算法自动设置适当的大小。
                    • 移除 "CN_match" 和 "SNI_server_name" SSL 上下文选项。使用自动侦测或 "peer_name" 选项替代。
                    • </ul> </li>
                    • PCRE:

                      • 移除对 /e (PREG_REPLACE_EVAL) 修饰符的支持,使用 preg_replace_callback() 替代。
                      • </ul> </li>
                      • PDO_pgsql:

                        • 移除 PGSQL_ATTR_DISABLE_NATIVE_PREPARED_STATEMENT 属性,等同于 ATTR_EMULATE_PREPARES。
                        • </ul> </li>
                        • Standard:

                          • 移除 setlocale() 中的字符串类目支持。使用 LC_* 常量替代。 instead.
                          • 移除 set_magic_quotes_runtime() 及其别名 magic_quotes_runtime()。
                          • </ul> </li>
                          • JSON:

                            • 拒绝 json_decode 中的 RFC 7159 不兼容数字格式 - 顶层 (07, 0xff, .1, -.1) 和所有层的 ([1.], [1.e1])
                            • 用一个参数调用 json_decode 等价于用空的 PHP 字符串或值调用,转换为空字符串(NULL, FALSE)的结果是 JSON 格式错误。
                            • </ul> </li>
                            • Stream:

                              • 移除 set_socket_blocking() ,等同于其别名 stream_set_blocking()。
                              • </ul> </li>
                              • XSL:

                                • 移除 xsl.security_prefs ini 选项,使用 XsltProcessor::setSecurityPrefs() 替代。
                                • </ul> </li> </ul>

                                  2. 新功能

                                  • Core

                                    </li>
                                  • Opcache

                                    • 增加了基于文件的二级 opcode 缓存(实验性——默认禁用)。要启用它,PHP 需要使用 --enable-opcache-file 配置和构建,然后 opcache.file_cache=<DIR> 配置指令就可以设置在 php.ini 中。二级缓存也许可以提升服务器重启或 SHM 重置时的性能。此外,也可以设置 opcache.file_cache_only=1 来使用文件缓存而根本不用 SHM(也许对于共享主机有用);设置 opcache.file_cache_consistency_checks=0 来禁用文件缓存一致性检查,以加速载入过程,有安全风险。
                                    • </ul> </li>
                                    • OpenSSL

                                      • 当用 OpenSSL 1.0.2 及更新构建时,增加了 "alpn_protocols" SSL 上下文选项来允许加密的客户端/服务器流使用 ALPN TLS 扩展去协商替代的协议。协商后的协议信息可以通过 stream_get_meta_data() 输出访问。
                                      • </ul> </li>
                                      • Reflection

                                        • 增加了一个 ReflectionGenerator 类(yield from Traces,当前文件/行等等)。
                                        • 增加了一个 ReflectionType 类来更好的支持新的返回类型和标量类型声明功能。新的 ReflectionParameter::getType() 和 ReflectionFunctionAbstract::getReturnType() 方法都返回一个 ReflectionType 实例。
                                        • </ul> </li>
                                        • Stream

                                          • 添加了新的仅用于 Windows 的流上下文选项以允许阻塞管道读取。要启用该功能,当创建流上下文时,传递 array("pipe" => array("blocking" => true)) 。要注意的是,该选项会导致管道缓冲区的死锁,然而它在几个命令行场景中有用。
                                          • </ul> </li> </ul>

                                            3. SAPI 模块的变化

                                            • FPM
                                              • 修复错误 #65933 (不能设置超过1024字节的配置行)。
                                              • Listen = port 现在监听在所有地址上(IPv6 和 IPv4 映射的)。
                                              </li> </ul>

                                              4. 废弃的功能

                                              • Core

                                                • 废弃了 PHP 4 风格的构建函数(即构建函数名必须与类名相同)。
                                                • 废弃了对非静态方法的静态调用。
                                                </li>
                                              • OpenSSL

                                                • 废弃了 "capture_session_meta" SSL 上下文选项。 在流资源上活动的加密相关的元数据可以通过 stream_get_meta_data() 的返回值访问。
                                                • </ul> </li> </ul>

                                                  5. 函数的变化

                                                  • parse_ini_file():
                                                  • parse_ini_string():

                                                    • 添加了扫描模式 INISCANNERTYPED 来得到 yield 类型的 .ini 值。
                                                    </li>
                                                  • unserialize():

                                                    • 给 unserialize 函数添加了第二个参数 (RFC: https://wiki.php.net/rfc/secure_unserialize) 来指定可接受的类: unserialize($foo, ["allowed_classes" => ["MyClass", "MyClass2"]]);
                                                    • </ul> </li>
                                                    • proc_open():

                                                      • 可以被 proc_open() 使用的最大管道数以前被硬编码地限制为 16。现在去除了这个限制,只受限于 PHP 的可用内存大小。
                                                      • 新添加的仅用于 Windows 的配置选项 "blocking_pipes" 可以用于强制阻塞对子进程管道的读取。这可以用于几种命令行应用场景,但是它会导致死锁。此外,这与新的流的管道上下文选项相关。
                                                      • </ul> </li>
                                                      • array_column():

                                                        • 该函数现在支持把对象数组当做二维数组。只有公开属性会被处理,对象里面使用 __get() 的动态属性必须也实现 __isset() 才行。
                                                        • </ul> </li>
                                                        • stream_context_create()

                                                          • 现在可以接受一个仅 Windows 可用的配置 array("pipe" => array("blocking" => <boolean>)) 来强制阻塞管道读取。该选项应该小心使用,该平台有可能导致管道缓冲区的死锁。
                                                          • </ul> </li> </ul>

                                                            6. 新函数

                                                            • GMP

                                                              • 添加了 gmp_random_seed()。
                                                              </li>
                                                            • PCRE:

                                                              • 添加了 preg_replace_callback_array 函数。 (RFC: https://wiki.php.net/rfc/preg_replace_callback_array)
                                                              • </ul> </li>
                                                              • Standard . 添加了整数除法 intdiv() 函数。 . 添加了重置错误状态的 error_clear_last() 函数。

                                                              • Zlib: . 添加了 deflate_init()、 deflate_add()、 inflate_init()、 inflate_add() 函数来运行递增和流的压缩/解压。

                                                              • </ul>

                                                                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

                                                                更多细节参见:

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

                                                                9. 扩展的其它变化

                                                                • Mhash
                                                                  • Mhash 今后不是一个扩展了,使用 function_exists("mhash") 来检查器是否可用。
                                                                  </li> </ul>

                                                                  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
                                                                    </li>
                                                                  • GD

                                                                    • 移除了 T1Lib 支持,这样由于对 T1Lib 的可选依赖,如下将来不可用:
                                                                    • </ul>

                                                                      函数:

                                                                      • imagepsbbox()
                                                                      • imagepsencodefont()
                                                                      • imagepsextendedfont()
                                                                      • imagepsfreefont()
                                                                      • imagepsloadfont()
                                                                      • imagepsslantfont()
                                                                      • imagepstext()

                                                                      资源:

                                                                      • 'gd PS font'
                                                                      • 'gd PS encoding'
                                                                      </li> </ul>

                                                                      11. INI 文件处理的变化

                                                                      • Core
                                                                        • 移除了 asp_tags ini 指令。如果启用它会导致致命错误。
                                                                        • 移除了 always_populate_raw_post_data ini 指令。
                                                                        </li> </ul>

                                                                        12. Windows 支持

                                                                        • Core

                                                                          • 在 64 位系统上支持原生的 64 位整数。
                                                                          • 在 64 位系统上支持大文件。
                                                                          • 支持 getrusage()。
                                                                          </li>
                                                                        • ftp

                                                                          • 所带的 ftp 扩展总是共享库的。
                                                                          • 对于 SSL 支持,取消了对 openssl 扩展的依赖,取而代之仅依赖 openssl 库。如果在编译时需要,会自动启用 ftp_ssl_connect()。
                                                                          • </ul> </li>
                                                                          • odbc