当前位置：首页 > PHP

php 如何实现注解

2026-02-16 14:34:03PHP

在 PHP 中实现注解（Annotations）可以通过以下方法完成，通常结合第三方库或 PHP 原生反射机制实现：

使用 Doctrine Annotations 库

Doctrine Annotations 是一个广泛使用的 PHP 注解库，支持通过文档块（DocBlock）解析注解。

安装库：

composer require doctrine/annotations

定义注解类：

use Doctrine\Common\Annotations\Annotation;

/
 * @Annotation
 * @Target("CLASS")
 */
class Route {
    public $path;
}

使用注解：

/
 * @Route(path="/user")
 */
class UserController {}

解析注解：

use Doctrine\Common\Annotations\AnnotationReader;

$reader = new AnnotationReader();
$class = new ReflectionClass('UserController');
$route = $reader->getClassAnnotation($class, Route::class);
echo $route->path; // 输出 "/user"

使用 PHP 原生反射

通过 PHP 的反射机制解析 DocBlock 中的注解标记。

示例代码：

$reflection = new ReflectionClass('UserController');
$docComment = $reflection->getDocComment();

// 解析 DocBlock 中的注解
preg_match('/@Route\(path="(.*?)"\)/', $docComment, $matches);
if (!empty($matches)) {
    echo $matches[1]; // 输出 "/user"
}

使用 PHP 8 原生属性（Attributes）

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

定义属性：

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

使用属性：

#[Route(path: "/user")]
class UserController {}

解析属性：

php 如何实现注解

$reflection = new ReflectionClass('UserController');
$attributes = $reflection->getAttributes(Route::class);
foreach ($attributes as $attribute) {
    $route = $attribute->newInstance();
    echo $route->path; // 输出 "/user"
}