phpDocumentor/ReflectionDocBlock
This system is a PHP library for parsing and rendering PHPDoc comments (DocBlocks) from source code. It provides a modern, strict-typed architecture for extracting structured information—such as types, parameters, and descriptions—from PHP code comments. The library supports various DocBlock tags (like @param, @return, @method) and offers configurable formatters for generating plain-text documentation. It relies on the PHPStan parser for robust type and tag parsing, replacing older, less reliable regex-based approaches.
67.0
Adequate · 2 August 2026
4.7k
lines of production code
PHP
primary language
3
bus factor · 78 authors in all
3
measurements over time
How it got here
2012 · DocBlock reflection cleanup and modernization
This period focused on refactoring the DocBlock reflection layer by removing legacy classes and their associated tests, while simultaneously updating dependencies to support PHP 7.4/8.0+ and modernizing the project's build and static analysis tooling.
7 changes
2015 · DocBlock refactoring and testing
This period focused on a comprehensive refactoring of the DocBlock parsing and rendering architecture, introducing strict typing, modular components, and modern PHP features. The work included rewriting tag implementations, adding new formatters for output control, and establishing extensive unit and integration test coverage for these changes.
9 changes
2020–2022 · PHPStan-based DocBlock parsing
The codebase was refactored to use the PHPStan PhpDocParser for handling DocBlock tags, introducing a new factory pattern and corresponding unit tests. This shift was accompanied by the addition of specific exception classes to improve error handling and test coverage for custom tag implementations.
4 changes
Survey your own repository
phpDocumentor/ReflectionDocBlock was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point the surveyor at a repository you know and see whether you agree with it.
About this page
- The description of this project is derived from its own commit history, not from its README.
- The score is its highest published measurement, taken on 2 August 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 7bae67520a — the exact code this score is about.
- Scored under rubric rubric-2026.08.18. Score the same commit under that rubric and you get the same number.