多年来,我一直在使用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 项目中进行过讨论?