本文介绍了如何从 Doctrine DBAL Connection 对象中安全且正确地获取底层的 PHP 原生数据库连接句柄，例如 mysqli 句柄。避免使用非官方和潜在的脆弱方法，本文提供了一种可靠的解决方案，以便在需要直接操作原生句柄时使用。
Doctrine DBAL (Database Abstraction Layer) 提供了一个抽象层，允许你使用不同的数据库系统而无需修改太多代码。然而，在某些情况下，你可能需要直接访问底层的 PHP 原生数据库连接句柄，例如 mysqli 句柄。
虽然可以通过访问私有属性的方式来获取句柄，但这是一种不推荐的做法，因为它依赖于 Doctrine DBAL 的内部实现，并且可能在未来的版本中发生变化。
正确获取原生句柄的方法
立即学习“PHP免费学习笔记（深入）”；
Doctrine DBAL 提供了一个官方且稳定的方法来获取原生句柄：
use Doctrine\DBAL\DriverManager;
// 数据库连接参数
$connectionParams = array(
'dbname' => 'your_dbname',
'user' => 'your_dbuser',
'password' => 'your_dbpass',
'host' => 'your_dbhost',
'driver' => 'mysqli', // 或者其他数据库驱动，如 'pdo_mysql'
);
// 获取 Doctrine DBAL Connection 对象
$conn = DriverManager::getConnection($connectionParams);
// 获取 mysqli 句柄
$mysqli = $conn->getWrappedConnection()->getWrappedResourceHandle();
// 现在你可以使用 $mysqli 来执行原生 mysqli 函数
var_dump($mysqli);
// 示例：执行一个原生 mysqli 查询
$result = mysqli_query($mysqli, "SELECT 1");
var_dump($result);
代码解释：
$conn->getWrappedConnection(): Doctrine\DBAL\Connection 对象封装了一个底层的连接对象。getWrappedConnection() 方法返回这个被封装的连接对象，它通常是一个驱动特定的连接类，例如 Doctrine\DBAL\Driver\PDO\Connection 或 Doctrine\DBAL\Driver\Mysqli\Connection。
->getWrappedResourceHandle(): 这个方法是驱动特定的连接类提供的，用于获取底层的 PHP 原生资源句柄。对于 mysqli 驱动，它将返回 mysqli 对象；对于 PDO 驱动，它将返回 PDO 对象。
注意事项：
- 确保你的数据库驱动支持 getWrappedResourceHandle() 方法。并非所有驱动都提供此方法。
- 获取原生句柄后，你可以使用 PHP 的原生数据库函数（例如 mysqli_* 或 PDO::*）直接与数据库交互。
- 在使用原生句柄时，请注意安全性，避免 SQL 注入等问题。
- 尽量在使用完原生句柄后，及时关闭连接，释放资源。虽然 Doctrine DBAL 会在连接对象销毁时自动关闭连接，但显式关闭连接是一个良好的编程习惯。
总结
通过 getWrappedConnection()->getWrappedResourceHandle() 方法，你可以安全且可靠地从 Doctrine DBAL Connection 对象中获取底层的 PHP 原生数据库连接句柄。这种方法避免了依赖内部实现，并且提供了更高的代码健壮性和可维护性。 始终优先考虑使用官方提供的 API，以确保你的代码与 Doctrine DBAL 的未来版本兼容。
