当前位置：首页 > PHP

php 实现注解

2026-02-28 12:18:47PHP

PHP 实现注解的方法

在 PHP 中，注解（Annotations）通常通过文档块（DocBlocks）和反射（Reflection）来实现。PHP 本身不直接支持注解，但可以通过第三方库或自定义代码实现类似功能。

使用 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
{
}

解析注解：

use Doctrine\Common\Annotations\AnnotationReader;

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

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

自定义注解解析

如果不使用第三方库，可以通过 PHP 的反射机制和正则表达式自定义注解解析。

定义注解：

/
 * @Route("/path")
 */
class MyController
{
}

解析注解：

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

if (preg_match('/@Route\("([^"]+)"\)/', $docComment, $matches)) {
    $path = $matches[1];
    echo "Route path: " . $path;
}

使用 PHP 8 原生属性

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

定义属性：

#[Attribute]
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"
}