PDO::setAttribute

Artikel
06/02/2023

Mengatur atribut PDO yang telah ditentukan sebelumnya atau atribut driver kustom.

Sintaks

bool PDO::setAttribute ( $attribute, $value );

Parameter

$attribute: Atribut yang akan diatur. Lihat bagian Keterangan untuk daftar atribut yang didukung.

$value: Nilai (ketik campuran).

Tampilkan Nilai

Mengembalikan true pada keberhasilan, jika tidak salah.

Keterangan

Atribut	Diproses oleh	Nilai yang Didukung	Deskripsi
PDO::ATTR_CASE	PDO	PDO::CASE_LOWER PDO::CASE_NATURAL PDO::CASE_UPPER	Menentukan kasus nama kolom. PDO::CASE_LOWER menyebabkan nama kolom huruf kecil. PDO::CASE_NATURAL (default) menampilkan nama kolom seperti yang dikembalikan oleh database. PDO::CASE_UPPER menyebabkan nama kolom menjadi huruf besar. Atribut ini dapat diatur menggunakan PDO::setAttribute.
PDO::ATTR_DEFAULT_FETCH_MODE	PDO	Lihat dokumentasi PDO.	Lihat dokumentasi PDO.
PDO::ATTR_DEFAULT_STR_PARAM	PDO	PDO::P ARAM_STR_CHAR PDO::P ARAM_STR_NATL	Untuk informasi selengkapnya, lihat contoh di PDO::quote.
PDO::ATTR_ERRMODE	PDO	PDO::ERRMODE_SILENT PDO::ERRMODE_WARNING PDO::ERRMODE_EXCEPTION	Menentukan bagaimana driver melaporkan kegagalan. PDO::ERRMODE_SILENT (default) mengatur kode kesalahan dan informasi. PDO::ERRMODE_WARNING meningkatkan E_WARNING. PDO::ERRMODE_EXCEPTION menyebabkan pengecualian dilemparkan. Atribut ini dapat diatur menggunakan PDO::setAttribute.
PDO::ATTR_ORACLE_NULLS	PDO	Lihat dokumentasi PDO.	Menentukan bagaimana null harus dikembalikan. PDO::NULL_NATURAL tidak melakukan konversi. PDO::NULL_EMPTY_STRING mengonversi string kosong menjadi null. PDO::NULL_TO_STRING mengonversi null ke string kosong.
PDO::ATTR_STATEMENT_CLASS	PDO	Lihat dokumentasi PDO.	Mengatur kelas pernyataan yang disediakan pengguna yang berasal dari PDOStatement. Memerlukan `array(string classname, array(mixed constructor_args))`. Untuk informasi selengkapnya, lihat dokumentasi PDO.
PDO::ATTR_STRINGIFY_FETCHES	PDO	BENAR atau SALAH	Mengonversi nilai numerik menjadi string saat mengambil data.
PDO::SQLSRV_ATTR_CLIENT_BUFFER_MAX_KB_SIZE	Microsoft Drivers for PHP for SQL Server	1 hingga batas memori PHP.	Mengatur ukuran buffer yang menyimpan tataan hasil saat menggunakan kursor sisi klien. Defaultnya adalah 10240 KB, jika tidak ditentukan dalam file php.ini. Angka nol dan negatif tidak diperbolehkan. Untuk informasi selengkapnya tentang kueri yang membuat kursor sisi klien, lihat Jenis Kursor (driver PDO_SQLSRV).
PDO::SQLSRV_ATTR_DECIMAL_PLACES	Microsoft Drivers for PHP for SQL Server	Bilangan bulat antara 0 dan 4 (inklusif)	Menentukan jumlah tempat desimal saat memformat nilai uang yang diambil. Bilangan bulat atau nilai negatif apa pun yang lebih dari 4 akan diabaikan. Opsi ini hanya berfungsi ketika PDO::SQLSRV_ATTR_FORMAT_DECIMALS benar. Opsi ini juga dapat diatur pada tingkat pernyataan. Jika demikian, maka opsi tingkat pernyataan mengambil alih yang satu ini. Untuk informasi selengkapnya, lihat Memformat String Desimal dan Nilai Uang (driver PDO_SQLSRV).
PDO::SQLSRV_ATTR_DIRECT_QUERY	Microsoft Drivers for PHP for SQL Server	BENAR atau 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.	Mengatur pengodean set karakter yang digunakan oleh driver untuk berkomunikasi dengan server. PDO::SQLSRV_ENCODING_BINARY tidak didukung. Defaultnya adalah PDO::SQLSRV_ENCODING_UTF8.
PDO::SQLSRV_ATTR_FETCHES_DATETIME_TYPE	Microsoft Drivers for PHP for SQL Server	BENAR atau SALAH	Menentukan apakah akan mengambil jenis tanggal dan waktu sebagai objek DateTime PHP . Jika dibiarkan false, perilaku defaultnya adalah mengembalikannya sebagai string. Opsi ini juga dapat diatur pada tingkat pernyataan. Jika demikian, maka opsi tingkat pernyataan mengambil alih yang satu ini. Untuk informasi selengkapnya, lihat Cara: Mengambil Jenis Tanggal dan Waktu sebagai Objek DateTime PHP Menggunakan Driver PDO_SQLSRV.
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, nilai yang dikembalikan adalah string bahkan ketika SQLSRV_ATTR_FETCHES_NUMERIC_TYPE aktif. 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_FORMAT_DECIMALS	Microsoft Drivers for PHP for SQL Server	BENAR atau SALAH	Menentukan apakah akan menambahkan nol di depan ke string desimal jika sesuai. Jika diatur, opsi ini mengaktifkan opsi PDO::SQLSRV_ATTR_DECIMAL_PLACES untuk memformat jenis uang. Jika dibiarkan false, perilaku default mengembalikan presisi yang tepat dan menghilangkan nol di depannya untuk nilai kurang dari 1 digunakan. Opsi ini juga dapat diatur pada tingkat pernyataan. Jika demikian, maka opsi tingkat pernyataan mengambil alih yang satu ini. Untuk informasi selengkapnya, lihat Memformat String Desimal dan Nilai Uang (driver PDO_SQLSRV).
PDO::SQLSRV_ATTR_QUERY_TIMEOUT	Microsoft Drivers for PHP for SQL Server	bilangan bulat	Mengatur batas waktu kueri dalam hitung 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 dan mengharuskan driver untuk memproses yang lain. Semua atribut kustom dan opsi koneksi diproses oleh driver. Atribut yang tidak didukung, opsi koneksi, atau nilai yang tidak didukung dilaporkan sesuai dengan pengaturan PDO::ATTR_ERRMODE.

Dukungan untuk PDO ditambahkan di Driver Microsoft untuk PHP versi 2.0 untuk SQL Server.

Contoh

Sampel ini menunjukkan cara mengatur atribut 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" ) ));  
   }  
?>

Lihat juga

Kelas PDO

PDO