WooCommerce站点通过PHP sqlsrv连接MSSQL查询无结果/仅返回部分内容的问题求解

原代码的失效根因 #

• 无错误校验逻辑：SQLSRV扩展的所有接口在执行失败时会返回false，原代码没有对连接、查询的返回值做判断，当任意环节出错时，后续函数接收到布尔值入参不会触发PHP警告，直接跳过所有循环逻辑，最终表现为完全无输出
• 默认游标配置限制：SQLSRV默认使用向前只读的服务端流式游标，每触发一次取数操作，仅从MSSQL服务器拉取约10行数据到客户端内存；如果提前手动调用一次sqlsrv_fetch_array，会消耗结果集指针的首行位置，后续循环从第二行开始遍历，很快就触达默认缓存的结果边界，最终只返回不到10条数据，完全达不到2000条的全量拉取目标
• 客户端缓存阈值不足：默认配置下SQLSRV客户端仅预留10MB空间存放查询结果，2000条带长文本描述的产品数据很容易超出缓存阈值，造成后续行拉取静默失败

正确实现代码 #

// 基础连接参数
$serverName = "你的MSSQL服务器地址";
$uid = "数据库账号";
$pwd = "数据库密码";
$databaseName = "目标数据库名";

$connectionInfo = [
    "UID" => $uid,
    "PWD" => $pwd,
    "Database" => $databaseName,
    // 放大客户端结果集缓存阈值为50MB，适配2000条产品级别的数据量
    "ClientBufferMaxKBSize" => 51200
];

$conn = sqlsrv_connect($serverName, $connectionInfo);
// 连接失败直接输出错误信息，避免静默失败
if ($conn === false) {
    // WordPress环境下可将die替换为error_log，把错误写入调试日志不打断站点运行
    die(print_r(sqlsrv_errors(), true));
}

$tsql = "SELECT * FROM eshopItemsTable";
$stmt = sqlsrv_query(
    $conn,
    $tsql,
    [],
    [
        // 指定客户端缓冲游标，查询执行时会将全量结果一次性拉取到本地内存
        "Scrollable" => SQLSRV_CURSOR_CLIENT_BUFFERED
    ]
);
// 查询失败直接输出错误信息
if ($stmt === false) {
    die(print_r(sqlsrv_errors(), true));
}

// 循环遍历全量结果，不提前手动调用取数函数，避免消耗指针位置
$allItemData = [];
while ($row = sqlsrv_fetch_array($stmt, SQLSRV_FETCH_ASSOC)) {
    $allItemData[] = $row;
}

// 释放数据库资源
sqlsrv_free_stmt($stmt);
sqlsrv_close($conn);

// 验证拉取数量，确认覆盖全量2000条记录
echo "共拉取到 " . count($allItemData) . " 条产品数据";

落地注意事项 #

• 不要在循环外提前调用sqlsrv_fetch_array：该函数会主动移动结果集的读取指针，提前调用会直接消耗首行数据，造成后续遍历的数据缺失
• 必须开启客户端缓冲游标：默认的服务端流式游标依赖和数据库的实时连接，一旦出现网络波动、PHP执行超时，就会提前中断拉取；客户端缓冲游标会在查询执行完成的瞬间把全量结果拉到本地，后续遍历完全不依赖数据库连接状态，不会出现只拉取10条就中断的问题
• 做好大数据量的内存控制：当前2000条产品数据的量级，全量拉取仅占用几MB内存，不会造成PHP内存溢出；如果后续拉取超过10万条记录，建议配合分页查询逐批拉取，避免内存耗尽
• 错误信息不要静默吞掉：没有错误捕获的SQLSRV代码在生产环境很难排查问题，所有失败场景都要记录具体的MSSQL返回错误，不要只看到“无输出”就盲目调整取数逻辑

内容的提问来源于stack exchange，提问作者netdev