PHP属性不是装饰器，仅是结构化元数据标签，必须用#[...]语法、显式继承#[Attribute]、通过反射getAttributes()读取并调用newInstance()实例化才能获取参数值。
PHP 属性（Attributes）不是装饰器，也不是运行时魔法——它只是 PHP 8.0+ 引入的、用于在代码声明上附加结构化元数据的语法糖。你写它不会自动改变行为，不调反射就等于没写。
PHP 属性必须用 #[...] 语法，不能用 @ 符号
很多人从其他语言转来，下意识写 @Route("/api") 或 @deprecated，这在 PHP 里是注释，不是属性。PHP 属性强制使用方括号语法：
-
#[Route("/api")]✅ 正确 -
@Route("/api")❌ 实际是普通注释，ReflectionAttribute根本读不到 -
#[\App\Attributes\Route("/api")]✅ 命名空间必须完整，否则类找不到
错误现象：用 getAttributes() 返回空数组，但代码明明写了 @Route——八成是用了 @ 符号。
自定义属性类必须加 #[Attribute] 构造器
光写一个类不够，必须显式标记它是属性。否则 new MyAttribute() 可以 new，但 #[MyAttribute] 会报错：
立即学习“PHP免费学习笔记（深入）”；
#[Attribute]
class Route
{
public function __construct(public string $path) {}
}
- 缺
#[Attribute]→ 解析失败，Fatal error: Attribute class "Route" is not marked with #[Attribute] -
#[Attribute(Attribute::TARGET_METHOD)]可限制只能用在方法上，避免误标到类或参数 - 不加任何参数默认允许用在所有位置（类、方法、属性、参数等），容易引发意外交互
读取属性必须靠反射 API，且要指定目标对象
属性本身不执行逻辑。你要手动通过反射拿到它，再决定怎么用：
$ref = new ReflectionMethod($controller, 'index');
$attrs = $ref->getAttributes(Route::class);
if ($attrs) {
$route = $attrs[0]->newInstance();
echo $route->path; // "/api/users"
}
-
getAttributes()返回的是ReflectionAttribute[]，不是实例，得调newInstance()才能拿到真实对象 - 如果属性构造器有必填参数（如
public function __construct(string $path)），newInstance()会抛ArgumentCountError，此时要用getArguments()提前检查 - 别在循环里反复 new
ReflectionMethod——性能差；可缓存反射结果，或用 Composer 的php-di等容器自动处理
内置属性如 #[Deprecated] 不触发警告，除非 IDE 或静态分析工具介入
#[Deprecated] 是 PHP 自带的，但它本身不抛 E_USER_DEPRECATED，也不影响运行时。它的作用仅限于：
- 被 IDE（如 PHPStorm）识别并标灰、提示“已弃用”
- 被 PHPStan / Psalm 等静态分析工具捕获并报错
- 被自定义反射逻辑读取后手动触发警告：
trigger_error("xxx is deprecated", E_USER_DEPRECATED)
所以，如果你只写了 #[Deprecated("use X instead")] 却没配工具链或没写触发逻辑，用户调用时完全无感——这点和 Python 的 @deprecated 装饰器行为完全不同。
真正难的不是写 #[Attr]，而是设计好属性生命周期：谁注册、谁读取、谁响应、错误怎么降级。很多项目卡在这一步，不是语法不会，是没想清楚元数据该在哪一层介入。
