4.6's phpdoc: Resync with 5.0

[adriendupuis]

Question	Answer
JIRA Ticket
Versions
Edition

Resync 4.6's phpdoc tool with 5.0

• Upgrade phpDocumentor
• Use the same templates
• Use the same var names in the shell script

Changes:

• Fix tag parsing
  For example, https://github.com/ibexa/automated-translation/blob/main/src/contracts/Client/ClientInterface.php#L14 @param array{array-key, string} $configuration is probably a PHPStan only syntax but the phpstan- prefix isn't there so phpDocumentor tries to parse it:
  • Before: array{: array-key, : string}
  • After: array{array-key, string}
• Move from self to \self
• Other changes observed in Upgrade the PhpDoc version use to generate PHP API Ref (5.0) #3019

Note: it's used by the github action workflow when building PHP API Ref for 4.6
https://github.com/ibexa/documentation-developer/blob/5.0/.github/workflows/api_refs.yaml#L53-L59

Method: It's about comparing 4.6's tools/php_api_ref/ with 5.0 tools/api_refs/

git checkout 4.6
git checkout 5.0 -- tools/api_refs/api_refs.sh tools/api_refs/.phpdoc/template
diff tools/php_api_ref/phpdoc.sh tools/api_refs/api_refs.sh
diff tools/php_api_ref/.phpdoc/template tools/api_refs/.phpdoc/template
rm -r tools/api_refs

Checklist

• Text renders correctly
• Text has been checked with vale
• Description metadata is up to date
• Redirects cover removed/moved pages
• Code samples are working
• PHP code samples have been fixed with PHP CS fixer
• Added link to this PR in relevant JIRA ticket or code PR

[github-actions]

Preview of modified files: no change to preview.

[sonarqubecloud]

Quality Gate passed

Issues
2 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