Skip to content

Latest commit

 

History

History
403 lines (356 loc) · 16.6 KB

Backward-incompatible-changes.md

File metadata and controls

403 lines (356 loc) · 16.6 KB

PHP5.6.x版本迁移至7.0.x版本

向后兼容说明

错误和异常处理的变更

许多可以被修正的 Fatal 错误，在 PHP7 中将以 Exceptions 异常的形式抛出。这些 Error Exceptions 继承于 Error 类。而 Error 类则实现了异常基类 Throwable 接口。
PHP7 中详细的 Error 信息可以参考 PHP7 错误 。本文中仅仅介绍和向后兼容有关的信息如下。

类构造函数在失败时抛出异常

之前，类构造函数在失败时总是返回NULL或者返回一个不可用的 Object，但从 PHP7 开始，在构造函数初始化失败时会抛出异常。

解析错误时会抛出 解析异常

现在，解析 eval() 错误会抛出一个 解析异常 对象。其可以通过 catch 捕捉，并做相应处理。

E_STRICT 等级的报错被重新分配

所有 E_STRICT 级别的报错已重新分配到其他报错等级中。E_STRICT 常量依然保留，所以当你设置报错等级为 error_reporting(E_ALL|E_STRICT) 时，不会引起报错。
变更情况如下表 image

变量处理环节的变更

由于 PHP7 采用抽象的语法树解析代码文件，并且过去的 PHP 版本无法满足该特性，这一变化将引起一些一致性问题。本节详细介绍这块的情况。

对于间接变量、属性、方法的变动

间接的使用变量、属性、方法，将严格按照从左到右的顺序执行，而不会因形式问题导致歧义。下表将表明这一改变引起的差异。 image 以上使用老的从右到左的方式的代码，将被重写。通过花括号来明确顺序（见上图中间列），使代码向前兼容 PHP7.x，并向后兼容 PHP5.x。

对于 list() 函数处理上的修改

list() 不再按照相反顺序插入元素

list() 函数从此开始按照原数组中的顺序插入到函数参数制定的位置上，不再翻转数据。这点修改只会作用在 list() 函数参数一起用了数组的 [] 符号时。举例如下：

<?php
list($a[], $a[], $a[]) = [1, 2, 3];
var_dump($a);
?>

上述例子在 PHP5 中的输出为：

array(3) {
  [0]=>
  int(3)
  [1]=>
  int(2)
  [2]=>
  int(1)
}

而在 PHP7 中的输出为：

array(3) {
  [0]=>
  int(1)
  [1]=>
  int(2)
  [2]=>
  int(3)
}

在实际开发中，不建议使用依靠 list() 函数的参数来做排顺序这一操作，毕竟这样的 hack 用法在未来依然有可能被调整。

list() 函数参数不再允许为空

list() 构造时不再允许参数为空的情况，下列情况将不再支持！

<?php
list() = $a;
list(,,) = $a;
list($x, list(), $y) = $a;
?>
list() 函数不再支持拆解字符串

list() 不再允许拆解字符串变量为字母，str_split 函数可以用于做此事。

在数组中的元素通过引用方式创建时，数组顺序会被改变

数组中的元素在通过引用方式创建时，其数组顺序会被自动的改变。例如：

<?php
$array = [];
$array["a"] =& $array["b"];
$array["b"] = 1;
var_dump($array);
?>

PHP5 中的输出：

array(2) {
  ["b"]=>
  &int(1)
  ["a"]=>
  &int(1)
}

PHP7 中的输出

array(2) {
  ["a"]=>
  &int(1)
  ["b"]=>
  &int(1)
}

global 仅支持简单的变量

可变变量将不能再使用 global 标记。如果真的需要，可以用花括号来间隔开写，例如下面代码：

<?php
function f() {
    // Valid in PHP 5 only.
    global $$foo->bar;

    // Valid in PHP 5 and 7.
    global ${$foo->bar};
}
?>

作为一个基本原则，这样的变量套变量的使用方式，在 global 这种场景下不被提倡。

函数参数中的括号不再影响(行为?)

在 PHP5 中，函数引用参数如果匹配括号操作，不会触发严格标准警告。但从 PHP7 开始，这种场景都会引发一个警告信息。

<?php
function getArray() {
    return [1, 2, 3];
}

function squareArray(array &$a) {
    foreach ($a as &$v) {
        $v **= 2;
    }
}

// Generates a warning in PHP 7.
squareArray((getArray()));
?>

上述示例代码将会产生如下输出：

Notice: Only variables should be passed by reference in /tmp/test.php on line 13

foreach 的改变

关于 foreach 的修改比较少，主要是修改了数组遍历时的数组指针，以及修改了数组的迭代。

foreach 遍历期间不再修改数组指针

在 PHP7 之前，当数组通过 foreach 迭代时，数组指针会移动。现在开始，不再如此，见下面代码：

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

PHP5 中的输出

int(1)
int(2)
bool(false)

PHP7 中的输出

int(0)
int(0)
int(0)

foreach 通过值遍历时，操作的值为数组的副本

当默认使用通过值遍历数组时，foreach 实际操作的是数组的迭代副本，而非数组本身。这就意味着，foreach 中的操作不会修改原数组的值。

foreach 通过引用遍历时，有更好的迭代特性

当使用引用遍历数组时，现在 foreach 在迭代中能更好的跟踪变化。例如，在迭代中添加一个迭代值到数组中，例如下面代码：

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

在 PHP5 的输出为：

int(0)

在 PHP7 的输出为：

int(0)
int(1)

non-Traversable 对象的遍历

non-Traversable 对象的遍历与通过引用遍历相似，具有相同的行为特性，在遍历期间对原数据进行的操作将会被感知。

整型处理上的调整

无效的八进制常量

此前，八进制中包含无效数据会自动被截断（0128 被当做为 012）。现在，一个无效的八进制字面会造成分析错误。

负位置

位移的负数将抛出一个 ArithmeticError

<?php
var_dump(1 >> -1);
?>

PHP5 中的输出：

int(0)

PHP7 中的输出：

Fatal error: Uncaught ArithmeticError: Bit shift by negative number in /tmp/test.php:2
Stack trace:
#0 {main}
  thrown in /tmp/test.php on line 2

超出范围的位移

位移（任一方向）超出一个整数的位宽度会得到 0。以前，这种转变的行为是依赖于运行环境的机器架构结构。

字符串处理上的调整

十六进制字符串不再被认为是数字

含十六进制字符串不再被认为是数字。例如：

<?php
var_dump("0x123" == "291");
var_dump(is_numeric("0x123"));
var_dump("0xe" + "0x1");
var_dump(substr("foo", "0x1"));
?>

在 PHP5 中的输出：

bool(true)
bool(true)
int(15)
string(2) "oo"

在 PHP7 中的输出：

bool(false)
bool(false)
int(0)

Notice: A non well formed numeric value encountered in /tmp/test.php on line 5
string(3) "foo"

filter_var() 函数可以用于检查一个字符串中是否包含十六进制数，同时也可以转换一个字符串为十六进制数。

<?php
$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)
?>

\u{ 可能触发错误

由于新的 Unicode 转译语法，字符串中含有 **\u{ ** 时会触发Fatal错误。为了避免这一报错，应该避免反斜杠开头。

被移除的函数

call_user_method() 与 call_user_method_array()

这些函数被在 PHP4.1.0 开始被标记为过时的，在 PHP7 开始被删除。建议使用 call_user_func() 和 call_user_func_array() 。你可以考虑下变量函数或者参考其他函数。

mcrypt 相关

mcrypt_generic_end() 被删除，建议使用 mcrypt_generic_deinit() 。 此外，废弃的mcrypt_ecb()，mcrypt_cbc()，mcrypt_cfb() 和 mcrypt_ofb() 功能，建议使用目前还支持的 mcrypt_decrypt() 与适当的 MCRYPT_MODE_* 常量。

intl 相关

datefmt_set_timezone_id() 与 IntlDateFormatter::setTimeZoneID() 被删除，建议使用 datefmt_set_timezone() 与 IntlDateFormatter::setTimeZone() 。

set_magic_quotes_runtime()

set_magic_quotes_runtime() 与它的别名函数 magic_quotes_runtime() 被删除。他们在 PHP5.3.0 中就被标记被过时的。

set_socket_blocking()

set_socket_blocking() 已被移除，建议使用 stream_set_blocking()。

dl() 在PHP-FPM中

dl() 函数不能在 PHP-FPM 中使用了，它的功能做在了 CLI、嵌入到 SAPIs 中了。

GD 类型的函数

PostScript Type1 字体的支持已经从 GD 扩展删除，涉及的函数有：

  • imagepsbbox()
  • imagepsencodefont()
  • imagepsextendfont()
  • imagepsfreefont()
  • imagepsloadfont()
  • imagepsslantfont()
  • imagepstext() 建议使用 TrueType 字体和其相关的功能代替。

删除INI配置

删除的功能

下面的INI指令以及相关的功能被删除：

xsl.security_prefs

xsl.security_prefs 指令已被删除。相反，该 xsltprocessor::setsecurityprefs() 方法用于控制在每个处理器上的安全选项。

其他不向后兼容的变更

New 对象不能被引用分配

New 语句的结果不再能通过引用赋值给一个变量，如下代码：

<?php
class C {}
$c =& new C;
?>

PHP5 中的输出：

Deprecated: Assigning the return value of new by reference is deprecated in /tmp/test.php on line 3

PHP7 中的输出：

Parse error: syntax error, unexpected 'new' (T_NEW) in /tmp/test.php on line 3

无效的类、接口和特性的名字

下面的名称不能被用来作为类、接口、特性的名称：

  • bool
  • int
  • float
  • string
  • NULL
  • TRUE
  • FALSE

此外，不推荐下列名称，它们已被标记为过时

  • resource
  • object
  • mixed
  • numeric

ASP 语法标记、Script PHP 语法标记被移除

使用 ASP 脚本标签，或者 Script 的 PHP 代码，已被删除。受影响的标签是： image

禁止调用不确定的情况

之前 PHP5.6 的过时说明中，静态调用一个非静态方法，会在静态调用中被提示未定义 $this ，并会报错。

<?php
class A {
    public function test() { var_dump($this); }
}

// Note: Does NOT extend A
class B {
    public function callNonStaticMethodOfA() { A::test(); }
}

(new B)->callNonStaticMethodOfA();
?>

在 PHP5 中会输出：

Deprecated: Non-static method A::test() should not be called statically, assuming $this from incompatible context in /tmp/test.php on line 8
object(B)#1 (0) {
}

在 PHP7 中会输出：

Deprecated: Non-static method A::test() should not be called statically in /tmp/test.php on line 8

Notice: Undefined variable: this in /tmp/test.php on line 3
NULL

yield 现在开始作为(右)关联运算符

yield 不再需要括号，可以作为一个（右）关联运算符，优先于 print 与 =>，这将产生下列行为：

<?php
echo yield -1;
// Was previously interpreted as
echo (yield) - 1;
// And is now interpreted as
echo yield (-1);

yield $foo or die;
// Was previously interpreted as
yield ($foo or die);
// And is now interpreted as
(yield $foo) or die;
?>

括号可以用来消除歧义的情况。

函数不能有多个相同的名称的参数

不允许函数在参数中出现相同名称的参数。例如下列代码，将会产生 E_COMPILE_ERROR 的报错。

<?php
function foo($a, $b, $unused, $unused) {
    //
}
?>

$HTTP_RAW_POST_DATA 被移除

$HTTP_RAW_POST_DATA 不再被支持。 可以使用 php://input 流数据来代替实现。

# 注释已被移除

INI 文件中以 # 符号作为注释的内容已被移除，; 符号将代替 #，这个改变同样适用于 PHP.ini 文件，以及 parse_ini_file() 和 parse_ini_string() 处理文件期间。

用户贡献说明

暂无