PHP PDO::getAttribute 取不到属性时怎么判断驱动支持情况

PHP 里调用 $pdo->getAttribute() 取不到值，并不能直接说明 PDO 没有工作。这个方法面对不支持的属性时，可能返回 null，也可能由底层驱动抛出 PDOException；而某些属性本来就可能返回 false 或 0。更稳妥的判断顺序是：先确认目标驱动已加载，再确认连接实际使用的驱动，最后只探测该驱动负责的属性并记录异常。

不要用一次 getAttribute() 的 null 结果判断“驱动不可用”。驱动可用性、连接身份和属性支持是三个不同问题，分别检查才能定位。

先看属性属于哪一层

PDO 有一组通用连接属性，例如 ATTR_CASE、ATTR_ERRMODE、ATTR_DEFAULT_FETCH_MODE 和 ATTR_DRIVER_NAME；同时各驱动还可以提供专属属性。官方手册明确提醒：并不是所有数据库和驱动组合都支持全部连接属性，驱动专属属性也不应跨驱动使用。

因此，下面三件事不能混为一谈：

用三步检查判断驱动支持情况

第一步在创建连接前检查 DSN 对应的驱动名。第二步连接成功后读取 ATTR_DRIVER_NAME，确认环境没有因为配置差异落到另一个驱动。第三步才探测属性，并且只传入当前驱动应该理解的常量。

 PDO::ERRMODE_EXCEPTION,
]);

// 连接成功后再确认实际绑定的驱动。
$driver = $pdo->getAttribute(PDO::ATTR_DRIVER_NAME);
if ($driver !== 'mysql') {
    throw new RuntimeException('当前连接不是 mysql PDO 驱动');
}

getAvailableDrivers() 返回的是当前可用于 DSN 的驱动名数组；它适合做启动前检查，不负责验证数据库地址、账号或网络。连接构造失败时，PDO 本身会抛出 PDOException，这条错误应单独记录。

把 null、false 和异常分开处理

属性探测时不要写成“返回值不是 null 就支持”的单一判断。成功值可能是字符串、整数或布尔值；null 可能表示读取失败；底层驱动也可能直接报告“不支持该属性”的异常。

function probePdoAttribute(PDO $pdo, int $attribute): array
{
    try {
        // 只读取已经按驱动筛选过的属性，避免跨驱动探测。
        $value = $pdo->getAttribute($attribute);

        return [
            'supported' => $value !== null,
            'value' => $value,
            'error' => null,
        ];
    } catch (PDOException $exception) {
        // 保留异常类型和消息，便于区分驱动能力与连接故障。
        return [
            'supported' => false,
            'value' => null,
            'error' => $exception->getMessage(),
        ];
    }
}

$result = probePdoAttribute($pdo, PDO::ATTR_SERVER_VERSION);
if (!$result['supported']) {
    error_log('PDO 属性不可读：' . ($result['error'] ?? '返回 null'));
}

这里的 supported 只代表“这次读取拿到了非 null 值”。如果某个属性的合法结果本身可能是 null，就要再结合驱动文档或功能探针定义更精确的判定；不要把所有属性都套上同一个业务假设。

常见误区与稳妥的回退方案

最常见的误区是启动时遍历一串属性，遇到异常就忽略。这样会把配置错误、驱动缺失和“该属性本来不适用”混成同一类日志。更好的做法是按驱动维护小型属性清单：通用属性放一组，MySQL、PgSQL 等专属属性分别放一组，并在日志里带上驱动名和属性名。

另一个误区是把 ATTR_DRIVER_NAME 当成完整能力矩阵。它只能告诉你连接身份，不能证明 ATTR_TIMEOUT、预处理模拟或缓冲查询等每个选项都具有相同语义。遇到跨环境差异时，应以当前驱动手册为准，并在启动自检中只验证业务真正依赖的属性。

相关问答

getAttribute() 返回 null 就是驱动没装吗？

不是。驱动未加载应先看 PDO::getAvailableDrivers()；null 只说明这次属性读取没有得到值。

为什么还要读取 ATTR_DRIVER_NAME？

因为 DSN 配置和运行环境可能不一致。确认连接身份后，才能选择对应的驱动专属属性清单。

是否可以把所有 ATTR_* 都循环一遍？

不建议。驱动专属属性不能跨驱动使用，而且不支持的属性可能抛异常；只探测业务真正依赖的属性更容易维护。

发布前检查清单

• 启动前检查了目标驱动是否出现在 PDO::getAvailableDrivers() 中。
• 连接后读取并记录了 PDO::ATTR_DRIVER_NAME。
• 属性探测区分了有效值、null 和 PDOException。
• 没有把驱动专属属性放到其他驱动上，也没有用默认值掩盖能力差异。