Jak umieścić bloki kodu PHP w PHPDoc DocBlock
Bawię się z PHPDoc i zdałem sobie sprawę, że możesz użyć znaczników, aby dodać formatowanie do DocBlock. W szczególności zauważam, że możesz użyć tyków do podświetlenia kodu wbudowanego.
Jednak nie wydaje mi się, aby dowiedzieć się, jak dodać bloki kodu do DocBlock, ponieważ użycie 4 spacji nie działa.
Próbowałem użyć<code>
i<pre>
również i gdy te znaczniki pojawiają się w wygenerowanej dokumentacji, kod wewnątrz nich jest komentowany za pomocą komentarzy HTML.
Na przykład ten DocBlock:
/**
* This is a test DocBlock
*
* <pre>
* <?php
* echo('hi');
* ?>
* </pre>
*
* @return object[] An array of objects.
*/
Generuje ten HTML:
<pre>
<!--?php echo('hi'); ?-->
</pre>
Gdzie się mylę? Jak mogę dodać blok kodu do mojego DocBlock?