sqlsrv_fetch_array

(사용 가능한 버전 정보가 없으며 Git에만 있을 수 있음)

sqlsrv_fetch_array — 행을 배열로 반환

sqlsrv_fetch_array(
    resource $stmt,
    int $fetchType = ?,
    int $row = ?,
    int $offset = ?
): array
                

사용 가능한 다음 데이터 행을 연관 배열, 숫자 배열 또는 둘 다(기본값)로 반환합니다.


매개변수

stmt
sqlsrv_query 또는 sqlsrv_prepare에서 반환한 문 리소스입니다.
fetchType
반환할 배열 유형을 지정하는 미리 정의된 상수입니다. 가능한 값은 SQLSRV_FETCH_ASSOC, SQLSRV_FETCH_NUMERICSQLSRV_FETCH_BOTH(기본값)입니다.

동일한 이름의 여러 열이 있는 결과 집합을 사용할 때 SQLSRV_FETCH_ASSOC의 페치 유형을 사용하면 안 됩니다.

row
스크롤 가능한 커서를 사용하는 결과 집합에서 액세스할 행을 지정합니다. 가능한 값은 SQLSRV_SCROLL_NEXT, SQLSRV_SCROLL_PRIOR, SQLSRV_SCROLL_FIRST, SQLSRV_SCROLL_LAST, SQLSRV_SCROLL_ABSOLUTESQLSRV_SCROLL_RELATIVE(기본값)입니다. 이 매개변수가 지정되면 fetchType을 명시적으로 정의해야 합니다.
offset
행 매개변수가 SQLSRV_SCROLL_ABSOLUTE 또는 SQLSRV_SCROLL_RELATIVE로 설정된 경우 액세스할 행을 지정합니다. 결과 집합의 첫 번째 행에는 인덱스 0이 있습니다.

반환 값

성공하면 배열을 반환하고 반환할 행이 더 이상 없으면 null을 반환하고 오류가 발생하면 false를 반환합니다.


Examples

예제 #1 연관 배열을 검색합니다.

                  
<?php
$serverName = "serverName\instanceName";
$connectionInfo = array( "Database"=>"dbName", "UID"=>"username", "PWD"=>"password");
$conn = sqlsrv_connect( $serverName, $connectionInfo );
if( $conn === false ) {
    die( print_r( sqlsrv_errors(), true));
}

$sql = "SELECT FirstName, LastName FROM SomeTable";
$stmt = sqlsrv_query( $conn, $sql );
if( $stmt === false) {
    die( print_r( sqlsrv_errors(), true) );
}

while( $row = sqlsrv_fetch_array( $stmt, SQLSRV_FETCH_ASSOC) ) {
      echo $row['LastName'].", ".$row['FirstName']."<br />";
}

sqlsrv_free_stmt( $stmt);
?>
                  
                

예제 #2 숫자 배열을 검색합니다.

                  
<?php
$serverName = "serverName\instanceName";
$connectionInfo = array( "Database"=>"dbName", "UID"=>"username", "PWD"=>"password");
$conn = sqlsrv_connect( $serverName, $connectionInfo );
if( $conn === false ) {
    die( print_r( sqlsrv_errors(), true));
}

$sql = "SELECT FirstName, LastName FROM SomeTable";
$stmt = sqlsrv_query( $conn, $sql );
if( $stmt === false) {
    die( print_r( sqlsrv_errors(), true) );
}

while( $row = sqlsrv_fetch_array( $stmt, SQLSRV_FETCH_NUMERIC) ) {
      echo $row[0].", ".$row[1]."<br />";
}

sqlsrv_free_stmt( $stmt);
?>
                  
                

메모

fetchType을 지정하지 않거나 위의 예에서 SQLSRV_FETCH_TYPE 상수를 명시적으로 사용하면 연관 키와 숫자 키가 모두 있는 배열이 리턴됩니다.

동일한 이름으로 둘 이상의 열이 반환되면 마지막 열이 우선합니다. 필드 이름 충돌을 방지하려면 별칭을 사용하십시오.

이름이 없는 열이 반환되면 배열 요소의 연관 키는 빈 문자열("")이 됩니다.


기타

  • sqlsrv_connect() - Microsoft SQL Server 데이터베이스에 대한 연결을 엽니다.
  • sqlsrv_query() - 쿼리 준비 및 실행
  • sqlsrv_errors() - 마지막으로 수행된 SQLSRV 작업에 대한 오류 및 경고 정보를 반환합니다.
  • sqlsrv_fetch() - 결과 집합의 다음 행을 읽을 수 있도록 합니다.