如何链接到 phpDocumentor 2 中的官方 PHP 文档？答案

【问题标题】：How to link to official PHP documentation in phpDocumentor 2?如何链接到 phpDocumentor 2 中的官方 PHP 文档？
【发布时间】：2017-01-03 04:21:17
【问题描述】：

我使用 phpDocumentor 2 来描述一些方法。我想链接到原生函数的官方 PHP 文档。我可以这样写：

/**
 * @see http://php.net/manual/en/function.ucfirst.php ucfirst
 */

这些不起作用：

/**
 * @see ucfirst
 * @see \ucfirst
 */

有没有更好的方法？我正在寻找这样的东西：

/**
 * @the-official-documentation-for ucfirst
 */

【问题讨论】：

标签： php phpdoc

【解决方案1】：

您在文档中的语法存在一些问题。您应该使用@link 而不是@see。

/**
 * @see http://php.net/manual/en/function.ucfirst.php ucfirst
 */

将您的文档代码更改为

/**
 * @link http://php.net/manual/en/function.ucfirst.php ucfirst
 */

我已经对其进行了测试，并且正在使用我的编辑器，即phpStorm

注意：它只适用于functions 和class 名称。你不能在 cmets 上使用它。

【讨论】：