PHP8.5的#[\NoDiscard]属性有什么用？-php教程-PHP中文网

php 8.5 引入的 #[\nodiscard] 属性用于标记类、接口或方法，提示开发者其返回值不应被忽略。当代码中调用带有此属性的函数且未使用返回值时，静态分析工具（如 phpstan）会发出警告，从而帮助捕获潜在的逻辑错误。

$PHP8.5的#[\NoDiscard]属性有什么用？$

如何对自定义类应用该属性

在 PHP 8.5 中，你可以将 #[\NoDiscard] 直接添加到类的声明之前。这样，任何尝试实例化该类并丢弃返回值的代码都会触发警告。这通常用于不可变值对象或资源管理类，确保开发者显式处理结果。

$PHP8.5的#[\NoDiscard]属性有什么用？$

<?php namespace App;

#[\NoDiscard]
class Result {
    public function __construct(public string $data) {}
}

// 正确用法：赋值或使用
$r = new Result("success");

// 错误用法：丢弃返回值（静态分析器会报警）
new Result("ignored");

如何对方法应用该属性

除了类级别，#[\NoDiscard] 也可以应用于特定方法。这在工厂方法或构建器模式中非常有用，强制调用者必须处理创建的对象。与类级别不同，方法级别的标记更细粒度，允许部分方法可被忽略，而关键方法不可忽略。

PHP 8.5.12

修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。

下载

$PHP8.5的#[\NoDiscard]属性有什么用？$

<?php namespace App;

class Builder {
    #[\NoDiscard]
    public function build(): Result {
        return new Result("built");
    }

    public function log(): void {
        // 此方法无返回值，不适用 NoDiscard
    }
}

$b = new Builder();

// 正确用法
$res = $b->build();

// 错误用法
$b->build();