PHP - Manual: 不向下兼容的变更
2024-12-21
之前版本中,number_format()
有可能会返回 -0
。虽然这是符合 IEEE 754
规范的,但是这样会导致可读性不好,新版本中会将这样的负数去掉。
<?php
var_dump(number_format(-0.01)); // 新版本输出 string(1) "0" 旧版本输出 string(2) "-0"
将数组转换为对象,或将对象转换为数组时,数字键现在得到了更好的处理(无论是通过显式转换还是通过 settype() 函数)。
这意味着现在可以访问数组中的整数(或者说是字符串整数)键,这些键会映射到对象中:
<?php
// array to object
$arr = [0 => 1];
$obj = (object)$arr;
var_dump(
$obj,
$obj->{'0'}, // 新写法
$obj->{0} // 新写法
);
以上例程会输出:
object(stdClass)#1 (1) { ["0"]=> // string key now, rather than integer key int(1) } int(1) int(1)
从对象转换成的数组中的整数(或者说是字符串整数)键现在也可以直接访问:
<?php
// object to array
$obj = new class {
public function __construct()
{
$this->{0} = 1;
}
};
$arr = (array)$obj;
var_dump(
$arr,
$arr[0], // 新写法
$arr['0'] // 新写法
);
以上例程会输出:
array(1) { [0]=> // integer key now, rather than string key int(1) } int(1) int(1)
null
参数
之前版本中,传递 null
给 get_class()
函数将返回当前类名。在新版本中,此行为会抛出一个
E_WARNING
错误。如果想实现与之前版本同样的效果,请不要传递任何参数进来。
对非可数类型调用 count()(或
sizeof())函数,会抛出一个
E_WARNING
错误。
<?php
var_dump(
count(null), // NULL is not countable
count(1), // integers are not countable
count('abc'), // strings are not countable
count(new stdclass), // objects not implementing the Countable interface are not countable
count([1,2]) // arrays are countable
);
以上例程会输出:
Warning: count(): Parameter must be an array or an object that implements Countable in %s on line %d Warning: count(): Parameter must be an array or an object that implements Countable in %s on line %d Warning: count(): Parameter must be an array or an object that implements Countable in %s on line %d Warning: count(): Parameter must be an array or an object that implements Countable in %s on line %d int(0) int(1) int(1) int(1) int(2)
As part of the long-term migration away from resources, the Hash extension has been updated to use objects instead of resources. The change should be seamless for PHP developers, except for where is_resource() checks have been made (which will need updating to is_object() instead).
下列默认选项被修改:
tls://
默认为 TLSv1.0 or TLSv1.1 or TLSv1.2
ssl://
成为 tls://
的别名
STREAM_CRYPTO_METHOD_TLS_*
常量默认为 TLSv1.0
或 TLSv1.1 + TLSv1.2,替代之前的 TLSv1.0
之前版本中,如果在一个闭包资源中使用 gettype()
会返回字符串 "unknown type"
,现在将会返回字符
"resource (closed)"
。
之前版本中,对 __PHP_Incomplete_Class
调用 is_object() 函数会返回
false
,现在会返回 true
。
调用未定义的常量,现在会抛出一个
E_WARNING
错误(之前版本中为 E_NOTICE
)。在下一个
PHP 大版本中,将会抛出一个
Error 错误。
官方支持的最低 Windows 版本为 Windows 7/Server 2008 R2。
Compatibility checks upon default trait property values will no longer perform casting.
object
保留字的变化
object
在之前的 PHP 7.0 版本
中被声明为软保留字(soft-reserved)。现在变更为强制保留字,禁止在任何类或接口中使用该名称。
NetWare 已不再被支持。
SORT_STRING
While array_unique() with SORT_STRING
formerly copied the array and removed non-unique elements (without packing
the array afterwards), now a new array is built by adding the
unique elements. This can result in different numeric indexes.
The bcmod() function no longer truncates fractional
numbers to integers. As such, its behavior now follows
fmod(), rather than the %
operator.
For example bcmod('4', '3.5')
now returns
0.5
instead of 1
.
The hash_hmac(), hash_hmac_file(),
hash_pbkdf2(), and hash_init() (with
HASH_HMAC
) functions no longer accept non-cryptographic
hashes.
The json_decode() function option,
JSON_OBJECT_AS_ARRAY
, is now used if the second
parameter (assoc) is null
. Previously,
JSON_OBJECT_AS_ARRAY
was always ignored.
Sequences generated by rand() and mt_rand() for a specific seed may differ from PHP 7.1 on 64-bit machines (due to the fixing of a modulo bias bug in the implementation).
sql.safe_mode
ini 选项移除
sql.safe_mode
ini 设置项已被移除。
The zone
element of the array returned by date_parse() and
date_parse_from_format() represents seconds instead of
minutes now, and its sign is inverted. For instance -120
is now 7200
.
As of PHP 7.2.34, the names of incoming cookies are no longer url-decoded for security reasons.
官方地址:https://www.php.net/manual/en/migration72.incompatible.php