Let me teach you some harder Shpinx formatting:

Instead of

````rst
lorem ipsum, see this example:

.. code-block:: php

    // ... some PHP code
````

You can use:

````rst
lorem ipsum, see the example::

    // ... some PHP code
````

(notice the double colon at the end). Both are rendered the same (as code defaults to PHP on Symfony.com) and we prefer the last one.