php - @return 标记是否对返回类型声明无用

Question

phpdoc 的@return 标签对返回类型声明没用吗？换句话说，在这种情况下 @return 标签有什么好处吗:

/**
 * Example function.
 *
 * @return int
 */
public function getOne(): int
{
    return 1;
}

我们应该在 PHP7 中删除这个注解吗？

Answer 1

Should we remove this annotation in PHP7?

虽然 @return 乍一看可能看起来多余，但事实并非如此。它允许您对返回值、它的含义进行更详细的描述，而不仅仅是值的类型，这在返回更复杂的数据(即数组)的情况下可能毫无用处，因此我宁愿付出更多的努力来使我的通过使用此功能而不是删除没有实际好处的 @return 可以更好地记录。