如何：指定 PHP 資料類型

  • 發行項

下載 PHP 驅動程式

使用 PDO_SQLSRV 驅動程式時，您可以在從伺服器擷取資料時，透過 PDOStatement::bindColumn 和 PDOStatement::bindParam 來指定 PHP 資料類型。 如需詳細資訊，請參閱＜ PDOStatement::bindColumn ＞和＜ PDOStatement::bindParam ＞。

下列步驟概述如何在從伺服器擷取資料時使用 SQLSRV 驅動程式指定 PHP 資料類型：

  1. 設定及執行使用 sqlsrv_query 或結合了 sqlsrv_prepare/sqlsrv_execute 的 Transact-SQL 查詢。

  2. 讓某個資料列可透過 sqlsrv_fetch來讀取。

  3. 使用 sqlsrv_get_field ，並將所需的 PHP 資料類型指定為選用的第三個參數，以從傳回的資料列中擷取欄位資料。 若未指定選用的第三個參數，則會根據預設 PHP 類型傳回資料。 如需預設 PHP 傳回類型的相關資訊，請參閱 Default PHP Data Types。

    如需用以指定 PHP 資料類型之常數的資訊，請參閱常數 (Microsoft Drivers for PHP for SQL Server) 的＜PHPTYPE＞一節。

範例

下列範例會從 AdventureWorks 資料庫的 Production.ProductReview 資料表中擷取資料列。 在每個傳回的資料列中，ReviewDate 欄位會擷取為字串，而 Comments 欄位會擷取為資料流。 串流資料可使用 PHP fpassthru 函數來顯示。

此範例假設本機電腦上已安裝 SQL Server 和 AdventureWorks 資料庫。 從命令列執行範例時，所有輸出都會寫入至主控台。

<?php  
/*Connect to the local server using Windows Authentication and specify  
the AdventureWorks database as the database in use. */  
$serverName = "(local)";  
$connectionInfo = array( "Database"=>"AdventureWorks");  
$conn = sqlsrv_connect( $serverName, $connectionInfo);  
if( $conn === false )  
{  
     echo "Could not connect.\n";  
     die( print_r( sqlsrv_errors(), true));  
}  
  
/* Set up the Transact-SQL query. */  
$tsql = "SELECT ReviewerName,   
                ReviewDate,  
                Rating,   
                Comments   
         FROM Production.ProductReview   
         WHERE ProductID = ?   
         ORDER BY ReviewDate DESC";  
  
/* Set the parameter value. */  
$productID = 709;  
$params = array( $productID);  
  
/* Execute the query. */  
$stmt = sqlsrv_query($conn, $tsql, $params);  
if( $stmt === false )  
{  
     echo "Error in statement execution.\n";  
     die( print_r( sqlsrv_errors(), true));  
}  
  
/* Retrieve and display the data. The first and third fields are  
retrieved according to their default types, strings. The second field  
is retrieved as a string with 8-bit character encoding. The fourth  
field is retrieved as a stream with 8-bit character encoding.*/  
while ( sqlsrv_fetch( $stmt))  
{  
   echo "Name: ".sqlsrv_get_field( $stmt, 0 )."\n";  
   echo "Date: ".sqlsrv_get_field( $stmt, 1,   
                       SQLSRV_PHPTYPE_STRING( SQLSRV_ENC_CHAR))."\n";  
   echo "Rating: ".sqlsrv_get_field( $stmt, 2 )."\n";  
   echo "Comments: ";  
   $comments = sqlsrv_get_field( $stmt, 3,   
                            SQLSRV_PHPTYPE_STREAM(SQLSRV_ENC_CHAR));  
   fpassthru( $comments);  
   echo "\n";   
}  
  
/* Free statement and connection resources. */  
sqlsrv_free_stmt( $stmt);  
sqlsrv_close( $conn);  
?>

在範例中，將第二個欄位 (ReviewDate) 擷取為字串，可保留 SQL Server DATETIME 資料類型的毫秒精確度。 根據預設，SQL Server DATETIME 資料類型會擷取為 PHP DateTime 物件，因而失去毫秒精確度。

將第四個欄位 (Comments) 擷取為資料流是為了示範之用。 根據預設，SQL Server 資料類型 nvarchar(3850) 會擷取為字串，這在大多數的情況下是可接受的。

注意

sqlsrv_field_metadata 函數可用來在執行查詢之前取得欄位資訊，包括類型資訊。

另請參閱

擷取資料

關於文件中的程式碼範例

如何：使用 SQLSRV 驅動程式擷取輸出參數

如何：使用 SQLSRV 驅動程式擷取輸入和輸出參數