Add Gotenberg option generateDocumentOutline to $options array

[muratbinerbay]

This should allow creating a document outline based on the HTML heading structure in the PDF file

[kingjia90]

Thank you for the contribution!

Unfortunately, this PR cannot be merged as is, this generateDocumentOutline addition is quite recent (Nov 2024), on Pimcore side it needs to be in a minor release 1.x and the minimum required composer version have to be bumped to from ^2.2 to ^2.10. Another challenge would be to exclude/ignore it in case of gotenberg-php 1.x is required

See also
https://github.com/gotenberg/gotenberg-php/releases/tag/v2.10.0
https://github.com/gotenberg/gotenberg/releases/tag/v8.14.0
gotenberg/gotenberg#1044

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[muratbinerbay]

@kingjia90 thank you for checking!

I did not realise the exception for gotenberg-php because we were already on a recent version. But for gotenberg itself, it looks like that will ignore flag if it running a version older than 8.14.0.

Maybe a method_exists check would be more convenient than bumping composer versions for a new flag? It would also make it safer to support new flags in the future.

[kingjia90]

maybe let's move generateDocumentOutline outside the $options array and have a standalone IF block for it with a comment on the fact that on v1 it's not supported, it would be easier to remember for future clean up when for example dropping support to v1 and to avoid checking methodExists on the ones that are surely true