PHPackages                             doctrine/annotations - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Parsing &amp; Serialization](/categories/parsing)
4. /
5. doctrine/annotations

AbandonedLibrary[Parsing &amp; Serialization](/categories/parsing)

doctrine/annotations
====================

Docblock Annotations Parser

2.0.2(1y ago)6.7k555.6M—1.4%230[26 issues](https://github.com/doctrine/annotations/issues)20MITPHPPHP ^7.2 || ^8.0CI failing

Since Jan 12Pushed 5mo ago37 watchersCompare

[ Source](https://github.com/doctrine/annotations)[ Packagist](https://packagist.org/packages/doctrine/annotations)[ Docs](https://www.doctrine-project.org/projects/annotations.html)[ RSS](/packages/doctrine-annotations/feed)WikiDiscussions 2.0.x Synced 1mo ago

READMEChangelog (10)Dependencies (8)Versions (54)Used By (20)Security (1)

⚠️ PHP 8 introduced [attributes](https://www.php.net/manual/en/language.attributes.overview.php), which are a native replacement for annotations. As such, this library is considered feature complete, and should receive exclusively bugfixes and security fixes.

We do not recommend using this library in new projects and encourage authors of downstream libraries to offer support for attributes as an alternative to Doctrine Annotations.

Have a look at [our blog](https://www.doctrine-project.org/2022/11/04/annotations-to-attributes.html)to learn more.

Doctrine Annotations
====================

[](#doctrine-annotations)

[![Build Status](https://github.com/doctrine/annotations/workflows/Continuous%20Integration/badge.svg?label=build)](https://github.com/doctrine/persistence/actions)[![Dependency Status](https://camo.githubusercontent.com/4da2efbef61fc56c37424be1f963a22f2e7cf78c9b13c840ff38f3a83ba9d6bc/68747470733a2f2f7777772e76657273696f6e6579652e636f6d2f7061636b6167652f7068702d2d646f637472696e652d2d616e6e6f746174696f6e732f62616467652e706e67)](https://www.versioneye.com/package/php--doctrine--annotations)[![Reference Status](https://camo.githubusercontent.com/44a72b9ed5b4aa196a48befaf035ce7dca62b1e3f2a764381fc87484fa57713f/68747470733a2f2f7777772e76657273696f6e6579652e636f6d2f7068702f646f637472696e653a616e6e6f746174696f6e732f7265666572656e63655f62616467652e737667)](https://www.versioneye.com/php/doctrine:annotations/references)[![Total Downloads](https://camo.githubusercontent.com/770a6621b77dbf86507b46bcde8bf4c39242ffccd97d2c1900188bc50871392f/68747470733a2f2f706f7365722e707567782e6f72672f646f637472696e652f616e6e6f746174696f6e732f646f776e6c6f6164732e706e67)](https://packagist.org/packages/doctrine/annotations)[![Latest Stable Version](https://camo.githubusercontent.com/37633e1391d83e3451befaf8d70981c257206aafaed935a86626a003e211756b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f646f637472696e652f616e6e6f746174696f6e732e7376673f6c6162656c3d737461626c65)](https://packagist.org/packages/doctrine/annotations)

Docblock Annotations Parser library (extracted from [Doctrine Common](https://github.com/doctrine/common)).

Documentation
-------------

[](#documentation)

See the [doctrine-project website](https://www.doctrine-project.org/projects/doctrine-annotations/en/stable/index.html).

Contributing
------------

[](#contributing)

When making a pull request, make sure your changes follow the [Coding Standard Guidelines](https://www.doctrine-project.org/projects/doctrine-coding-standard/en/current/reference/index.html#introduction).

###  Health Score

74

—

ExcellentBetter than 100% of packages

Maintenance56

Moderate activity, may be stable

Popularity87

Widely adopted with strong download metrics

Community61

Healthy contributor diversity

Maturity82

Battle-tested with a long release history

 Bus Factor4

4 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~89 days

Recently: every ~260 days

Total

54

Last Release

159d ago

Major Versions

1.14.2 → 2.0.02022-12-19

1.14.3 → 2.0.12023-02-02

1.14.4 → 2.0.22024-09-05

1.14.x-dev → 2.0.x-dev2025-12-11

PHP version history (5 changes)v1.0PHP &gt;=5.3.2

v1.3.0PHP ^5.6 || ^7.0

1.5.x-devPHP ^7.1

1.10.3PHP ^7.1 || ^8.0

2.0.0PHP ^7.2 || ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/892698bb1d3f6dae0e3a44abe3e26920ddb4eb000c6c583c87b4db5e5027e166?d=identicon)[beberlei](/maintainers/beberlei)

---

Top Contributors

[![beberlei](https://avatars.githubusercontent.com/u/26936?v=4)](https://github.com/beberlei "beberlei (168 commits)")[![greg0ire](https://avatars.githubusercontent.com/u/657779?v=4)](https://github.com/greg0ire "greg0ire (158 commits)")[![Ocramius](https://avatars.githubusercontent.com/u/154256?v=4)](https://github.com/Ocramius "Ocramius (150 commits)")[![schmittjoh](https://avatars.githubusercontent.com/u/197017?v=4)](https://github.com/schmittjoh "schmittjoh (81 commits)")[![FabioBatSilva](https://avatars.githubusercontent.com/u/588172?v=4)](https://github.com/FabioBatSilva "FabioBatSilva (78 commits)")[![jwage](https://avatars.githubusercontent.com/u/97422?v=4)](https://github.com/jwage "jwage (72 commits)")[![romanb](https://avatars.githubusercontent.com/u/177309?v=4)](https://github.com/romanb "romanb (62 commits)")[![guilhermeblanco](https://avatars.githubusercontent.com/u/208883?v=4)](https://github.com/guilhermeblanco "guilhermeblanco (47 commits)")[![alcaeus](https://avatars.githubusercontent.com/u/383198?v=4)](https://github.com/alcaeus "alcaeus (44 commits)")[![chx](https://avatars.githubusercontent.com/u/193045?v=4)](https://github.com/chx "chx (25 commits)")[![derrabus](https://avatars.githubusercontent.com/u/1506493?v=4)](https://github.com/derrabus "derrabus (24 commits)")[![mikeSimonson](https://avatars.githubusercontent.com/u/907613?v=4)](https://github.com/mikeSimonson "mikeSimonson (20 commits)")[![SenseException](https://avatars.githubusercontent.com/u/859964?v=4)](https://github.com/SenseException "SenseException (14 commits)")[![lcobucci](https://avatars.githubusercontent.com/u/201963?v=4)](https://github.com/lcobucci "lcobucci (12 commits)")[![gregberge](https://avatars.githubusercontent.com/u/266302?v=4)](https://github.com/gregberge "gregberge (9 commits)")[![poldridge](https://avatars.githubusercontent.com/u/6935589?v=4)](https://github.com/poldridge "poldridge (9 commits)")[![ondrejmirtes](https://avatars.githubusercontent.com/u/104888?v=4)](https://github.com/ondrejmirtes "ondrejmirtes (7 commits)")[![Seldaek](https://avatars.githubusercontent.com/u/183678?v=4)](https://github.com/Seldaek "Seldaek (7 commits)")[![Majkl578](https://avatars.githubusercontent.com/u/144181?v=4)](https://github.com/Majkl578 "Majkl578 (7 commits)")[![malarzm](https://avatars.githubusercontent.com/u/4947711?v=4)](https://github.com/malarzm "malarzm (6 commits)")

---

Tags

hacktoberfestparserannotationsdocblock

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Psalm

Type Coverage Yes

### Embed Badge

![Health badge](/badges/doctrine-annotations/health.svg)

```
[![Health](https://phpackages.com/badges/doctrine-annotations/health.svg)](https://phpackages.com/packages/doctrine-annotations)
```

###  Alternatives

[doctrine/lexer

PHP Doctrine Lexer parser library that can be used in Top-Down, Recursive Descent Parsers.

11.2k910.8M118](/packages/doctrine-lexer)[jan-swiecki/simple-annotations

Simple annotation parser

66615.0k18](/packages/jan-swiecki-simple-annotations)[phpowermove/docblock

PHP Docblock parser and generator. An API to read and write Docblocks.

2524.0M4](/packages/phpowermove-docblock)[creof/geo-parser

Parser for geography coordinate strings

624.4M15](/packages/creof-geo-parser)[dannykopping/docblock

A simple library for parsing PHP DocBlock comments

191.8k2](/packages/dannykopping-docblock)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
