PHP sqlsrv调用含表输出与变量输出的存储过程报错问题排查

兼容性结论 #

sqlsrv驱动对同时返回结果集和输出参数的存储过程没有根本性兼容问题，你的问题源于调用方式不符合SQL Server存储过程的参数处理要求。

错误原因排查 #

首先，sqlsrv_query返回false时，必须先获取具体错误信息才能定位问题，替换原有代码添加错误捕获：

$SQLStmt = "EXEC Postcodetools.dbo.usp_QueryMileageDataFromPostcodes @Postcode1='BH21 2SR',@Postcode2='HP234AB';";
$RS_Result01 = sqlsrv_query($conn01,$SQLStmt);
if ($RS_Result01 === false) {
    die(print_r(sqlsrv_errors(), true));
}

大概率会得到类似"未声明输出参数"的错误——因为你的存储过程定义了两个OUTPUT参数，直接用EXEC字符串调用时，SQL Server会认为你未处理这些输出参数，导致执行失败。

正确调用方式（获取结果集+输出参数） #

必须使用参数绑定的方式明确标记输出参数，以下是完整可运行的代码示例：

// 1. 定义存储过程调用的占位符格式
$procedureCall = "{call Postcodetools.dbo.usp_QueryMileageDataFromPostcodes (?, ?, ?, ?, ?, ?, ?, ?)}";

// 2. 准备参数数组：前6个为输入参数，后2个为输出参数
$params = [
    'BH21 2SR',                  // @Postcode1
    'HP234AB',                   // @Postcode2
    null,                        // @Latitude1（默认NULL）
    null,                        // @Longitude1（默认NULL）
    null,                        // @Latitude2（默认NULL）
    null,                        // @Longitude2（默认NULL）
    [null, SQLSRV_PARAM_OUT],    // @OutputDistanceMiles OUTPUT
    [null, SQLSRV_PARAM_OUT]     // @OutputDistanceKilometers OUTPUT
];

// 3. 执行存储过程
$stmt = sqlsrv_query($conn01, $procedureCall, $params);
if ($stmt === false) {
    die(print_r(sqlsrv_errors(), true));
}

// 4. 获取表结果集
$tableResult = [];
while ($row = sqlsrv_fetch_array($stmt, SQLSRV_FETCH_ASSOC)) {
    $tableResult[] = $row;
}

// 5. 切换到下一个结果集（确保输出参数值被正确填充）
sqlsrv_next_result($stmt);

// 6. 获取输出参数的值
$outputMiles = $params[6][0];
$outputKm = $params[7][0];

// 验证结果
print_r($tableResult);
echo "计算英里数：" . $outputMiles . "<br>";
echo "计算公里数：" . $outputKm;

关键说明 #

• 使用{call ...}的语法是ODBC调用存储过程的标准格式，sqlsrv驱动对这种格式的参数处理更可靠。
• 必须显式标记OUTPUT参数，否则SQL Server会拒绝执行存储过程。
• 调用sqlsrv_next_result是为了确保驱动完成所有结果集的处理，从而正确填充输出参数的值。

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