PHP映射数据库结果为对象的核心是PDO::FETCH_CLASS自动填充或手动构造注入；需注意NULL处理、字段名匹配、时间类型转换及反射性能优化。
PHP 中将数据库查询结果映射为对象，核心在于把一行数据自动转成一个类的实例，避免手动逐字段赋值。关键不是用 ORM 框架，而是理解底层映射逻辑——从 PDO 的 fetch 模式选择，到自定义构造、属性填充，再到类型安全与可维护性的平衡。
使用 PDO::FETCH_CLASS 直接映射
PDO 原生支持将查询结果直接实例化为指定类的对象，前提是类属性名与字段名一致（大小写敏感），且属性为 public 或有对应 setter 方法。
- 定义一个简单实体类，属性声明为 public：class User { public $id; public $name; public $email; }
- 执行查询时指定 fetch mode：$stmt->setFetchMode(PDO::FETCH_CLASS, 'User');
- 调用 $stmt->fetch() 即返回一个 User 实例，字段值已自动注入
- 若需在实例化后执行初始化逻辑（如格式化时间），可在类中定义 __construct() 或实现 PDO::FETCH_PROPS_LATE 配合 __set()
手动映射 + 构造函数注入（推荐用于复杂场景）
当字段名与属性名不一致、需要类型转换、或存在计算属性时，手动映射更可控。配合具名参数构造函数，语义清晰且利于 IDE 提示和类型检查。
- 在实体类中定义带参数的构造函数：public function __construct(int $id, string $name, ?string $email)
- 查询时用 PDO::FETCH_ASSOC 获取关联数组，再解构传参：new User(...$row) 或 new User($row['user_id'], $row['full_name'], $row['contact_email'])
- 可封装为静态工厂方法：public static function fromArray(array $data): self，内部处理键名映射与空值转换
- 搭配 PHP 8.0+ 的命名参数语法，可提升可读性：new User(id: $data['id'], name: $data['name'])
利用反射实现通用映射器（轻量级替代方案）
不想引入 Doctrine 或 Eloquent，又希望复用映射逻辑？可写一个小型映射器，基于 ReflectionClass 自动匹配字段与属性，并支持驼峰/下划线转换、类型强制转换。
立即学习“PHP免费学习笔记（深入）”；
- 创建 Mapper 类，接收查询结果数组和目标类名
- 用 ReflectionClass 获取类所有可写属性，按规则转换字段键名（如 user_name → userName）
- 对每个匹配字段，根据属性类型做基础转换（字符串转 int/bool/DateTime，null 安全处理）
- 支持跳过只读属性、忽略不存在字段、抛出类型不匹配异常（开发期友好）
注意事项与避坑点
映射看似简单，实际容易在边界情况出错。几个高频问题需提前防范：
- NULL 值处理：数据库 NULL 映射到 PHP null 是默认行为，但若属性声明为 string（非 nullable），运行时会报错；建议属性类型标注为 ?string 或在映射层统一转空字符串
- 字段别名冲突：SQL 中用 AS 改名后，需确保别名与属性名一致，或在映射器中维护字段名映射表
- 时间字段格式：MySQL 的 DATETIME 返回字符串，建议在构造函数或 fromArray 中转为 DateTimeImmutable，并设为 readonly 属性防止意外修改
- 性能考量：大量数据循环映射时，避免每次 new 反射对象；可预创建 ReflectionClass 实例并复用
