미리 정의된 PDO 또는 드라이버 특성의 값을 검색합니다.
구문
mixed PDO::getAttribute ( $attribute )
매개 변수
$attribute: 지원되는 특성 중 하나입니다. 지원되는 특성 목록은 설명 섹션을 참조하세요.
반환 값
성공하면 연결 옵션, 미리 정의된 PDO 특성 또는 사용자 지정 드라이버 특성의 값을 반환합니다. 실패하면 null을 반환합니다.
설명
다음 표에는 지원되는 특성 목록이 나와 있습니다.
| attribute | 처리 기준 | 지원되는 값 | 설명 |
|---|---|---|---|
| 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(SQL 서버용 PHP용 Microsoft 드라이버) | 문자열 배열 | 드라이버 및 관련 라이브러리의 버전을 설명합니다. 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(SQL 서버용 PHP용 Microsoft 드라이버) | 문자열 | 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(SQL 서버용 PHP용 Microsoft 드라이버) | 3개 요소의 배열 | 현재 데이터베이스, SQL Server 버전 및 SQL Server 인스턴스를 반환합니다. |
| PDO::ATTR_SERVER_VERSION | Microsoft Drivers for PHP for SQL Server(SQL 서버용 PHP용 Microsoft 드라이버) | 문자열 | 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(SQL 서버용 PHP용 Microsoft 드라이버) | PHP 메모리 제한에 1. | 클라이언트 쪽 커서에 대한 결과 집합을 보유하는 버퍼의 크기를 구성합니다. 기본값은 10,240KB(10MB)입니다. 클라이언트 쪽 커서에 대한 자세한 내용은 커서 유형(SQLSRV 드라이버)를 참조하세요. |
| PDO::SQLSRV_ATTR_DIRECT_QUERY | Microsoft Drivers for PHP for SQL Server(SQL 서버용 PHP용 Microsoft 드라이버) | true false |
직접 또는 준비된 쿼리 실행을 지정합니다. 자세한 내용은 PDO_SQLSRV 드라이버에서 직접 문 실행 및 준비된 문 실행을 참조 하세요. |
| PDO::SQLSRV_ATTR_ENCODING | Microsoft Drivers for PHP for SQL Server(SQL 서버용 PHP용 Microsoft 드라이버) | 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(SQL 서버용 PHP용 Microsoft 드라이버) | 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(SQL 서버용 PHP용 Microsoft 드라이버) | 정수 | 쿼리 시간 제한을 초 단위로 설정합니다. 기본값은 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 ));
?>