为什么 PhpStorm 允许使用 yield 的函数返回 null 类型？

Question

我使用 PhpStorm 在下面的函数中自动添加返回类型：

/**
 * @return \Generator|null
 */
function yieldTest(): ?\Generator
{
    yield from [1, 2, 3];
}

我的问题：为什么在\Generator 旁边添加null 选项？

我看不到返回 null 的方法，所以我想知道我是否忽略了 yield 工作方式的某些内容，或者这是否是 PhpStorm 方面的一个怪癖并且可以安全地放弃？

更新：

澄清一下 - 我在问为什么 PHPStorm 生成的返回类型为 ?\Generator。

我知道它随后将 null 添加到 php 文档 @return 标记中，因为在 ? 上。

更新 2：

这是生成额外位之前的测试文件的完整代码：

class yieldTestClass
{
    public function yieldTest()
    {
        yield from [1, 2, 3];
    }
}

这是从方法名称的上下文菜单中选择“声明返回类型”后的代码：

class yieldTestClass
{
    public function yieldTest(): ?\Generator
    {
        yield from [1, 2, 3];
    }
}

我不确定这是 IDE 中的本机功能还是来自插件，但如果是插件，我猜它会是 https://plugins.jetbrains.com/plugin/7622-php-inspections-ea-extended-

不管怎样，同样的问题。

Answer 1

? 表示“返回类型声明不是强制性的，理论上可以省略”。如果你真的返回null，PHPStorm不会做动态分析。

从 PHP 7.1.0 开始，可以通过前缀将返回值标记为可为空 带有问号 (?) 的类型名称。这意味着 函数返回指定类型或 NULL。

参考：http://php.net/manual/en/functions.returning-values.php

考虑代码示例：

    /**
     * @return Generator|null
     */
    function yieldTest(): ?\Generator
    {
        yield from [1, 2, 3];
    }

---

    /**
     * @return Generator
     */
    function yieldTest(): \Generator
    {
        yield from [1, 2, 3];
    }

Answer 2

该检查和预期修复（添加的代码）由 Php 检查（EA 扩展）插件提供。

请向插件作者报告：https://github.com/kalessil/phpinspectionsea/issues