# doctrine/annotations

Annotations Docblock Parser

Repository: https://github.com/doctrine/annotations
Canonical: https://ross.abutalabs.com/products/annotations
Homepage: https://www.doctrine-project.org/projects/annotations.html
Language: PHP
License: MIT
License Family: permissive
Topics: hacktoberfest
Last push: 2025-12-11T07:45:03+00:00

## Health v2 (maintenance only)
Score: 59/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 56, release rhythm 40, longevity 100
- inputs: {"age_days": 4981, "days_push": 265, "days_rel": 727, "gap_med": 0, "n_releases_24m": 2}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 6731, forks 233 (observed 2026-08-28T04:09:48.164563+00:00)

## What it is
Doctrine Annotations is a PHP library that parses docblock annotations (@-syntax in PHPDoc comments) and exposes them via reflection-based reader classes. It is feature complete and in maintenance mode, since PHP 8 native attributes replace it.

## Use cases
- parse annotations from php docblocks
- read custom annotations on php classes via reflection
- maintain legacy doctrine orm annotation mappings
- define custom annotation classes for configuration metadata
- migrate php annotations to native attributes

## When to choose
- you maintain a legacy codebase or dependency that still uses Doctrine annotations
- you must support PHP versions before 8.0 where attributes are unavailable

## When to avoid
- starting a new PHP project - use native PHP 8 attributes instead
- you need a library with active feature development
- building downstream libraries without a legacy compatibility requirement

## Facets
- artifact type: library
- maturity: maintenance
- function: parser, developer-tools
- domain: developer-tools, programming-languages, parsers
- platform: php
- tags: docblock, annotations, reflection, doctrine, php-attributes, deprecated

## Member repositories
- doctrine/annotations (main) score 59

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:48.164563+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:42:48.516152+00:00, confidence not recorded.
  - readme: https://github.com/doctrine/annotations (fetched 2026-08-28T04:09:48.164563+00:00, sha 615beee77ec2)
  - homepage: https://www.doctrine-project.org/projects/annotations.html (fetched 2026-08-29T08:38:56.587284+00:00, sha 0d3ef675d958)
  - site_page: https://www.doctrine-project.org/projects/doctrine-annotations/en/2.0/index.html (fetched 2026-08-29T08:38:56.596328+00:00, sha fd672031a3b1)
  - site_page: https://www.doctrine-project.org/projects/doctrine-annotations/en/1.14/index.html (fetched 2026-08-29T08:38:56.598283+00:00, sha 2ecfac6c303d)
  - site_page: https://www.doctrine-project.org/projects/doctrine-annotations/en/1.13/index.html (fetched 2026-08-29T08:38:56.600135+00:00, sha 446ed183a413)
  - site_page: https://www.doctrine-project.org/projects/doctrine-annotations/en/1.12/index.html (fetched 2026-08-29T08:38:56.601753+00:00, sha a2af56659221)
  - site_page: https://www.doctrine-project.org/projects/doctrine-annotations/en/1.11/index.html (fetched 2026-08-29T08:38:56.603295+00:00, sha fb9752cb6727)
  - site_page: https://www.doctrine-project.org/projects/doctrine-annotations/en/1.10/index.html (fetched 2026-08-29T08:38:56.605223+00:00, sha e2628f1b2f2f)
  - site_page: https://www.doctrine-project.org/projects/doctrine-annotations/en/1.9/index.html (fetched 2026-08-29T08:38:56.607083+00:00, sha c51690493fd4)
  - site_page: https://www.doctrine-project.org/projects/doctrine-annotations/en/1.8/index.html (fetched 2026-08-29T08:38:56.608799+00:00, sha b5dab954997a)
- Data as of 2026-08-30T08:39:29.467469+00:00.