sqlsrv_fetch_array
データの次の行を array として取得します。
構文
sqlsrv_fetch_array( resource $stmt[, int $fetchType [, row[, ]offset]])
パラメータ
$stmt: 実行されるステートメントに対応するステートメント リソース。
$fetchType [オプション]: 事前定義された定数。このパラメーターは、次の表に示す値のいずれかになります。
| 値 | 説明 |
|---|---|
SQLSRV_FETCH_NUMERIC |
データの次の行が数値配列として返されます。 |
SQLSRV_FETCH_ASSOC |
データの次の行が連想配列として返されます。配列キーは、結果セットの列名です。 |
SQLSRV_FETCH_BOTH |
データの次の行が、数値配列と連想配列の両方として返されます。これが既定値です。 |
row [オプション]: Version 1.1 で追加されました。スクロール可能なカーソルを使用する、結果セット内のアクセス対象行を指定する、次のいずれかの値です。row を指定する場合は、既定値を指定した場合でも fetchtype を明示的に指定する必要があります。
- SQLSRV_SCROLL_NEXT
- SQLSRV_SCROLL_PRIOR
- SQLSRV_SCROLL_FIRST
- SQLSRV_SCROLL_LAST
- SQLSRV_SCROLL_ABSOLUTE
- SQLSRV_SCROLL_RELATIVE
これらの値の詳細については、「カーソルの種類の指定と行の選択」を参照してください。スクロール可能なカーソルのサポートは、SQL Server Driver for PHP Version 1.1 で追加されました。
offset [オプション]: 取得する行を指定するには、SQLSRV_SCROLL_ABSOLUTE および SQLSRV_SCROLL_RELATIVE を共に使用します。結果セット内の最初のレコードは 0 です。
戻り値
データ行を取得すると array が返されます。取得する行が残っていない場合は null が返されます。エラーが発生した場合は false が返されます。
返される array は、$fetchType パラメーターの値に応じて、数値インデックス付き array、連想 array、またはその両方になります。既定では、数値キーと連想キーの両方を持つ array が返されます。返される配列内の値のデータ型は、既定の PHP データ型になります。既定の PHP データ型の詳細については、「既定の PHP データ型」を参照してください。
解説
名前のない列が返された場合、配列要素の連想キーは空の文字列 ("") となります。例として、データベース テーブルに値を挿入し、サーバーで生成される主キーを取得する、次の Transact-SQL ステートメントについて考えてみます。
INSERT INTO Production.ProductPhoto (LargePhoto) VALUES (?);
SELECT SCOPE_IDENTITY()
このステートメントの SELECT SCOPE_IDENTITY() 部分から返される結果セットを連想配列として取得した場合、返される列に名前がないため、戻り値のキーが空の文字列 ("") になります。これを回避するには、結果を数値配列として取得するか、返される列の名前を Transact-SQL ステートメントで指定します。以下は、Transact-SQL で列名を指定する 1 つの方法です。
SELECT SCOPE_IDENTITY() AS PictureID
結果セットに名前のない列が複数含まれる場合、名前のない最後の列の値が、空の文字列 ("") キーに割り当てられます。
例
次の例では、結果セットの各行を連想 array として取得します。この例では、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 and execute the query. */
$tsql = "SELECT FirstName, LastName
FROM Person.Contact
WHERE LastName='Alan'";
$stmt = sqlsrv_query( $conn, $tsql);
if( $stmt === false)
{
echo "Error in query preparation/execution.\n";
die( print_r( sqlsrv_errors(), true));
}
/* Retrieve each row as an associative array and display the results.*/
while( $row = sqlsrv_fetch_array( $stmt, SQLSRV_FETCH_ASSOC))
{
echo $row['LastName'].", ".$row['FirstName']."\n";
}
/* Free statement and connection resources. */
sqlsrv_free_stmt( $stmt);
sqlsrv_close( $conn);
?>