php 8.5 引入的 #[\nodiscard] 属性用于标记函数、方法或类的返回值，提示调用者不应忽略该值。若开发者在代码中显式丢弃了被标记为 nodiscard 的返回值（例如未将其赋值给变量或未放入表达式中），php 编译器会在编译阶段抛出 error 异常，从而阻止脚本运行。这种机制强制要求处理返回值，常用于资源管理、错误状态检查等场景。
![PHP8.5的#[\NoDiscard]属性是什么？如何在编译期捕获被忽略的函数返回值？](https://img.php.cn/upload/article/001/503/042/179419842572947.png)
如何触发并捕获 NoDiscard 编译错误？
要验证 #[\NoDiscard] 的效果，只需定义一个带有该属性的函数，并在调用时直接执行而不接收返回值。PHP 8.5+ 会在解析阶段检测到这一违规操作，并终止执行。错误信息通常包含函数名及行号，便于定位。此行为是编译期强制的，无法通过运行时配置关闭。
![PHP8.5的#[\NoDiscard]属性是什么？如何在编译期捕获被忽略的函数返回值？](https://img.php.cn/upload/article/001/503/042/179419842582781.png)
function #[\NoDiscard] function createResource(): object { return new stdClass(); } // 错误：忽略返回值 createResource();如何处理被标记为 NoDiscard 的返回值以避免错误？
为避免编译错误，必须将 #[\NoDiscard] 函数的返回值赋给变量、作为参数传递给其他函数，或用于条件判断。任何“使用”该值的行为均合法，包括静默赋值给 _ 占位符（若语言支持）或明确丢弃但通过表达式包裹。关键在于确保返回值出现在表达式上下文中，而非被直接丢弃。
PHP 8.5.12
下载
修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
立即学习“PHP免费学习笔记（深入）”；
![PHP8.5的#[\NoDiscard]属性是什么？如何在编译期捕获被忽略的函数返回值？](https://img.php.cn/upload/article/001/503/042/179419842599360.png)
$res = createResource(); // 合法：赋值给变量 if (createResource()) {} // 合法：用于条件判断当 NoDiscard 函数返回 null 时是否仍需处理？
是的。即使 #[\NoDiscard] 函数返回 null 或其他假值，只要其被标记为该属性，调用者仍必须处理返回值。PHP 不区分返回值的具体类型或真假性，仅关注是否被“使用”。忽略返回 null 的 NoDiscard 函数同样会触发编译错误。这确保了无论返回值内容如何，开发者都需显式考虑其存在。
