连接池 (Microsoft Drivers for PHP for SQL Server)
有关 Microsoft Drivers for PHP for SQL Server中的连接池，需要注意以下要点：
Microsoft Drivers for PHP for SQL Server 使用 ODBC 连接池。
默认情况下，连接池在 Windows 中处于启用状态。 在 Linux 和 macOS 中，只有在为 ODBC 启用了连接池的情况下才会将连接入池（请参阅启用/禁用连接池）。 启用连接池并连接到服务器时，驱动程序会在创建新的连接之前尝试使用已入池的连接。 如果在池中未找到等效连接，将创建新的连接，并将其添加到该池中。 该驱动程序将基于连接字符串的比较结果确定连接是否等效。
当使用池中的连接时，连接状态会被重置（仅限 Windows）。
关闭连接会将该连接返回到池。
若要详细了解连接池，请参阅驱动程序管理器连接池。
启用/禁用连接池
Windows
可以将连接字符串中的 ConnectionPooling 属性值设置为 false 或 0，强制驱动程序新建连接，而不是在连接池中查找等效连接。
如果在连接字符串中省略了 ConnectionPooling 属性，或将此属性值设置为 true 或 1，那么仅当连接池中没有等效连接时，驱动程序才会新建连接。
注意
多重活动结果集 (MARS) 默认启用。 当同时使用 MARS 和池时，为了让 MARS 正常工作，驱动程序需要更长的时间来重置第一个查询上的连接，从而忽略指定的任何查询超时。 不过，查询超时设置将在后续查询中生效。
如有必要，请查看操作指南：禁用多重活动结果集 (MARS)。 有关其他连接属性的信息，请参阅 Connection Options。
Linux 和 macOS
不能使用 ConnectionPooling 属性来启用/禁用连接池。
可以通过编辑 odbcinst.ini 配置文件来启用/禁用连接池。 应重新加载驱动程序，使更改生效。
将 Pooling 设置为 Yes，并且在 odbcinst.ini 文件中设置一个正 CPTimeout 值后，将启用连接池。
[ODBC]
Pooling=Yes
[ODBC Driver 17 for SQL Server]
CPTimeout=<int value>
odbcinst.ini 文件至少应类似于以下示例：
[ODBC]
Pooling=Yes
[ODBC Driver 17 for SQL Server]
Description=Microsoft ODBC Driver 17 for SQL Server
Driver=/opt/microsoft/msodbcsql17/lib64/libmsodbcsql-17.5.so.2.1
UsageCount=1
CPTimeout=120
将 odbcinst.ini 文件中的 Pooling 设置为 No 会强制使程序创建一个新连接。
[ODBC]
Pooling=No
注解
- 在 Linux 或 macOS 中，不建议将连接池与低于 2.3.7 的 unixODBC 结合使用。 如果在 odbcinst.ini 文件中启用了池，那么所有连接都将被池化，也就是说 ConnectionPooling 连接选项没有效果。 若要禁用池，请在 odbcinst.ini 文件中设置 Pooling=No，并重新加载驱动程序。
- unixODBC <= 2.3.4（Linux 和 macOS）可能不会返回正确的诊断信息，例如错误消息、警告和信息性消息
- 出于此原因，SQLSRV 和 PDO_SQLSRV 驱动程序可能无法正确地提取 long 型数据（如 xml 数据、二进制数据）作为字符串。 作为一种解决方法，可以提取 long 型数据作为数据流。 请参阅 SQLSRV 的以下示例。
<?php
$connectionInfo = array("Database"=>"test", "UID"=>"username", "PWD"=>"password");
$conn1 = sqlsrv_connect("servername", $connectionInfo);
$longSample = str_repeat("a", 8500);
$xml1 =
'<ParentXMLTag>
<ChildTag01>'.$longSample.'</ChildTag01>
</ParentXMLTag>';
// Create table and insert xml string into it
sqlsrv_query($conn1, "CREATE TABLE xml_table (field xml)");
sqlsrv_query($conn1, "INSERT into xml_table values ('$xml1')");
// retrieve the inserted xml
$column1 = getColumn($conn1);
// return the connection to the pool
sqlsrv_close($conn1);
// This connection is from the pool
$conn2 = sqlsrv_connect("servername", $connectionInfo);
$column2 = getColumn($conn2);
sqlsrv_query($conn2, "DROP TABLE xml_table");
sqlsrv_close($conn2);
function getColumn($conn)
{
$tsql = "SELECT * from xml_table";
$stmt = sqlsrv_query($conn, $tsql);
sqlsrv_fetch($stmt);
// This might fail in Linux and macOS
// $column = sqlsrv_get_field($stmt, 0, SQLSRV_PHPTYPE_STRING(SQLSRV_ENC_CHAR));
// The workaround is to fetch it as a stream
$column = sqlsrv_get_field($stmt, 0, SQLSRV_PHPTYPE_STREAM(SQLSRV_ENC_CHAR));
sqlsrv_free_stmt($stmt);
return ($column);
}
?>