搜尋
更多變更日誌更多變更日誌

PHP 8.3 是 PHP 語言的重大更新。

它包含許多新功能,例如類別常數的明確類型、唯讀屬性的深度克隆以及隨機功能的新增。像往常一樣,它還包括效能改進、錯誤修復和常規清理。

立即升級到 PHP 8.3!

類型化類常數

PHP < 8.3
interfaceI{
// We may naively assume that the PHP constant is always a string.
constPHP='PHP 8.2';
}

classFooimplementsI{
// But implementing classes may define it as an array.
constPHP=[];
}
PHP 8.3
interfaceI{
conststring PHP='PHP 8.2';
}

classFooimplementsI{
conststring PHP=[];
}
// Fatal error: Cannot use array as value for class constant
// Foo::PHP of type string

動態類別常數獲取

PHP < 8.3
classFoo{
constPHP='PHP 8.2';
}

$searchableConstant='PHP';

var_dump(constant(Foo::class . "::{$searchableConstant}"));
PHP 8.3
classFoo{
constPHP='PHP 8.3';
}

$searchableConstant='PHP';

var_dump(Foo::{$searchableConstant});

New #[Override] attribute

PHP < 8.3
usePHPUnit\Framework\TestCase;

final classMyTestextendsTestCase{
protected$logFile;

protected functionsetUp():void{
$this->logFile=fopen('/tmp/logfile','w');
}

protected functiontaerDown():void{
fclose($this->logFile);
unlink('/tmp/logfile');
}
}

// The log file will never be removed, because the
// method name was mistyped (taerDown vs tearDown).
PHP 8.3
usePHPUnit\Framework\TestCase;

final classMyTestextendsTestCase{
protected$logFile;

protected functionsetUp():void{
$this->logFile=fopen('/tmp/logfile','w');
}

#[\Override]
protected functiontaerDown():void{
fclose($this->logFile);
unlink('/tmp/logfile');
}
}

// The log file will never be removed, because the
// method name was mistyped (taerDown vs tearDown).

By adding the #[Override] attribute to a method, PHP will ensure that a method with the same name exists in a parent class or in an implemented interface. Adding the attribute makes it clear that overriding a parent method is intentional and simplifies refactoring, because the removal of an overridden parent method will be detected.

只讀屬性的深度克隆

PHP < 8.3
classPHP{
publicstring $version='8.2';
}

readonly classFoo{
public function__construct(
publicPHP $php
) {}

public function__clone():void{
$this->php= clone$this->php;
}
}

$instance= newFoo(newPHP());
$cloned= clone$instance;

// Fatal error: Cannot modify readonly property Foo::$php
PHP 8.3
classPHP{
publicstring $version='8.2';
}

readonly classFoo{
public function__construct(
publicPHP $php
) {}

public function__clone():void{
$this->php= clone$this->php;
}
}

$instance= newFoo(newPHP());
$cloned= clone$instance;

$cloned->php->version='8.3';

現在可以在神奇的 __clone 方法中修改唯讀屬性一次,以啟用唯讀屬性的深度克隆。

新增 json_validate() 函數

PHP < 8.3
functionjson_validate(string $string):bool{
json_decode($string);

returnjson_last_error() ===JSON_ERROR_NONE;
}

var_dump(json_validate('{ "test": { "foo": "bar" }
}'));// true
PHP 8.3
var_dump(json_validate('{ "test": { "foo": "bar" }
}')); // true

json_validate() 允許檢查字串在語法上是否為有效的 JSON,同時比 json_decode() 更有效率。

新增 Randomizer::getBytesFromString() 方法

PHP < 8.3
// This function needs to be manually implemented.
functiongetBytesFromString(string $string,int$length) {
$stringLength=strlen($string);

$result='';
for ($i=0;$i<$length;$i++) {
// random_int is not seedable for testing, but secure.
$result.=$string[random_int(0,$stringLength-1)];
}

return$result;
}

$randomDomain=sprintf(
"%s.example.com",
getBytesFromString(
'abcdefghijklmnopqrstuvwxyz0123456789',
16,
),
);

echo$randomDomain;
PHP 8.3
// 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 中添加的隨機擴展透過新方法進行了擴展,以產生僅由特定位元組組成的隨機字串。該方法允許開發人員輕鬆生成隨機標識符,例如域名和任意長度的數字字串。

新增 Randomizer::getFloat() 和 Randomizer::nextFloat() 方法

PHP < 8.3
// Returns a random float between $min and $max, both including.
functiongetFloat(float $min,float $max) {
// This algorithm is biased for specific inputs and may
// return values outside the given range. This is impossible
// to work around in userland.
$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;
PHP 8.3
$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::getFloat() 方法使用在 Drawing Random Floating-Point Numbers from an Interval 中發布的 γ 部分演算法。 Frédéric Goualard,ACM 翻譯。模型。計算。同時,32:3,2022 年。

命令列 linter 支援多個文件

PHP < 8.3
php -l foo.php bar.php
No syntax errors detected in foo.php
PHP 8.3
php -l foo.php bar.php
No syntax errors detected in foo.php
No syntax errors detected in bar.php

命令列 linter 現在接受檔名的可變輸入以進行 lint

新增類別、介面和函數

  • 新增 DOMElement::getAttributeNames()、DOMElement::insertAdjacentElement()、DOMElement::insertAdjacentText()、DOMElement::toggleAttribute()、DOMElement::contains()、DOMNode::getRootNode()、DOMNode::isEqualNode()、::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() 方法。
  • Support for generation EC keys with custom EC parameters in OpenSSL extension.
  • 新增 INI 設定 zend.max_allowed_stack_size 來設定允許的最大堆疊大小。
  • php.ini 現在支援後備/預設值語法。
  • 匿名類別現在可以是唯讀的。

棄用和向後相容性中斷

  • 較合適的日期/時間例外。
  • 現在,將負索引 n 指派給空數組將確保下一個索引是 n 1 而不是 0。
  • range() 函數的更改。
  • Changes in re-declaration of static properties in 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()。
  • SQLite3:預設錯誤模式設定為異常。
更好的效能、更好的語法、改進的類型安全性。立即升級到 PHP 8.3!

PHP 手冊中提供了遷移指南。請參閱它以獲取新功能和向後不相容更改的詳細清單。

如果需要下載先前的版本,可以查看更多變更日誌