PDO::getAttribute

Pobieranie sterownika PHP

Pobiera wartość zdefiniowanego wcześniej PDO lub atrybutu sterownika.

Syntax

  
mixed PDO::getAttribute ( $attribute )  

Parametry

$attribute: Jeden z wspieranych atrybutów. Zobacz sekcję Uwagi dla listy wspieranych atrybutów.

Wartość zwracana

Po sukcesie zwraca wartość opcji połączenia, zdefiniowanego wcześniej atrybutu PDO lub niestandardowego sterownika. W przypadku niepowodzenia zwraca wartość zerowa.

Remarks

Poniższa tabela zawiera listę wspieranych atrybutów.

Attribute Przetworzone przez Obsługiwane wartości Description
PDO::ATTR_CASE PDO PDO::CASE_LOWER

PDO::CASE_NATURAL

PDO::CASE_UPPER
Określa, czy nazwy kolumn powinny być w konkretnym przypadku. PDO::CASE_LOWER wymusza używanie nazw kolumn małymi literami, PDO::CASE_NATURAL pozostawia nazwę kolumny w stanie zwróconym przez bazę danych, a PDO::CASE_UPPER wymusza przyjmowanie nazw kolumn na wielkie litery.

Domyślnie to PDO::CASE_NATURAL.

Ten atrybut można również ustawić za pomocą PDO::setAttribute.
PDO::ATTR_CLIENT_VERSION Sterowniki firmy Microsoft dla języka PHP dla programu SQL Server Tablica łańcuchów znaków Opisuje wersje sterownika oraz powiązane biblioteki. Zwraca tablicę z następującymi elementami: wersja ODBC (MajorVer.MinorVer), nazwa i wersja natywnego klienta DLL SQL Server, sterowniki Microsoft dla PHP dla wersji SQL Server (MajorVer.MinorVer. Numer Build.Poprawka)
PDO::ATTR_DEFAULT_STR_PARAM PDO PDO::P ARAM_STR_CHAR

PDO::P ARAM_STR_NATL
Jeśli nie jest ustawione na PDO::P ARAM_STR_CHAR, ZWRACA SIĘ PDO::P ARAM_STR_NATL.
PDO::ATTR_DRIVER_NAME PDO String Zawsze zwraca "sqlsrv".
PDO::ATTR_DRIVER_VERSION Sterowniki firmy Microsoft dla języka PHP dla programu SQL Server String Wskazuje sterowniki Microsoft dla PHP dla wersji SQL Server (MajorVer.MinorVer. Numer Build.Poprawka)
PDO::ATTR_ERRMODE PDO PDO::ERRMODE_SILENT

PDO::ERRMODE_WARNING

PDO::ERRMODE_EXCEPTION
Określa, jak sterownik powinien obsługiwać awarie.

PDO::ERRMODE_SILENT (domyślnie) ustala kody błędów i informacje.

PDO::ERRMODE_WARNING podnosi E_WARNING.

PDO::ERRMODE_EXCEPTION wyjątek.

Ten atrybut można również ustawić za pomocą PDO::setAttribute.
PDO::ATTR_ORACLE_NULLS PDO Zobacz dokumentację PDO. Zobacz dokumentację PDO.
PDO::ATTR_SERVER_INFO Sterowniki firmy Microsoft dla języka PHP dla programu SQL Server Tablica 3 elementów Zwraca aktualną bazę danych, wersję SQL Server oraz instancję SQL Server.
PDO::ATTR_SERVER_VERSION Sterowniki firmy Microsoft dla języka PHP dla programu SQL Server String Wskazuje wersję SQL Server (Major.Drobny. BuildNumber)
PDO::ATTR_STRINGIFY_FETCHES PDO Zobacz dokumentację PDO Zobacz dokumentację PDO.
PDO::SQLSRV_ATTR_CLIENT_BUFFER_MAX_KB_SIZE Sterowniki firmy Microsoft dla języka PHP dla programu SQL Server 1 do limitu pamięci PHP. Konfiguruje rozmiar bufora przetrzymującego zbiór wyników dla kursora po stronie klienta.

Domyślna pojemność wynosi 10 240 KB (10 MB).

Więcej informacji o kursorach po stronie klienta można znaleźć w artykule Typy kursorów (sterownik SQLSRV).
PDO::SQLSRV_ATTR_DIRECT_QUERY Sterowniki firmy Microsoft dla języka PHP dla programu SQL Server true

fałszywy
Określa bezpośrednie lub przygotowane wykonanie zapytań. Więcej informacji można znaleźć w artykule Wykonanie bezpośredniego oświadczenia oraz Wykonanie przygotowanego wypowiedzenia w sterowniku PDO_SQLSRV.
PDO::SQLSRV_ATTR_ENCODING Sterowniki firmy Microsoft dla języka PHP dla programu SQL Server PDO::SQLSRV_ENCODING_UTF8

PDO::SQLSRV_ENCODING_SYSTEM
Określa kodowanie zestawu znaków używane przez sterownik do komunikacji z serwerem.

Domyślna wersja to PDO::SQLSRV_ENCODING_UTF8.
PDO::SQLSRV_ATTR_FETCHES_NUMERIC_TYPE Sterowniki firmy Microsoft dla języka PHP dla programu SQL Server prawda lub fałsz Obsługuje numeryczne pobieranie z kolumn o numerycznych typach SQL (bit, liczba całkowita, smallint, tinyint, float lub real).

Gdy flaga opcji połączenia ATTR_STRINGIFY_FETCHES jest włączona, nawet gdy SQLSRV_ATTR_FETCHES_NUMERIC_TYPE jest włączona, wartość zwracana to ciąg znaków.

Gdy zwrócony typ PDO w kolumnie bind jest PDO_PARAM_INT, wartość zwrotna z kolumny całkowitej jest int, nawet jeśli SQLSRV_ATTR_FETCHES_NUMERIC_TYPE jest nieprawidłowa.
PDO::SQLSRV_ATTR_QUERY_TIMEOUT Sterowniki firmy Microsoft dla języka PHP dla programu SQL Server liczba całkowita Ustawia czas zapytania na sekundy.

Domyślnie to 0, co oznacza, że kierowca będzie czekał w nieskończoność na wyniki.

Liczby ujemne są niedozwolone.

PDO przetwarza niektóre z predefiniowanych atrybutów, podczas gdy wymaga od sterownika obsługi innych. Wszystkie niestandardowe atrybuty i opcje połączenia są obsługiwane przez sterownik, a nieobsługiwany atrybut lub opcja połączenia zwraca null.

Wsparcie dla PDO zostało dodane w wersji 2.0 sterowników Microsoft dla PHP dla SQL Server.

Example

Ten przykład pokazuje wartość atrybutu PDO::ATTR_ERRMODE przed i po zmianie jego wartości.

<?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 ));  
?>