Feature : add phpdoc for return types

[momala454]

Can you please add phpdoc so phpstan and other static analyser can know the types

[rkoopmans]

Good idea @momala454 we are on it :-)