[ticket/12557] Fix doc block errors found by Sami for ascraeus

Companion of #2472 with more corrections for 3.1.

[PHPBB3-12557](https://tracker.phpbb.com/browse/PHPBB3-12557)
`PHP file extension` (same below)