Attributes #[] Replacing Docblock Annotations

TL;DR

Explanation

PHP 8.0 attributes: #[Attribute] on the attribute class, #[Route('/home')] on the target. Read with Reflection: (new ReflectionClass($obj))->getAttributes(Route::class). Benefits over DocBlocks: syntactically valid PHP (checked at parse time), no regex parsing, IDE completion, static analysis support, can be classes with validation. Built-in attributes: #[Override] (8.3), #[AllowDynamicProperties] (8.2), #[Deprecated] (8.4), #[ReturnTypeWillChange], #[SensitiveParameter] (8.2). Frameworks (Symfony, Laravel) have migrated from DocBlock annotations to native attributes.

Common Misconception

Why It Matters

Common Mistakes

• Using #[] syntax in PHP < 8.0 — fatal syntax error.
• Not declaring the #[Attribute] marker on custom attribute classes.
• Using attributes without reading them via Reflection — they have no effect at runtime on their own.

Code Examples

/**
 * @Route('/home', methods={'GET'})
 * @IsGranted('ROLE_USER')
 */
class HomeController {} // Parsed with fragile regex

#[Route('/home', methods: ['GET'])]
#[IsGranted('ROLE_USER')]
class HomeController {}

// Reading attributes:
$attrs = (new \ReflectionClass(HomeController::class))
    ->getAttributes(Route::class);
foreach ($attrs as $attr) {
    $route = $attr->newInstance();
}

References

• ↗ https://www.php.net/manual/en/language.attributes.php

Tags

Related Terms