当前位置：首页 > PHP

php注解实现

2026-01-29 16:31:58PHP

PHP 注解实现方法

PHP 注解（Annotations）是通过文档块（DocBlock）中的注释来实现的，通常结合反射（Reflection）来解析和处理注解。以下是实现注解的几种常见方法：

使用 Doctrine Annotations 库

Doctrine Annotations 是一个流行的 PHP 注解解析库，广泛用于 Symfony 和 Doctrine ORM 等框架。

安装 Doctrine Annotations：

composer require doctrine/annotations

定义注解类：

use Doctrine\Common\Annotations\Annotation;

/
 * @Annotation
 * @Target("CLASS")
 */
class MyAnnotation
{
    public $value;
}

使用注解：

/
 * @MyAnnotation("example")
 */
class MyClass
{
    // ...
}

解析注解：

php注解实现

use Doctrine\Common\Annotations\AnnotationReader;

$reader = new AnnotationReader();
$reflectionClass = new ReflectionClass('MyClass');
$annotation = $reader->getClassAnnotation($reflectionClass, MyAnnotation::class);

echo $annotation->value; // 输出 "example"

使用 PHP 原生反射和解析

如果不想依赖第三方库，可以通过 PHP 的反射和正则表达式手动解析注解。

定义注解：

/
 * @Route("/path", methods={"GET"})
 */
class MyController
{
    // ...
}

解析注解：

php注解实现

$reflectionClass = new ReflectionClass('MyController');
$docComment = $reflectionClass->getDocComment();

// 使用正则解析
preg_match('/@Route\("([^"]+)", methods={([^}]+)}\)/', $docComment, $matches);
$path = $matches[1] ?? null;
$methods = json_decode('{' . $matches[2] . '}');

var_dump($path, $methods);

使用 PHP 8 原生属性（Attributes）

PHP 8 引入了原生属性（Attributes），可以替代传统的注解。

定义属性：

#[Attribute(Attribute::TARGET_CLASS)]
class MyAttribute
{
    public function __construct(public string $value) {}
}

使用属性：

#[MyAttribute("example")]
class MyClass
{
    // ...
}

解析属性：

$reflectionClass = new ReflectionClass('MyClass');
$attributes = $reflectionClass->getAttributes(MyAttribute::class);

foreach ($attributes as $attribute) {
    $instance = $attribute->newInstance();
    echo $instance->value; // 输出 "example"
}