PDO::getAttribute
미리 정의된 PDO 또는 드라이버 특성의 값을 검색합니다.
구문
mixed PDO::getAttribute ( $attribute )
매개 변수
$attribute: 지원되는 특성 중 하나입니다. 지원되는 특성 목록은 설명 섹션을 참조하세요.
Return Value
성공하면 연결 옵션, 미리 정의된 PDO 특성 또는 사용자 지정 드라이버 특성의 값을 반환합니다. 실패하면 null을 반환합니다.
설명
다음 표에는 지원되는 특성 목록이 나와 있습니다.
| 특성 | 처리 기준 | 지원되는 값 | 설명 |
|---|---|---|---|
| PDO::ATTR_CASE | PDO | PDO::CASE_LOWER PDO::CASE_NATURAL PDO::CASE_UPPER |
열 이름이 특정 사례에 있어야 하는지 여부를 지정합니다. PDO::CASE_LOWER 소문자 열 이름을 강제로 적용하고, PDO::CASE_NATURAL 데이터베이스에서 반환된 대로 열 이름을 그대로 두고, PDO::CASE_UPPER 열 이름을 대문자로 강제 적용합니다. 기본값은 PDO::CASE_NATURAL입니다. 이 특성은 PDO::setAttribute를 사용하여 설정할 수도 있습니다. |
| PDO::ATTR_CLIENT_VERSION | Microsoft Drivers for PHP for SQL Server | 문자열 배열 | 드라이버 및 관련 라이브러리의 버전을 설명합니다. ODBC 버전(MajorVer) 요소가 포함된 배열을 반환합니다.MinorVer), SQL Server Native Client DLL 이름 및 버전, Microsoft Drivers for PHP for SQL Server 버전(MajorVer.MinorVer.BuildNumber.수정) |
| PDO::ATTR_DEFAULT_STR_PARAM | PDO | PDO::P ARAM_STR_CHAR PDO::P ARAM_STR_NATL |
PDO::P ARAM_STR_CHAR로 설정하지 않으면 PDO::P ARAM_STR_NATL이 반환됩니다. |
| PDO::ATTR_DRIVER_NAME | PDO | 문자열 | 항상 "sqlsrv"를 반환합니다. |
| PDO::ATTR_DRIVER_VERSION | Microsoft Drivers for PHP for SQL Server | 문자열 | MICROSOFT Drivers for PHP for SQL Server 버전(MajorVer)을 나타냅니다.MinorVer.BuildNumber.수정) |
| PDO::ATTR_ERRMODE | PDO | PDO::ERRMODE_SILENT PDO::ERRMODE_WARNING PDO::ERRMODE_EXCEPTION |
드라이버에서 오류를 처리하는 방법을 지정합니다. PDO::ERRMODE_SILENT(기본값)는 오류 코드 및 정보를 설정합니다. PDO::ERRMODE_WARNING은 E_WARNING을 발생시킵니다. PDO::ERRMODE_EXCEPTION 예외가 발생합니다. 이 특성은 PDO::setAttribute를 사용하여 설정할 수도 있습니다. |
| PDO::ATTR_ORACLE_NULLS | PDO | PDO 설명서를 참조하세요. | PDO 설명서를 참조하세요. |
| PDO::ATTR_SERVER_INFO | Microsoft Drivers for PHP for SQL Server | 3개 요소의 배열 | 현재 데이터베이스, SQL Server 버전 및 SQL Server 인스턴스를 반환합니다. |
| PDO::ATTR_SERVER_VERSION | Microsoft Drivers for PHP for SQL Server | 문자열 | SQL Server 버전(Major.Minor.BuildNumber)을 나타냅니다. |
| PDO::ATTR_STRINGIFY_FETCHES | PDO | PDO 설명서를 참조하세요. | PDO 설명서를 참조하세요. |
| PDO::SQLSRV_ATTR_CLIENT_BUFFER_MAX_KB_SIZE | Microsoft Drivers for PHP for SQL Server | PHP 메모리 제한에 1. | 클라이언트 쪽 커서에 대한 결과 집합을 보유하는 버퍼의 크기를 구성합니다. 기본값은 10,240KB(10MB)입니다. 클라이언트 쪽 커서에 대한 자세한 내용은 커서 유형(SQLSRV 드라이버)를 참조하세요. |
| PDO::SQLSRV_ATTR_DIRECT_QUERY | Microsoft Drivers for PHP for SQL Server | true false |
직접 또는 준비된 쿼리 실행을 지정합니다. 자세한 내용은 PDO_SQLSRV 드라이버에서 직접 문 실행 및 준비된 문 실행을 참조 하세요. |
| PDO::SQLSRV_ATTR_ENCODING | Microsoft Drivers for PHP for SQL Server | PDO::SQLSRV_ENCODING_UTF8 PDO::SQLSRV_ENCODING_SYSTEM |
드라이버에서 서버와 통신하는 데 사용되는 문자 집합 인코딩을 지정합니다. 기본값은 PDO::SQLSRV_ENCODING_UTF8. |
| PDO::SQLSRV_ATTR_FETCHES_NUMERIC_TYPE | Microsoft Drivers for PHP for SQL Server | true 또는 false | 숫자 SQL 형식(비트, 정수, smallint, tinyint, float 또는 real)을 사용하여 열에서 숫자 인출을 처리합니다. 연결 옵션 플래그 ATTR_STRINGIFY_FETCHES 설정되면 SQLSRV_ATTR_FETCHES_NUMERIC_TYPE 있는 경우에도 반환 값은 문자열입니다. 바인딩 열에 반환된 PDO 형식이 PDO_PARAM_INT이면, SQLSRV_ATTR_FETCHES_NUMERIC_TYPE이 꺼져 있더라도 정수 열의 반환 값이 int입니다. |
| PDO::SQLSRV_ATTR_QUERY_TIMEOUT | Microsoft Drivers for PHP for SQL Server | 정수 | 쿼리 시간 제한을 초 단위로 설정합니다. 기본값은 0입니다. 즉, 드라이버가 결과를 무기한 대기합니다. 음수는 허용되지 않습니다. |
PDO는 드라이버가 다른 특성을 처리해야 하는 동안 미리 정의된 특성 중 일부를 처리합니다. 모든 사용자 지정 특성 및 연결 옵션은 드라이버에서 처리되며 지원되지 않는 특성 또는 연결 옵션은 null을 반환합니다.
Microsoft Drivers for PHP for SQL Server의 2.0 버전에서 PDO에 대한 지원이 추가되었습니다.
예시
이 예제에서는 해당 값을 변경하기 전과 후에 PDO::ATTR_ERRMODE 특성의 값을 보여줍니다.
<?php
$database = "AdventureWorks";
$conn = new PDO( "sqlsrv:server=(local) ; Database = $database", "", "");
$attributes1 = array( "ERRMODE" );
foreach ( $attributes1 as $val ) {
echo "PDO::ATTR_$val: ";
var_dump ($conn->getAttribute( constant( "PDO::ATTR_$val" ) ));
}
$conn->setAttribute( PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION );
$attributes1 = array( "ERRMODE" );
foreach ( $attributes1 as $val ) {
echo "PDO::ATTR_$val: ";
var_dump ($conn->getAttribute( constant( "PDO::ATTR_$val" ) ));
}
// An example using PDO::ATTR_CLIENT_VERSION
print_r($conn->getAttribute( PDO::ATTR_CLIENT_VERSION ));
?>