Я играю с PHPDoc и понял, что вы можете использовать уценку, чтобы добавить форматирование в DocBlock. В частности, я заметил, что вы можете использовать обратные галочки для выделения встроенного кода.

Однако я не могу понять, как добавить блоки кода в DocBlock, так как использование 4 пробелов, похоже, не работает.

Я пытался использовать<code> а также<pre> и хотя эти теги появляются в сгенерированной документации, код внутри них комментируется HTML-комментариями.

Например, этот DocBlock:

/**
 * This is a test DocBlock
 *
 * <pre>
 *     <?php
 *         echo('hi');
 *     ?>
 * </pre>
 *
 * @return object[] An array of objects.
 */

Создает этот HTML:

<pre>
    <!--?php echo('hi'); ?-->
</pre>

Куда я иду не так? Как я могу добавить блок кода в мой DocBlock?