PHP PDO 默认 fetch mode 怎么在连接级别统一设置

如果项目里每次查询都写 fetch(PDO::FETCH_ASSOC)，默认抓取模式应该放到 PDO 连接初始化处统一设置：把 PDO::ATTR_DEFAULT_FETCH_MODE 配成 PDO::FETCH_ASSOC。这样同一个连接创建出的 PDOStatement::fetch() 和 fetchAll() 默认返回关联数组；只有某条查询确实需要对象或数值索引时，再在语句级别显式覆盖。

先把默认抓取模式放进连接入口

PDO 的默认抓取模式属于连接属性，不是 SQL 语句的一部分。最稳妥的做法是在创建 PDOFactory 或数据库连接的地方准备 options 数组，再交给 PDO::__construct()。第四个参数集中放属性，后面的仓储类只负责查询，不需要重复记住返回形态。

 PDO::ERRMODE_EXCEPTION,
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
    PDO::ATTR_EMULATE_PREPARES => false,
];

try {
    // 第四个参数是连接属性集合，作用范围是这个 PDO 句柄。
    $pdo = new PDO($dsn, $username, $password, $options);
} catch (PDOException $exception) {
    // 连接失败交给上层日志和恢复策略，不直接输出凭据或 DSN。
    throw $exception;
}

这里的核心只有两项：ATTR_DEFAULT_FETCH_MODE 决定没有显式传模式时的行形态，ATTR_ERRMODE 决定错误报告方式。ATTR_EMULATE_PREPARES 是另一项连接策略，是否关闭要结合驱动和项目兼容性单独评估，不能把它误认为 fetch mode 的组成部分。

连接级默认值和语句级覆盖不是二选一

统一默认值解决的是大多数查询的重复参数问题，并不意味着所有查询都必须返回关联数组。需要对象语义时，可以在当前语句调用 fetch(PDO::FETCH_OBJ)；需要数字索引时，也可以传入 PDO::FETCH_NUM。覆盖只影响这一轮抓取，不会把连接的默认约定永久改掉。

prepare('SELECT id, email FROM users WHERE id = :id');
$statement->execute(['id' => $userId]);
$user = $statement->fetch();

// 当前查询需要对象时显式覆盖，不改变 PDO 连接的默认值。
$profileStatement = $pdo->query('SELECT id, display_name FROM profiles');
$profile = $profileStatement->fetch(PDO::FETCH_OBJ);

// fetchAll() 同样遵循连接默认值，也可以在本次调用中指定模式。
$rows = $pdo->query('SELECT id, email FROM users')->fetchAll();

排查“怎么突然变成对象了”时，先看调用点有没有传入 PDO::FETCH_OBJ、PDO::FETCH_NUM 或组合模式，再检查是不是拿到了另一个 PDO 句柄。不要只在 SQL 文本里找原因，因为抓取形态由 PDOStatement::fetch() 的参数和连接属性共同决定。

用 getAttribute() 确认当前连接真的生效

配置文件写对不等于运行时一定使用了它。连接可能经过容器、测试替身或持久化连接工厂创建，最小检查方式是读取当前句柄的属性，并用一条小查询观察返回值的键结构。PDO::getAttribute() 能读取连接属性；它适合放在开发环境诊断或连接初始化的断言中，不建议每次业务查询都调用。

getAttribute(PDO::ATTR_DEFAULT_FETCH_MODE);
if ($mode !== PDO::FETCH_ASSOC) {
    throw new LogicException('PDO 默认抓取模式未按项目约定配置');
}

// 这次 fetch() 没传参数，用来观察连接级默认值。
$row = $pdo->query('SELECT 1 AS probe')->fetch();
if (!is_array($row) || !array_key_exists('probe', $row)) {
    throw new LogicException('PDO 默认返回形态与预期不符');
}

检查时要注意：getAttribute() 读取的是当前 PDO 句柄，而不是全局配置文件；而且不同驱动对某些属性的支持范围可能不同。本文的默认 fetch mode 是通用 PDO 连接约定，驱动专属属性则应回到对应驱动文档判断。

按返回形态选择配置位置

迁移旧项目时，可以先在连接工厂统一设为 FETCH_ASSOC，再搜索所有显式 fetch(PDO::FETCH_ 调用，逐个确认哪些是有意覆盖。不要直接删除这些参数：它们可能正是某个边界查询的返回契约。

常见问题

设置 ATTR_DEFAULT_FETCH_MODE 后，fetchAll() 也会变化吗？

会。只要调用没有显式传入其他模式，当前 PDO 句柄上的默认抓取模式也会影响 fetchAll()。

能不能每次调用 fetch() 都传 FETCH_ASSOC？

可以，但这会把同一个连接约定分散到许多调用点。项目默认形态稳定时，连接级配置更容易维护；特殊查询再显式覆盖。

getAttribute() 返回的数字应该怎么理解？

它对应 PDO 的 FETCH_* 常量值，重点是和预期常量比较，不要把数字本身当成跨版本、跨语言都稳定的业务协议。

官方参考：PDO::setAttribute、PDO::__construct、PDO 预定义常量。