本文介绍如何通过 PHP 反射（Reflection）机制动态获取类属性所声明的预期数据类型（如 DateTime）及其可空性（nullable），适用于类型检查、序列化、文档生成等场景。
本文介绍如何通过 php 反射（reflection）机制动态获取类属性所声明的预期数据类型（如 `datetime`）及其可空性（nullable），适用于类型检查、序列化、文档生成等场景。
在现代 PHP（8.0+）中，属性支持原生类型声明（包括联合类型与可空类型），但运行时无法直接通过 $obj->start::class 或 gettype() 获取其声明类型——因为该信息仅存在于类定义的字节码元数据中，需借助反射 API 提取。
使用 ReflectionProperty 获取类型信息
PHP 的 ReflectionProperty 类提供了对类属性元信息的完整访问能力。调用 getType() 方法可返回 ReflectionNamedType（或 ReflectionUnionType）实例，进而提取类型名称与可空性状态。
以下是一个完整示例：
<?php
declare(strict_types=1);
class Event
{
public ?DateTime $start = null;
public array|string $tags = [];
public int $id;
}
// 获取指定属性的反射对象
$rp = new ReflectionProperty(Event::class, 'start');
// 检查是否具有类型声明（避免未声明类型的属性报错）
if ($rp->hasType()) {
$type = $rp->getType();
// 获取类型名称（对联合类型会返回字符串如 "array|string"）
echo "Declared type: " . $type->getName() . "\n"; // 输出：DateTime
// 判断是否为可空类型（即声明为 ?T）
echo "Is nullable: " . ($type->allowsNull() ? 'true' : 'false') . "\n"; // 输出：true
// 注意：getType()->getName() 对联合类型（如 array|string）仅返回第一个类型名，
// 如需完整联合类型，应使用 $type instanceof ReflectionUnionType 并遍历
}注意事项与最佳实践
- ✅ 必须启用严格类型模式（
declare(strict_types=1)）并使用 PHP ≥ 8.0，否则类型声明可能不被识别； - ⚠️
getType()在无类型声明的属性上会返回null，务必先调用hasType()做安全判断； - ? 对于联合类型（如
int|float或array|string），getName()仅返回首个类型名；若需完整解析，请检查$type instanceof ReflectionUnionType并使用getTypes()方法； - ?
ReflectionNamedType::getName()返回的是类型名字符串（如"DateTime"），而非类实例或 FQCN —— 若需获取实际类的反射对象，可结合class_exists()与new ReflectionClass($typeName)进一步处理； - ? 此技术常用于构建通用序列化器、API 参数验证器、IDE 插件或 PHPDoc 自动生成工具。
掌握反射获取类型的能力，是编写健壮、自省型 PHP 库的关键基础。合理封装反射逻辑（例如抽象为 TypeInspector::getPropertyType() 工具方法），可显著提升代码的可维护性与类型安全性。
立即学习“PHP免费学习笔记（深入）”；
