Wie füge ich PHP-Codeblöcke in einen PHPDoc DocBlock ein?

Ich spiele mit PHPDoc herum und habe festgestellt, dass Sie mit Markdown einem DocBlock eine gewisse Formatierung hinzufügen können. Insbesondere stelle ich fest, dass Sie Back Ticks verwenden können, um Inline-Code hervorzuheben.

Ich kann jedoch nicht herausfinden, wie man einem DocBlock Codeblöcke hinzufügt, da die Verwendung von 4 Leerzeichen anscheinend nicht funktioniert.

Ich habe versucht mit<code> und<pre> Auch und während diese Tags in der generierten Dokumentation erscheinen, wird der darin enthaltene Code mit HTML-Kommentaren auskommentiert.

Zum Beispiel dieser DocBlock:

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

Erzeugt diesen HTML:

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

Wo gehe ich falsch? Wie kann ich meinem DocBlock einen Codeblock hinzufügen?

Antworten auf die Frage(4)

Ihre Antwort auf die Frage