PHP8.5的NoDiscard属性怎么用？如何捕获被忽略的返回值？-php教程-PHP中文网

php 8.5 的 nodiscard 属性用于标记方法或函数，提示调用者不应忽略其返回值。要捕获被忽略的返回值，开发者只需在调用时将其赋值给变量或使用语言结构（如 isset()）显式处理，从而避免触发编译警告。

PHP8.5的NoDiscard属性怎么用？如何捕获被忽略的返回值？

如何定义和使用 NoDiscard 属性？

通过 #[NoDiscard] 注解修饰类方法，可以强制要求调用者处理返回值。该属性通常与返回非空类型的方法配合使用，以确保业务逻辑的完整性。

PHP8.5的NoDiscard属性怎么用？如何捕获被忽略的返回值？

<?php #[Attribute(Attribute::TARGET_METHOD)]
class NoDiscard {}

class Result {
    public function __construct(
        public readonly bool $success,
        public readonly string $message
    ) {}
}

class Service {
    #[NoDiscard]
    public function execute(): Result {
        return new Result(true, "Success");
    }
}

$service = new Service();
// 正确用法：捕获返回值
$result = $service->execute();
echo $result->message;

// 错误用法：忽略返回值会触发 Warning
// $service->execute(); ?>

如何处理被忽略的返回值警告？

当调用带有 NoDiscard 属性的方法时，如果返回值未被使用，PHP 会在运行时抛出 E_WARNING。开发者可以通过将返回值赋值给变量、使用 @ 抑制符（不推荐）或在代码审查中检查来消除警告。

PHP 8.5.12

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

下载

PHP8.5的NoDiscard属性怎么用？如何捕获被忽略的返回值？

<?php class Validator {
    #[NoDiscard]
    public function validate(string $input): bool {
        return !empty($input);
    }
}

$validator = new Validator();
$input = "test";

// 方式一：赋值给变量
$is_valid = $validator->validate($input);
if ($is_valid) {
    echo "Valid input";
}

// 方式二：直接用于条件判断
if ($validator->validate($input)) {
    echo "Input is valid";
}

// 方式三：使用 isset() 或 empty() 间接捕获
$value = $validator->validate($input);
var_dump(isset($value)); ?>