Как правильно документировать константы PHP (определить) с помощью phpDocumentor - PullRequest
12 голосов
/ 03 февраля 2010

Как мы должны документировать (с phpDocumentor ) константы, определенные с помощью define () в PHP?

Я ничего не нашел в документации, но нашел следующий пример (который я не вижу его использования) в sample2.php:

/**#@+
 * Constants
 */
/**
 * first constant
 */
define('testing', 6);
/**
 * second constant
 */
define('anotherconstant', strlen('hello'));

Кто-нибудь может сказать мне, как лучше всего документировать константы в PHP с помощью phpDocumentor?

Ответы [ 3 ]

6 голосов
/ 03 февраля 2010

Определить операторы, как правило, только комментируют с описательным текстом, так что это в основном, как вы это комментируете.

Чтобы узнать больше о теге шаблона DocBlock, /**#@+, ознакомьтесь с страницей справочника .

1 голос
/ 02 апреля 2015
/**
*@const
*/
const testing=6;
const anotherconstant=strlen('hello');

Попробуйте, вы увидите это как постоянное

0 голосов
/ 03 февраля 2010

У вас есть на phpDoc.org элементы, которые можно задокументировать .

У вас также есть пример документирования define () (второй фрагмент кода и окружающие его абзацы).

...