PHP PDO 连接属性读取与驱动差异处理

PHP 的 PDO 连接对象可以用 getAttribute() 读取连接属性，但“能调用方法”和“当前驱动支持这个属性”是两件事。稳定的做法是先识别驱动，再读取通用属性；遇到驱动专属属性时，把 null 或 PDOException 当成兼容分支处理。

官方地址：https://www.php.net/manual/en/pdo.getattribute.php

本文只讨论连接属性，不把 PDOStatement 的属性混进来，也不讨论 SQL 本身的性能问题。

先确认你读取的到底是哪一类属性

PDO::getAttribute() 接收一个 PDO::ATTR_* 常量，返回当前数据库连接的属性值。常见的通用属性包括驱动名、错误模式、默认提取模式、持久连接状态等；语句对象则应使用 PDOStatement::getAttribute()。

官方手册特别提醒：不同数据库和驱动组合不一定支持全部连接属性。成功读取时会得到属性值，失败时可能得到 null，底层驱动不支持时也可能抛出 PDOException。因此不能把一次 MySQL 连接上的读取结果直接当成所有 PDO 驱动的共同契约。

先读取驱动名，再决定属性范围

跨环境诊断时，第一项值得读取的是 PDO::ATTR_DRIVER_NAME。它能把连接标识为 mysql、sqlite、pgsql 等驱动名，后续代码就可以按驱动做有限分支，而不是凭 DSN 字符串猜测。

 PDO::ERRMODE_EXCEPTION,
]);

// 先读取通用属性，得到当前连接实际使用的驱动名称。
$driver = $pdo->getAttribute(PDO::ATTR_DRIVER_NAME);

// 只针对确实需要的驱动读取专属属性，避免跨驱动直接调用。
if ($driver === 'mysql') {
    $emulate = $pdo->getAttribute(PDO::ATTR_EMULATE_PREPARES);
    // 这里保留 bool/int 的原始结果，展示层再做格式化。
}
?>

PDO::getAvailableDrivers() 可以告诉你当前 PHP 环境加载了哪些 PDO 驱动，但它表示“环境可用的驱动”，不等于某个连接已经使用该驱动。连接级判断仍应以 ATTR_DRIVER_NAME 的结果为准。

不支持的属性要有明确的兼容结果

兼容层不要把所有失败都转换成字符串，也不要用一个默认值掩盖“驱动不支持”和“属性值本来就是空”这两种情况。可以把结果统一成“值、是否支持、错误信息”三个字段，调用方据此决定是否展示诊断信息。

getAttribute($attribute);

        // null 可能表示驱动没有返回该属性，因此单独记录 supported。
        return [
            'supported' => $value !== null,
            'value' => $value,
            'error' => null,
        ];
    } catch (PDOException $e) {
        // 驱动拒绝属性时保留异常文本，避免误报成一个正常默认值。
        return [
            'supported' => false,
            'value' => null,
            'error' => $e->getMessage(),
        ];
    }
}

$info = readPdoAttribute($pdo, PDO::ATTR_SERVER_VERSION);
if (!$info['supported']) {
    // 兼容路径只提示“当前驱动不可用”，不阻断主业务查询。
    error_log('PDO server version attribute is unavailable');
}
?>

如果业务必须依赖某项能力，应把 supported 作为启动检查或功能开关的依据；如果只是日志增强，则可以记录错误后继续。这样既能保留差异信息，也不会因为某个可选属性让主流程失效。

通用属性与驱动专属属性怎么分

可以把属性分成三层来维护：

这里的“通用”只表示 PDO 手册定义了共同语义，并不保证每一个驱动都实现全部属性。驱动专属属性更不能拿到另一种驱动上复用；若需要跨数据库运行，建议把属性读取封装在驱动适配器中。

上线前的三个检查点

• 先记录 ATTR_DRIVER_NAME，确认测试环境和生产环境的驱动没有被误判。
• 为每一个可选属性保留 null 与 PDOException 分支，不把缺失能力伪装成固定值。
• 把业务必需属性和日志增强属性分开：前者在启动检查中失败即提示，后者失败只记录兼容信息。

常见问题

getAttribute() 返回 null 就一定是连接失败吗？

不一定。连接可能已经建立，只是当前驱动没有为请求的属性返回值。连接建立失败通常会在构造 PDO 时按错误模式抛出异常，应分别处理。

为什么同一个属性在不同机器上类型不同？

驱动实现和 PHP 版本可能影响返回类型。兼容层应按官方属性语义判断，并在展示或序列化前统一格式，而不是依赖某次环境中的具体类型。

可以先调用 getAvailableDrivers() 再选属性吗？

它适合检查扩展是否加载，但不能替代连接级驱动识别。真正读取属性前，仍应以 ATTR_DRIVER_NAME 确认当前 PDO 连接。

总结：PDO 属性读取的关键不是记住更多常量，而是建立“先识别驱动、再读取属性、最后归一化失败结果”的边界。这样同一套诊断代码才能在 MySQL、SQLite、PostgreSQL 等不同 PDO 驱动之间保持可解释的行为。