介绍
PHP 8.3 是 PHP 语言的主版本更新。它包含了许多新功能, 它包含了许多新功能,例如:类常量显式类型、只读属性深拷贝,以及对随机性功能的补充。一如既往,它还包括性能改进、错误修复和常规清理等。
类型化类常量
interface I { const string PHP = 'PHP 8.3'; } class Foo implements I { const string PHP = []; } // Fatal error: Cannot use array as value for class constant // Foo::PHP of type string
动态获取类常量
class Foo { const PHP = 'PHP 8.3'; } $searchableConstant = 'PHP'; var_dump(Foo::{$searchableConstant});
新增 #[\Override] 属性
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'); } } // Fatal error: MyTest::taerDown() has #[\Override] attribute, // but no matching parent method exists
通过给方法添加
#[\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; $cloned->php->version = '8.3';
readonly
属性现在可以在魔术方法__clone
中被修改一次,以此实现只读属性的深拷贝
新增 json_validate() 函数
var_dump(json_validate('{ "test": { "foo": "bar" } }')); // true
json_validate()
可以检查一个字符串是否为语法正确的 JSON,比json_decode()
更有效。
新增 Randomizer::getBytesFromString() 方法
// 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.3
中新增的 Random 扩展 通过一个新方法生成由特定字节组成的随机字符串。这种方法可以使开发者更轻松的生成随机的标识符(如域名),以及任意长度的数字字符串。
新增 Randomizer::getFloat() 和 Randomizer::nextFloat() 方法
$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;
由于浮点数的精度和隐式四舍五入的限制,在特定区间内生成无偏差的浮点数并非易事,常建的用户解决方案可能会生成有偏差的结果或超出要求范围的数字。
新的类、接口和函数
- 新增
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()
时未提供参数,已被废弃。