please check the code style of the docblock: break lines after 80 characters, have an empty line before and after `@param` and only one empty line after `@return` and only one whitespace after the exception class of the throw.

but codewise this PR is good, we need to wait and merge the one on jackalope-doctrine-dbal first