[ticket/10744] Type hint objects for IDE usages

PHPBB3-10744
[ticket/10744] Fix some doc blocks

PHPBB3-10744