Skip to content

Update phpdoc-parser to ^3.0 on Reflection v3 branch#721

Open
dmsnell wants to merge 8 commits intophpDocumentor:3.0from
dmsnell:fix/update-parser
Open

Update phpdoc-parser to ^3.0 on Reflection v3 branch#721
dmsnell wants to merge 8 commits intophpDocumentor:3.0from
dmsnell:fix/update-parser

Conversation

@dmsnell
Copy link

@dmsnell dmsnell commented Feb 12, 2026

This library has been in use to generate the documentation at https://developer.wordpress.org. Unfortunately, a while ago, that processed failed due to new syntax used in WordPress’ codebase. The syntax, which failed in nikic/phpdoc-parser@^1.0 is resolved in nikic/phpdoc-parser@^3.0 with minimal patching here.

Newer versions of the PHP parser require more work to update, while v4 of this library requires substantial change to the WordPress code.

This patch proposes making the minimal changes to Reflection on the old branch which allow WordPress to restart generating its documentation, and it makes it possible not only to parse the source code, but to run the process on newer versions of PHP (which due to the dependencies are currently locked at 7.2).

@dmsnell dmsnell changed the title Fix/update parser Update phpdoc-parser to ^3.0 on Reflection v3 branch Feb 18, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

Comments