2024 年 PHP 日本大会
    已发布！
    PHP 8.3 是 PHP 语言的一个主要更新。
    它包含许多新特性，例如类常量的显式类型声明、只读属性的深度克隆以及随机性功能的增强。和以往一样，它还包括性能改进、错误修复和常规清理。
    立即升级到 PHP 8.3！

    类型化类常量 RFC

    PHP < 8.3
    interface I {
    // 我们可能天真地认为 PHP 常量始终是字符串。
    const PHP = 'PHP 8.2';
    }

    class     Foo implements I {
    // 但实现类可以将其定义为数组。
    const PHP = [];
    }
    PHP 8.3
    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

    动态类常量获取 RFC

    PHP < 8.3
    class Foo {
    const     PHP = 'PHP 8.2';
    }

    $searchableConstant = 'PHP';

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

    $searchableConstant = 'PHP';

    var_dump(Foo::{$searchableConstant});

    新的 #[\Override] 属性 RFC

    PHP < 8.3
    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 vs tearDown)。
    PHP 8.3
    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 将确保父类或已实现接口中存在相同名称的方法。添加此属性可以明确表明覆盖父方法是故意的，并简化重构，因为将检测到已覆盖父方法的删除。

    只读属性的深度克隆 RFC

    PHP < 8.3
    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;

    // Fatal error: Cannot modify readonly property Foo::$php
    PHP 8.3
    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';
    现在可以在魔术 __clone 方法中修改一次 readonly 属性，以启用只读属性的深度克隆。

    新的 json_validate() 函数 RFC 文档

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

    return     json_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() 方法 RFC 文档

    PHP < 8.3
    // 此函数需要手动实现。
    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;
    PHP 8.3
    // 可以传入 \Random\Engine 用于设置种子，
    // 默认使用安全引擎。
    $randomizer = new \Random\Randomizer();

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

    echo     $randomDomain;
    PHP 8.2 中添加的随机扩展增加了一种新的方法，用于生成仅包含特定字节的随机字符串。此方法允许开发人员轻松生成随机标识符，例如域名和任意长度的数字字符串。

    新的Randomizer::getFloat() 和 Randomizer::nextFloat() 方法 RFC 文档

    PHP < 8.3
    // 返回介于 $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) 可能会返回上限，即 1，
    // 引入小的偏差。
    $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() 等效于
    // Randomizer::getFloat(0, 1, \Random\IntervalBoundary::ClosedOpen)。
    // 不会返回上限，即 1。
    $myBoolean = $randomizer->nextFloat() < $chanceForTrue;

    由于浮点数精度有限且存在隐式舍入，生成位于特定区间内的无偏浮点数并非易事，常用的用户端解决方案可能会生成有偏差的结果或超出请求范围的数字。

    Randomizer 还扩展了两种方法，以无偏的方式生成随机浮点数。Randomizer::getFloat() 方法使用在Drawing Random Floating-Point Numbers from an Interval. Frédéric Goualard, ACM Trans. Model. Comput. Simul., 32:3, 2022.中发表的 γ-section 算法。

    命令行代码检查器支持多个文件 PR 文档

    PHP < 8.3
    php -l foo.php bar.php foo.php 中未检测到语法错误
    PHP 8.3
    php -l foo.php bar.php foo.php 中未检测到语法错误 bar.php 中未检测到语法错误

    命令行代码检查器现在接受可变数量的文件名输入进行代码检查。

    新增类、接口和函数

    弃用和向后兼容性中断

    性能更好，语法更好，类型安全得到改进。

    立即升级到 PHP 8.3！

    要下载 PHP 8.3 的源代码，请访问下载页面。可以在PHP for Windows网站上找到 Windows 二进制文件。更改列表记录在ChangeLog中。

    PHP 手册中提供了迁移指南。请参阅它以了解新功能和向后不兼容更改的详细列表。

    To Top