PHP 8+或PHPDoc是否有类似Rust的must-use属性？

PHP本身没有内置的must-use语法，但可以通过PHPDoc注释或PHP 8+自定义属性配合主流IDE的静态代码分析，实现类似Rust中返回值必须使用的警告效果，避免因忽略返回值导致代码不严谨或鲁棒性下降。

1. PHPDoc注释方案 #

直接在函数的PHPDoc中添加自定义的@mustUse标签，示例如下：

/**
 * @mustUse
 * @return ImportantObject
 */
public function doSomething(): ImportantObject {
  return (new ImportantObject)->withImportantStuff();
}

PHPStorm、VSCode搭配PHP Intelephense这类主流开发工具，都支持识别自定义PHPDoc标签。只要在IDE中配置对应的静态检查规则，当开发者调用该函数却未使用返回值时，就会收到警告提示。

2. PHP 8+原生属性方案 #

利用PHP 8引入的**属性（Attribute）**特性，先自定义一个MustUse属性类：

#[Attribute(Attribute::TARGET_METHOD | Attribute::TARGET_FUNCTION)]
class MustUse {}

接着给目标函数打上这个属性标记：

#[MustUse]
public function doSomething(): ImportantObject {
  return (new ImportantObject)->withImportantStuff();
}

同样，需要在IDE中配置规则，让工具识别这个自定义属性，进而在忽略返回值时触发警告。

关键说明 #

• 无论是PHPDoc还是自定义属性，PHP语言本身不会强制执行“必须使用返回值”的规则，完全依赖IDE的静态代码分析能力
• 不同IDE的配置细节略有差异，比如PHPStorm可通过「Settings → Editor → Inspections → PHP → Unused → Unused return value」路径，添加对@mustUse标签或#[MustUse]属性的检测规则

内容的提问来源于stack exchange，提问作者Simao Gomes Viana