[TASK] Improve php doc block for better static code analysis

This commit adds missing doc blocks and missing type
hints to existing doc blocks to help static code
analyzers like phpstan do a better job.
Also, wrong type hints have been changed.

Releases: master
Resolves: #90661
Change-Id: I966884b15e33f5668498290d3fd80b67a7ddcba0
Reviewed-on: https://review.typo3.org/c/Packages/TYPO3.CMS/+/63561


Tested-by: TYPO3com <noreply@typo3.com>
Tested-by: Susanne Moog <look@susi.dev>
Tested-by: Daniel Goerz <daniel.goerz@posteo.de>
Reviewed-by: Oliver Klee <typo3-coding@oliverklee.de>
Reviewed-by: Susanne Moog <look@susi.dev>
Reviewed-by: Daniel Goerz <daniel.goerz@posteo.de>