NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #117 most downloaded on Packagist
With this component, a library can provide support for annotations via DocBlocks or otherwise retrieve information that is embedded in a DocBlock.
Latest stable
6.0.3
Last release 8 months ago
18 Mar 2026
Release timing varies
gaps range from 9 days to 6 months
Most releases are documented
notes for 36 of 57 stable releases
Nothing withdrawn
no release was ever pulled
15 years old
74 releases · first in 2012
Drag across the ruler to compare, or tap a release to open it.
PHP 8.4 fix explicit nullable deprecations by @dasginganinja in #446
Full Changelog: 6.0.2...6.0.3
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Update .gitattributes by @williamdes in #440
Full Changelog: 6.0.1...6.0.2
Fix the markup of the upgrade documentation by @stof in #436
Remove deprecated arguments by @jaapio in #430
Consult the docs for help with upgrading: https://docs.phpdoc.org/components/reflection-docblock/guides/upgrade-to-v6.html#upgrade-guide-to-v6
phpdocumentor/type-resolver from 2.x-dev to 2.0 by @mspirkov in #433Full Changelog: 5.6.6...6.0.0
fix: add escaped closing docblock to escaped sequences by @bshaffer in #453
Full Changelog: 5.6.6...5.6.7
chore(deps): allow webmozart/assert v2 by @simPod in #425
[BUGFIX] Mitigate "Using null as an array offset is deprecated" by @sbuerk in #422
What's Changed Fix deprecation on php 8.5 Full Changelog : 5.6.3...5.6.4
Fix workflow badge, tweak stable and unstable badges by @DannyvdSluijs in #410
Full Changelog: 5.6.2...5.6.3
Bump doctrine/deprecations from 1.1.3 to 1.1.4 by @dependabot in #395
Full Changelog: 5.6.1...5.6.2
Fix compatibility issue with phpstan 2.0 parser by @jaapio in https://github.com/phpDocumentor/ReflectionDocBlock/pull/394
Thanks to @Furgas for reporting this issue in #393
Full Changelog: https://github.com/phpDocumentor/ReflectionDocBlock/compare/5.6.0...5.6.1
add support for phpstan/phpdoc-parser 2 by @xabbuh in https://github.com/phpDocumentor/ReflectionDocBlock/pull/386
Full Changelog: https://github.com/phpDocumentor/ReflectionDocBlock/compare/5.5.1...5.6.0
Fixes regression introduced in 5.5.0 that triggered notices during parsing of docblocks. When the docblock contained indented lines.
Fixes regression introduced in 5.5.0 that triggered notices during parsing of docblocks. When the docblock contained indented lines.
Improved method tag parameter rendering, by now the method tag parameters are correctly rendered when transforming a docblock back to string.
Improved method tag parameter rendering, by now the method tag parameters are correctly rendered when transforming a docblock back to string.
New supported tags:
@template@template-covariant@mixin@implements & @template-implements@extends & @template-extendsThe template tags do not support all functionality needed to have full generic support as this requires some extra work. But for many situations this will already add value.
Full Changelog: https://github.com/phpDocumentor/ReflectionDocBlock/compare/5.4.1...5.5.0
In the previous release a regression was introduced regarding multiline tag descriptions. Part of the description was lost and the indenting wasn't re
In the previous release a regression was introduced regarding multiline tag descriptions. Part of the description was lost and the indenting wasn't reduced as we did before 5.4. If your application relies on docblock tags and uses the descriptions it is highly recommended to update immediately. And block version 5.4.0 from the allowed versions in your composer.json
"conflict":
"phpdocumentor/reflection-docblock": "5.4.0"
Thanks to https://github.com/phpDocumentor/ReflectionDocBlock/issues/365 by @szepeviktor and @IanDelMar
Full Changelog: https://github.com/phpDocumentor/ReflectionDocBlock/compare/5.4.0...5.4.1
This notation is now deprecated, and support will be removed in the first release of v6.
Since the beginning of this package we have been working on our own parser. Mostly regular expressions spitting each part of a docblock and processing them separately in each tag. But since static analyzers became more popular it became a lot harder to cover all the new formats of types. In type-resolver 1.7 we already started using phpstan's parser to process types. And now in this release we also cover parts of the docblock parsing process with their parser. This will make it easier to keep up with all the new changes and allows us to support more complex type formats.
We do not support all types covered by phpstan. Generics are not fully supported on all notations, we will return an InvalidTag in those cases.
We spend a lot of time to cover all the edge cases that we supported in docblocks for many years. However we also noticed that some notations do not really make sense. First notation added to the list is a @param tag without a variable.
@param MyType Here starts the description but $var is ommited
This notation is now deprecated, and support will be removed in the first release of v6.
We introduced a new factory strategy to make it possible to have more complex factories for tags and keep the implementation simple. Due to this new system of creating tags we can now support external parser to cover the body of a tag to be handled. With this new system the older system of StaticFactories has become deprecated. And will be removed in v6.
We introduced all new functionality with backward compatibility in mind. There are no interface changes being made so consumers of the library will not notice anything from the internal changes. However since we introduced a large amount of new types you might notice issues depending on your implementation. Especially when your project reads the types provided by this library.
ramsey/composer-install by @jrfnl in https://github.com/phpDocumentor/ReflectionDocBlock/pull/321Full Changelog: https://github.com/phpDocumentor/ReflectionDocBlock/compare/5.3.0...5.4.0
Remove deprecated StaticMethod and fix comment by @kea in https://github.com/phpDocumentor/ReflectionDocBlock/pull/306
@covers tag by @jrfnl in https://github.com/phpDocumentor/ReflectionDocBlock/pull/286autoload-dev directive by @jrfnl in https://github.com/phpDocumentor/ReflectionDocBlock/pull/289Full Changelog: https://github.com/phpDocumentor/ReflectionDocBlock/compare/5.2.2...5.3.0
Update Link.php #239, thanks to @Kasp42
InvalidTag::flattenExceptionBacktrace() corrupts reference arguments #249, thanks to @nikic
php 8 support, #240 thanks to @DerManoMann
Improved psalm support, #212 thanks to @orklah
@method names, #203 thanks to @danrot and @rvanvelzenSupport for tag specialization as described in PRS-5 using :, thanks to @jaapio
:, thanks to @jaapio[ to be allowed as the first character of tag body, thanks to @jaapioFix invalid return of null in standard tag factory, thanks to @jaapio
null in standard tag factory, thanks to @jaapioThis patch release contains a fix to enable serialization of the refelected docblocks. Before release 5.0.0-alpha8 it was possible to serialize the re
This patch release contains a fix to enable serialization of the refelected docblocks. Before release 5.0.0-alpha8 it was possible to serialize the result of the docblock factory. With the introduction of the InvalidTag which contained an exception this option was broken. This new version restores the option to serialize the docblock result. Which is recommended to do when you need to process a lot of docblocks for caching purposes.
InvalidTag, thanks to @jaapioThis patch release contains a breaking change for libraries/applications collecting exceptions from reflected docblocks. The library will now create a…
This patch release contains a breaking change for libraries/applications collecting exceptions from reflected docblocks. The library will now create an InvalidTag type and adds that to the output. The InvalidTag object will contain full information about the tag that could not be processed and the triggered exception during the processing of the tag.
InvalidTag tag. #198, thanks to @jaapioFixed breaking change of different exception thrown with generics, #186
This patch release fixes a BC break in the previous release of this series. Due to a change in the collection handling a different exception was thrown when a generic type hint was read. array<string, string> this library will not support the generics notation. We just made sure that we are behaving equally to what we did before.
example tag #181, thanks to @mvriel@method Invalid method name with no arguments #174 thanks to @othercorey
Prevent invalid bodies for tags to break the whole parsing process. They are now silently ignored
Allow 0 for body of generic tag description #166, #167
0 for body of generic tag description #166, #167fix init issue with example tag
fix init issue with example tag
bump type-resolver dependency to newest alpha
bump type-resolver dependency to newest alpha
* bump to PHP 7.1 minimum * add strict typing
Fixed breaking change of different exception thrown with generics, #186
This patch release fixes a BC break in the previous release of this series. Due a change in the collection handling a different exception was thrown when a generic type hint was read. array<string, string> this library will not support the generics notation. We just made sure that we are behaving equally to what we did before.
example tag #181, thanks to @mvriel@method Invalid method name with no arguments #174 thanks to @othercorey
Support for TypeResolver v1 #177 #178 thanks to @alexander-schranz
Allow 0 for body of generic tag description #166, #167
0 for body of generic tag description #166, #167Nothing published for this version
Added getTags method to Description
Namespace error in ExampleFinder
Error when fetching the content of an example tag without description
Notice when parsing annotation without description #111
Please note that this version contains several BC breaks. Type-resolver has some breaking changes when upgrading from 0.3 to 0.4. And the constructor…
Please note that this version contains several BC breaks.
Type-resolver has some breaking changes when upgrading from 0.3 to 0.4. And the constructor of the @see tag was changed to support urls and fqsen. See #104 for more details.
### Added - Nothing ### Deprecated - Nothing ### Fixed - #127 restore php 5.6 support ### Removed - Nothing ### Security - Nothing
getTags on descriptor #122 thanks to @Warxcell
Namespace error in ExampleFinder
Nothing published for this version
Release 3.2.0 fails when parsing annotations #108
Custom tag formatter support #96
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.