时间戳

首页 > 解决方案 > 内联类型注释的状态

php - 内联类型注释的状态

问题描述

多年来，我一直在使用Eclipse/Zend 类型注释来帮助编辑器的代码智能感知，而常规的 phpDocumentor 文档块还不够：

/* @var $db PDO */
$db->exec('DELETE FROM pending_jobs');

......但我不确定它们现在是否被广泛使用。

PHP-FIG在PSR-5 PHPDoc Standard的上下文中为这个特性提出了一个新的语法：

/** @var PDO $db Database connection. */

…但是 PSR-5 被列为废弃并且据我所知 phpDocumentor还没有实现它。

PhpStorm 只支持所有变体：

/* @var $db PDO */
/* @var PDO $db */
/** @var PDO $db */
/** @var $db PDO */

甚至 Zend Framework 代码库似乎都混合了它们。

是否有广泛使用的语法或接近事实标准的东西？是否在一些主要的 PHP 项目中进行过讨论？

标签： phpannotationsphpdocumentor2

解决方案

推荐阅读