PHP8.3正式发布,有哪些更新?
2023年11月23日,PHP8.3正式发布。它包含了许多新功能,它包含了许多新功能,例如:类常量显式类型、只读属性深拷贝,以及对随机性功能的补充。一如既往,它还包括性能改进、错误修复和常规清理等。
类型化类常量
interface I {
// 我们可能天真地假设 PHP 常量始终是一个字符串。
const PHP = 'PHP 8.2';
}
class Foo implements I {
// 但是实现类可以将其定义为数组。
const PHP = [];
}
interface I {
const string PHP = 'PHP 8.3';
}
class Foo implements I {
const string PHP = [];
}
// 致命错误:无法使用数组作为类常量的值
// 字符串类型的 Foo::PHP
动态获取类常量
class Foo {
const PHP = 'PHP 8.2';
}
$searchableConstant = 'PHP';
var_dump(constant(Foo::class . "::{$searchableConstant}"));
class Foo {
const PHP = 'PHP 8.3';
}
$searchableConstant = 'PHP';
var_dump(Foo::{$searchableConstant});
use PHPUnit\Framework\TestCase;
final class MyTest extends TestCase {
protected $logFile;
protected function setUp(): void {
$this->logFile = fopen('/tmp/logfile', 'w');
}
protected function taerDown(): void {
fclose($this->logFile);
unlink('/tmp/logfile');
}
}
// 日志文件永远不会被删除,因为
// 方法名称输入错误(taerDown 与tearDown)。
use PHPUnit\Framework\TestCase;
final class MyTest extends TestCase {
protected $logFile;
protected function setUp(): void {
$this->logFile = fopen('/tmp/logfile', 'w');
}
#[\Override]
protected function taerDown(): void {
fclose($this->logFile);
unlink('/tmp/logfile');
}
}
// 致命错误:MyTest::taerDown() 有 #[\Override] 属性,
// 但不存在匹配的父方法
通过给方法添加 #[\Override] 属性,PHP 将确保在父类或实现的接口中存在同名的方法。添加该属性表示明确说明覆盖父方法是有意为之,并且简化了重构过程,因为删除被覆盖的父方法将被检测出来。
只读属性深拷贝
class PHP {
public string $version = '8.2';
}
readonly class Foo {
public function __construct(
public PHP $php
) {}
public function __clone(): void {
$this->php = clone $this->php;
}
}
$instance = new Foo(new PHP());
$cloned = clone $instance;
// 致命错误:无法修改只读属性 Foo::$php
class PHP {
public string $version = '8.2';
}
readonly class Foo {
public function __construct(
public PHP $php
) {}
public function __clone(): void {
$this->php = clone $this->php;
}
}
$instance = new Foo(new PHP());
$cloned = clone $instance;
$cloned->php->version = '8.3';
readonly 属性现在可以在魔术方法 __clone 中被修改一次,以此实现只读属性的深拷贝
新增 json_validate() 函数
function json_validate(string $string): bool {
json_decode($string);
return json_last_error() === JSON_ERROR_NONE;
}
var_dump(json_validate('{ "test": { "foo": "bar" } }')); // true
var_dump(json_validate('{ "test": { "foo": "bar" } }')); // true
json_validate() 可以检查一个字符串是否为语法正确的 JSON,比 json_decode() 更有效。
新增Randomizer::getBytesFromString()方法
// 该功能需要手动实现。
function getBytesFromString(string $string, int $length) {
$stringLength = strlen($string);
$result = '';
for ($i = 0; $i < $length; $i++) {
// random_int 不可用于测试,但安全。
$result .= $string[random_int(0, $stringLength - 1)];
}
return $result;
}
$randomDomain = sprintf(
"%s.example.com",
getBytesFromString(
'abcdefghijklmnopqrstuvwxyz0123456789',
16,
),
);
echo $randomDomain;
// A \Random\Engine may be passed for seeding,
// the default is the secure engine.
$randomizer = new \Random\Randomizer();
$randomDomain = sprintf(
"%s.example.com",
$randomizer->getBytesFromString(
'abcdefghijklmnopqrstuvwxyz0123456789',
16,
),
);
echo $randomDomain;
在 PHP 8.2 中新增的 Random 扩展 通过一个新方法生成由特定字节组成的随机字符串。这种方法可以使开发者更轻松的生成随机的标识符(如域名),以及任意长度的数字字符串。
新增Randomizer::getFloat()和Randomizer::nextFloat()方法
// 返回 $min 和 $max 之间的随机浮点值,两者都包括。
function getFloat(float $min, float $max) {
// 该算法对特定输入有偏差,并且可能
// 返回超出给定范围的值。这是不可能的
// 在用户空间中解决。
$offset = random_int(0, PHP_INT_MAX) / PHP_INT_MAX;
return $offset * ($max - $min) + $min;
}
$temperature = getFloat(-89.2, 56.7);
$chanceForTrue = 0.1;
// getFloat(0, 1) might return the upper bound, i.e. 1,
// introducing a small bias.
$myBoolean = getFloat(0, 1) < $chanceForTrue;
$randomizer = new \Random\Randomizer();
$temperature = $randomizer->getFloat(
-89.2,
56.7,
\Random\IntervalBoundary::ClosedClosed,
);
$chanceForTrue = 0.1;
// Randomizer::nextFloat() is equivalent to
// Randomizer::getFloat(0, 1, \Random\IntervalBoundary::ClosedOpen).
// The upper bound, i.e. 1, will not be returned.
$myBoolean = $randomizer->nextFloat() < $chanceForTrue;
由于浮点数的精度和隐式四舍五入的限制,在特定区间内生成无偏差的浮点数并非易事,常建的用户解决方案可能会生成有偏差的结果或超出要求范围的数字。
Randomizer 扩展了两种方法,用于随机生成无偏差的浮点数。Randomizer::getFloat() 方法使用的是 γ-section 算法,该算法发表于 Drawing Random Floating-Point Numbers from an Interval. Frédéric Goualard, ACM Trans. Model. Comput. Simul., 32:3, 2022.
新的类、接口和函数
新增 DOMElement::getAttributeNames()、DOMElement::insertAdjacentElement()、DOMElement::insertAdjacentText()、DOMElement::toggleAttribute()、DOMNode::contains()、DOMNode::getRootNode()、DOMNode::isEqualNode()、DOMNameSpaceNode::contains() 和 DOMParentNode::replaceChildren() 方法。
新增 IntlCalendar::setDate()、IntlCalendar::setDateTime()、IntlGregorianCalendar::createFromDate() 和 IntlGregorianCalendar::createFromDateTime() 方法。
新增 ldap_connect_wallet() 和 ldap_exop_sync() 函数。
新增 mb_str_pad() 函数。
新增 posix_sysconf()、posix_pathconf()、posix_fpathconf() 和 posix_eaccess() 函数。
新增 ReflectionMethod::createFromMethodName() 方法
新增 socket_atmark() 函数。
新增 str_increment()、str_decrement() 和 stream_context_set_options() 函数。
新增 ZipArchive::getArchiveFlag() 方法。
支持在 OpenSSL 扩展中使用自定义 EC 参数生成 EC 密钥。
新增 INI 设置 zend.max_allowed_stack_size 用于设置允许的最大堆栈大小。
弃用和向后不兼容
更合适的 Date/Time 异常。
现在在空数组中获取负索引 n 时,将确保下一个索引是 n + 1 而不是 0。
对 range() 函数的更改。
在 traits 中重新声明静态属性的更改。
U_MULTIPLE_DECIMAL_SEPERATORS 常量已被废弃,改为 U_MULTIPLE_DECIMAL_SEPARATORS。
MT_RAND_PHP Mt19937 变体已被废弃。
ReflectionClass::getStaticProperties() 不再为空。
INI 配置 assert.active、assert.bail、assert.callback、assert.exception 和 assert.warning 已被废弃。
调用 get_class() 和 get_parent_class() 时未提供参数,已被废弃。