当前位置：首页 > PHP

php注解实现

2026-02-28 13:46:17PHP

在PHP中，注解（Annotations）可以通过多种方式实现，以下是常见的几种方法：

使用DocBlock注释

PHP原生支持通过DocBlock注释实现简单的注解功能。这种方式通过反射API读取注释中的标记信息。

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

class MyController {
    /
     * @Route(path="/home")
     */
    public function homeAction() {
        // ...
    }
}

使用第三方库

Doctrine Annotations是PHP中最流行的注解实现库，提供了完整的注解解析功能。

安装Doctrine Annotations：

composer require doctrine/annotations

使用示例：

use Doctrine\Common\Annotations\AnnotationReader;

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

class MyController {
    /
     * @Route(path="/home")
     */
    public function homeAction() {
        // ...
    }
}

$reader = new AnnotationReader();
$reflectionMethod = new ReflectionMethod('MyController', 'homeAction');
$routeAnnotation = $reader->getMethodAnnotation($reflectionMethod, Route::class);

使用PHP8原生属性

PHP8引入了原生属性（Attributes），这是官方推荐的注解实现方式。

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

class MyController {
    #[Route(path: '/home')]
    public function homeAction() {
        // ...
    }
}

$reflectionMethod = new ReflectionMethod('MyController', 'homeAction');
$routeAttributes = $reflectionMethod->getAttributes(Route::class);
$route = $routeAttributes[0]->newInstance();

自定义注解解析器

可以创建自定义的注解解析器来处理特定的注解需求。

function parseAnnotations($docComment) {
    preg_match_all('/@(\w+)(?:\s*(?:\(\s*)?([^)]*)(?:\s*\))?)?/', $docComment, $matches);
    $annotations = [];
    foreach ($matches[1] as $i => $name) {
        $annotations[$name] = $matches[2][$i];
    }
    return $annotations;
}

框架集成

许多PHP框架（如Symfony、Laravel）内置了注解支持：

Symfony路由注解示例：

use Symfony\Component\Routing\Annotation\Route;

class MyController {
    /
     * @Route("/home", name="home")
     */
    public function home() {
        // ...
    }
}

选择哪种实现方式取决于项目需求，PHP8原生属性是最新且性能最好的选择，而Doctrine Annotations则提供了最广泛的兼容性。

php注解实现