如何在PhpStorm高级元数据中设置函数抛出的异常？

问题场景 #

我重写了unset()等函数，当执行失败时不再抛出PHP警告，而是抛出ErrorException，以此明确提示开发者需要处理错误。现在希望PhpStorm能提示项目内开发者：在try/catch块外调用unset()存在未处理的ErrorException。查阅PhpStorm高级元数据文档后，未找到配置函数抛出异常的方法，仅看到返回Exception的示例，因此想确认：PhpStorm是否支持在.phpstorm.meta.php文件中设置Exception及其他Throwable？若支持，该如何操作？

解决方案 #

PhpStorm支持通过.phpstorm.meta.php配置函数抛出的异常，以此触发未处理异常的代码检查提示，具体操作如下：

1. 创建/编辑项目元数据文件
   在项目根目录创建（或编辑已存在的）.phpstorm.meta.php文件，所有配置需写在PHPSTORM_META命名空间内。

2. 配置unset()函数的异常声明
   添加如下代码，声明unset()函数可能抛出ErrorException：

<?php
namespace PHPSTORM_META {
    // 覆盖原生unset()的元数据，声明其会抛出ErrorException
    override(\unset(), map([
        '' => throwable(\ErrorException::class),
    ]));
}

• override()：用于覆盖原生或自定义函数的元数据信息
• ''：表示匹配函数的所有参数组合（因为unset()可接受多个参数）
• throwable()：指定函数可能抛出的Throwable类，支持任何实现Throwable接口的类（包括Exception、ErrorException等）

3. 生效与验证
   配置完成后，PhpStorm会自动识别该元数据。当开发者在try/catch块外调用unset()时，IDE会触发「未处理的异常」代码检查提示。

补充说明 #

• 该配置仅作用于当前项目，不会影响PhpStorm全局设置
• 若需为多个自定义函数配置异常，只需在PHPSTORM_META命名空间下添加多组override()声明即可
• 元数据仅用于让IDE感知函数的异常行为，实际运行时的异常抛出逻辑仍需依赖你的自定义代码实现

内容的提问来源于stack exchange，提问作者CJ Dennis