PHPDoc встроенный {@link} (и Netbeans)

#php #netbeans #phpdoc

#php #netbeans #phpdoc

Вопрос:

Возможно, я не совсем понимаю, но я пытаюсь заставить {@link} встроенный тег PHPDoc ссылаться на другой метод в классе (рассматриваемый docblock предназначен для метода «сокращенного псевдонима»)

На самом деле я ничего не сгенерировал для документации, но {@link} отображается как обычный текст в дескрипторе метода NetBeans. Я делаю что-то неправильно синтаксически (если я скомпилирую документацию, это сработает?) Или просто NetBeans не может поддерживать встроенный {@link} ?

Например:

 class MyClass
{

    /**
     * Shorthand alias for {@link MyClass::method()}
     *
     * @param mixed $foo
     * @param mixed $bar
     * @return mixed
     */
    public function __invoke($foo, $bar)
    {
        return $this->method($foo, $bar);
    }

    /**
     * Does stuff with $foo and $bar
     *
     * @param mixed $foo
     * @param mixed $bar
     * @return mixed
     */
    public function method($foo, $bar)
    {
        // ...
    }

}
  

Комментарии:

1. Netbeans не поддерживает все документы PHP (пока!), Вероятно, это сработает.

Ответ №1:

Скомпилируйте документацию, тогда она должна работать, иначе PHPDoc выдаст сообщение об ошибке, сообщающее вам больше.

Netbeans может не поддерживать все функции PHPDoc, вы также можете попробовать @see .

Комментарии:

1. Также смотрите проблему автозаполнения здесь: netbeans.org/bugzilla/show_bug.cgi?id=200891

2. @Nux: Спасибо за перекрестную ссылку, очень ценно!