Como faço para colocar blocos de código PHP em um DocBlock PHPDoc
Estou brincando com o PHPDoc e percebi que você pode usar o markdown para adicionar alguma formatação a um DocBlock. Em particular, percebo que você pode usar back carrapatos para destacar o código embutido.
No entanto, não consigo descobrir como adicionar blocos de código a um DocBlock, já que o uso de 4 espaços parece não funcionar.
Eu tentei usar<code>
e<pre>
também, e enquanto essas tags aparecem na documentação gerada, o código dentro delas é comentado com comentários HTML.
Por exemplo, este DocBlock:
/**
* This is a test DocBlock
*
* <pre>
* <?php
* echo('hi');
* ?>
* </pre>
*
* @return object[] An array of objects.
*/
Gera este HTML:
<pre>
<!--?php echo('hi'); ?-->
</pre>
Onde eu estou errando? Como posso adicionar um bloco de código ao meu DocBlock?