萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP PDO 呼叫 SQL Server 預存程序:多結果集、OUTPUT 參數與交易處理

前置需求

  • PHP `pdo_sqlsrv` / `pdo_dblib` 擴展
  • SQL Server 2012+

完整呼叫範例

<?php
$dsn = 'sqlsrv:Server=192.168.1.100;Database=MyDB';
$pdo = new PDO($dsn, 'user', 'pass', [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
]);

$procName = 'P_Test_GetMixData';
$stmt = $pdo->prepare("EXEC $procName ?, ?, ?");

// OUTPUT 參數綁定 (必須指定長度)
$returnCode = 0;
$returnMsg  = '';
$searchVal  = 'abandonship';

$stmt->bindParam(1, $returnCode, PDO::PARAM_INT | PDO::PARAM_INPUT_OUTPUT, 4);      // INT
$stmt->bindParam(2, $returnMsg,  PDO::PARAM_STR | PDO::PARAM_INPUT_OUTPUT, 100);   // VARCHAR(100)
$stmt->bindParam(3, $searchVal,  PDO::PARAM_STR);                                   // INPUT

$stmt->execute();

// 結果集 1
$rowset1 = $stmt->fetchAll(PDO::FETCH_ASSOC);
print_r($rowset1);

// 移至下一結果集
$stmt->nextRowset();
$rowset2 = $stmt->fetchAll(PDO::FETCH_ASSOC);
print_r($rowset2);

// 獲取 OUTPUT 參數 (需在所有結果集處理完後)
echo "Return Code: $returnCode\n";
echo "Return Msg : $returnMsg\n";
?>

SQL Server 預存程序範例

CREATE PROCEDURE [dbo].[P_Test_GetMixData]
    @ReturnCode INT OUTPUT,
    @ReturnMsg  VARCHAR(100) OUTPUT,
    @SearchVal  VARCHAR(50)
AS
BEGIN
    SET NOCOUNT ON;

    SET @ReturnCode = 200;
    SET @ReturnMsg  = 'Success from SP';

    SELECT * FROM _T1 WHERE col1 LIKE '%' + @SearchVal + '%';
    SELECT * FROM _T2 WHERE col1 LIKE '%' + @SearchVal + '%';
END

關鍵注意事項

  1. OUTPUT 參數必須指定長度:`bindParam(..., PDO::PARAM_INPUT_OUTPUT, $length)`,`INT` 可用 `PDO::SQLSRV_PARAM_OUT_DEFAULT_SIZE`
  2. 多結果集順序:`nextRowset()` 逐個推進,`fetchAll()` 後游標在結果集末尾
  3. OUTPUT 值獲取時機:必須在所有 `nextRowset()` 返回 false 後,變數才會被填充
  4. NOCOUNT ON:避免「受影響行數」干擾結果集枚舉
  5. 交易控制:若 SP 內含交易,外層 PHP 交易可能導致嵌套,需協調

錯誤處理模式

<?php
try {
    $stmt->execute();
    do {
        $rows = $stmt->fetchAll(PDO::FETCH_ASSOC);
        if ($rows) processRows($rows);
    } while ($stmt->nextRowset());
} catch (PDOException $e) {
    // SQLSTATE[HY000] 等
    logError($e);
    throw $e;
}
?>
copyright © 萬盛學電腦網 all rights reserved