如何:指定 PHP 資料類型
使用 PDO_SQLSRV 驅動程式時,您可以在從伺服器擷取資料時,透過 PDOStatement::bindColumn 和 PDOStatement::bindParam 來指定 PHP 資料類型。 如需詳細資訊,請參閱< PDOStatement::bindColumn >和< PDOStatement::bindParam >。
下列步驟概述如何在從伺服器擷取資料時使用 SQLSRV 驅動程式指定 PHP 資料類型:
設定及執行使用 sqlsrv_query 或結合了 sqlsrv_prepare/sqlsrv_execute 的 Transact-SQL 查詢。
讓某個資料列可透過 sqlsrv_fetch來讀取。
使用 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 函數可用來在執行查詢之前取得欄位資訊,包括類型資訊。