我有这个代码：
/**
* Days to parse
* @var int
*/
const DAYS_TO_PARSE = 10;
...
我不认为使用@var 对常量是正确的，我没有看到任何@constant PHPDoc 标记。这样做的正确方法是什么？
【问题讨论】：
define而言：stackoverflow.com/questions/2192751/…
const FOO = 1; 也适用于类上下文之外。
The PHP-FIG suggests using @var for constants.
7.22。
@var您可以使用
@var标签来记录以下的“类型” “结构元素”：
- 常量，包括类和全局范围
- 属性
- 变量，包括全局和局部范围
语法
@var ["Type"] [element_name] [<description>]
【讨论】：
@const 将正确输出我的描述，但 @var 不会为类常量输出任何内容。
@const 是不是正确答案。
它列出的唯一“官方”位置是 phpdoc.de，但那里的规范只达到了 1.0beta，并且该站点还包含诸如 @brother 和 @sister 之类的标签，我从未见过使用过之前，因此对该网站的整体信任度有所降低；-) 事实上
标准一直是 phpDoc.org。
简而言之，即使某些非官方标准确实提到了它，但如果文档生成器不支持它，那么它就不值得使用。
@var 现在是正确的 ，一旦 PSR（上面列表中的最后一个链接）没有草稿，并且是 phpDocumentor、Doxygen、APIGen 和其他人理解 PHPDoc 的基础，那么 @ 987654330@ 是正确的，它是。@var 的继任者
【讨论】：
不需要注释常量的类型，因为类型总是：
@const 也不是 PHPDoc 标准的一部分。 PHP-FIG 建议 @var 但这不受 PHPDoc 支持，也不会添加任何您无法从声明本身推断出的信息。
因此，为了便于阅读，我建议只使用普通的 PHPDoc 文档块来记录您的常量：
class Foo
{
/**
* This is a constant.
*/
const BAR = 'bar';
}
它会在您生成 PHPDocs 时描述常量，同时保持 cmets 的清洁和可读性。
【讨论】：
我使用 Netbeans。当使用这种格式时，它将解析 phpDoc 中的全局和类常量：
/** @const Global constant description */
define('MY_CONST', 10);
class MyClass
{
/** @const Class constant description */
const MY_CONST = 10;
}
【讨论】：
@const留给Netbeans中的类常量吗？
@const。
以下proposition尊重the official documentation syntax：
class Foo
{
const
/**
* @var string Should contain a description
*/
MY_CONST1 = "1",
/**
* @var string Should contain a description
*/
MY_CONST2 = "2";
}
【讨论】：
要将它们放入 phpDoc，请使用：
@const THING
通常的构造：
@const[ant] label [description]
【讨论】：
@const!
@const 无效并且在 PHPDocumentor 中不存在。使用@var。