php pdo 查询结果映射对象的核心是 pdo::fetch_class（创建新实例）和 pdo::fetch_into（复用已有对象），均要求属性为 public 且列名与属性名严格匹配；支持构造参数传递、sql 别名或 __set 实现命名转换，并需配合预处理与字段筛选保障安全。
PHP PDO 查询结果映射对象，核心在于利用 PDO::FETCH_CLASS 或 PDO::FETCH_INTO 将数据库行自动填充到 PHP 类实例中，避免手动逐字段赋值，提升可读性与可维护性。
使用 PDO::FETCH_CLASS 映射到新对象
适合有默认构造函数、字段名与数据库列名一致的类。PDO 会自动调用构造函数（可带参数），再将查询字段按名称赋值给公共属性。
- 类属性必须为 public，否则无法写入
- 数据库列名需与属性名完全匹配（大小写敏感，取决于 PDO 驱动和 MySQL 设置）
- 若构造函数需参数（如 ID），可用
setFetchMode(PDO::FETCH_CLASS, User::class, [$id])传入
class User {
public $id;
public $name;
public $email;
}
$stmt = $pdo->query("SELECT id, name, email FROM users WHERE id = 1");
$stmt->setFetchMode(PDO::FETCH_CLASS, User::class);
$user = $stmt->fetch(); // 返回 new User()，且 id/name/email 已赋值
用 PDO::FETCH_INTO 复用已有对象
当需要复用已创建的对象（如从缓存获取、或需保留原有状态），可用 PDO::FETCH_INTO。PDO 直接将数据注入目标对象的同名 public 属性，不调用构造函数。
MyBatis3.2.3帮助文档 中文CHM版
下载
MyBatis 是支持普通 SQL 查询,存储过程和高级映射的优秀持久层框架。MyBatis 消除 了几乎所有的 JDBC 代码和参数的手工设置以及结果集的检索。MyBatis 使用简单的 XML 或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plan Old Java Objects,普通的 Java 对象)映射成数据库中的记录。有需要的朋友可以下载看看
- 对象必须提前实例化
- 属性仍须为 public
- 适合批量更新对象状态，或配合工厂/容器做精细控制
$user = new User();
$user->id = 999; // 原有值不会被覆盖，除非查询结果含该字段
$stmt = $pdo->prepare("SELECT name, email FROM users WHERE id = ?");
$stmt->execute([1]);
$stmt->setFetchMode(PDO::FETCH_INTO, $user);
$stmt->fetch(); // 仅填充 name 和 email，id 保持 999
处理字段名与属性名不一致
数据库用下划线命名（created_at），PHP 类用驼峰（createdAt），PDO 默认不转换。有三种实用解法：
立即学习“PHP免费学习笔记（深入）”；
-
SQL 别名：在 SELECT 中显式别名，如
SELECT created_at AS createdAt - __set 魔术方法：在类中定义，将下划线转驼峰后赋值（注意性能与可读性权衡）
- 手动映射 + fetchAll(PDO::FETCH_ASSOC)：先取关联数组，再用循环或 array_map 构建对象（灵活性最高，适合复杂逻辑）
安全与健壮性建议
映射本身不解决 SQL 注入或类型安全问题，需配合其他实践：
- 始终使用预处理语句（
prepare/execute），勿拼接 SQL - 对关键字段（如 ID、状态）做类型校验，可在类的 setter 或构造函数中完成
- 避免映射敏感字段（如密码哈希）——查询时就用
SELECT id, name明确排除 - 考虑用
fetchObject()替代 setFetchMode + fetch，更直观
