PDO::getAttribute
Mengambil nilai atribut PDO atau driver yang telah ditentukan sebelumnya.
Sintaks
mixed PDO::getAttribute ( $attribute )
Parameter
$attribute: Salah satu atribut yang didukung. Lihat bagian Keterangan untuk daftar atribut yang didukung.
Tampilkan Nilai
Setelah berhasil, mengembalikan nilai opsi koneksi, atribut PDO yang telah ditentukan sebelumnya, atau atribut driver kustom. Jika gagal, mengembalikan null.
Keterangan
Tabel berikut berisi daftar atribut yang didukung.
Atribut | Diproses oleh | Nilai yang Didukung | Deskripsi |
---|---|---|---|
PDO::ATTR_CASE | PDO | PDO::CASE_LOWER PDO::CASE_NATURAL PDO::CASE_UPPER |
Menentukan apakah nama kolom harus dalam kasus tertentu. PDO::CASE_LOWER memaksa nama kolom huruf kecil, PDO::CASE_NATURAL meninggalkan nama kolom seperti yang dikembalikan oleh database, dan PDO::CASE_UPPER memaksa nama kolom ke huruf besar. Defaultnya adalah PDO::CASE_NATURAL. Atribut ini juga dapat diatur menggunakan PDO::setAttribute. |
PDO::ATTR_CLIENT_VERSION | Microsoft Drivers for PHP for SQL Server | Array string | Menjelaskan versi driver dan pustaka terkait. Mengembalikan array dengan elemen berikut: versi ODBC (MajorVer.MinorVer), nama dan versi DLL Klien Asli SQL Server, Microsoft Drivers untuk PHP untuk versi SQL Server (MajorVer.MinorVer.BuildNumber.Revisi) |
PDO::ATTR_DEFAULT_STR_PARAM | PDO | PDO::P ARAM_STR_CHAR PDO::P ARAM_STR_NATL |
Jika tidak diatur ke PDO::P ARAM_STR_CHAR, PDO::P ARAM_STR_NATL dikembalikan. |
PDO::ATTR_DRIVER_NAME | PDO | String | Selalu mengembalikan "sqlsrv". |
PDO::ATTR_DRIVER_VERSION | Microsoft Drivers for PHP for SQL Server | String | Menunjukkan Driver Microsoft untuk PHP untuk versi SQL Server (MajorVer.MinorVer.BuildNumber.Revisi) |
PDO::ATTR_ERRMODE | PDO | PDO::ERRMODE_SILENT PDO::ERRMODE_WARNING PDO::ERRMODE_EXCEPTION |
Menentukan bagaimana kegagalan harus ditangani oleh driver. PDO::ERRMODE_SILENT (default) mengatur kode kesalahan dan informasi. PDO::ERRMODE_WARNING meningkatkan E_WARNING. PDO::ERRMODE_EXCEPTION menimbulkan pengecualian. Atribut ini juga dapat diatur menggunakan PDO::setAttribute. |
PDO::ATTR_ORACLE_NULLS | PDO | Lihat dokumentasi PDO. | Lihat dokumentasi PDO. |
PDO::ATTR_SERVER_INFO | Microsoft Drivers for PHP for SQL Server | Array dari 3 elemen | Mengembalikan database saat ini, versi SQL Server, dan instans SQL Server. |
PDO::ATTR_SERVER_VERSION | Microsoft Drivers for PHP for SQL Server | String | Menunjukkan versi SQL Server (Mayor.Anak di bawah umur.BuildNumber) |
PDO::ATTR_STRINGIFY_FETCHES | PDO | Lihat dokumentasi PDO | Lihat dokumentasi PDO. |
PDO::SQLSRV_ATTR_CLIENT_BUFFER_MAX_KB_SIZE | Microsoft Drivers for PHP for SQL Server | 1 hingga batas memori PHP. | Mengonfigurasi ukuran buffer yang menyimpan hasil yang ditetapkan untuk kursor sisi klien. Defaultnya adalah 10.240 KB (10 MB). Untuk informasi selengkapnya tentang kursor sisi klien, lihat Jenis Kursor (Driver SQLSRV). |
PDO::SQLSRV_ATTR_DIRECT_QUERY | Microsoft Drivers for PHP for SQL Server | benar salah |
Menentukan eksekusi kueri langsung atau yang disiapkan. Untuk informasi selengkapnya, lihat Eksekusi Pernyataan Langsung dan Eksekusi Pernyataan yang Disiapkan di Driver PDO_SQLSRV. |
PDO::SQLSRV_ATTR_ENCODING | Microsoft Drivers for PHP for SQL Server | PDO::SQLSRV_ENCODING_UTF8 PDO::SQLSRV_ENCODING_SYSTEM |
Menentukan pengodean set karakter yang digunakan oleh driver untuk berkomunikasi dengan server. Defaultnya adalah PDO::SQLSRV_ENCODING_UTF8. |
PDO::SQLSRV_ATTR_FETCHES_NUMERIC_TYPE | Microsoft Drivers for PHP for SQL Server | BENAR atau SALAH | Menangani pengambilan numerik dari kolom dengan jenis SQL numerik (bit, bilangan bulat, kecil, kecil, float, atau nyata). Saat bendera opsi koneksi ATTR_STRINGIFY_FETCHES aktif, bahkan saat SQLSRV_ATTR_FETCHES_NUMERIC_TYPE aktif, nilai yang dikembalikan adalah string. Saat jenis PDO yang dikembalikan dalam kolom ikat PDO_PARAM_INT, nilai yang dikembalikan dari kolom bilangan bulat adalah int meskipun SQLSRV_ATTR_FETCHES_NUMERIC_TYPE nonaktif. |
PDO::SQLSRV_ATTR_QUERY_TIMEOUT | Microsoft Drivers for PHP for SQL Server | Integer | Mengatur batas waktu kueri dalam detik. Defaultnya adalah 0, yang berarti driver akan menunggu tanpa batas waktu untuk hasil. Angka negatif tidak diperbolehkan. |
PDO memproses beberapa atribut yang telah ditentukan sebelumnya sementara mengharuskan driver untuk menangani orang lain. Semua atribut kustom dan opsi koneksi ditangani oleh driver, atribut yang tidak didukung atau opsi koneksi mengembalikan null.
Dukungan untuk PDO ditambahkan di Driver Microsoft versi 2.0 untuk PHP untuk SQL Server.
Contoh
Contoh ini menunjukkan nilai atribut PDO::ATTR_ERRMODE, sebelum dan sesudah mengubah nilainya.
<?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 ));
?>