前置需求
- 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
關鍵注意事項
- OUTPUT 參數必須指定長度:`bindParam(..., PDO::PARAM_INPUT_OUTPUT, $length)`,`INT` 可用 `PDO::SQLSRV_PARAM_OUT_DEFAULT_SIZE`
- 多結果集順序:`nextRowset()` 逐個推進,`fetchAll()` 後游標在結果集末尾
- OUTPUT 值獲取時機:必須在所有 `nextRowset()` 返回 false 後,變數才會被填充
- NOCOUNT ON:避免「受影響行數」干擾結果集枚舉
- 交易控制:若 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;
}
?>