PDOStatement::setAttribute

Unduh driver PHP

Mengatur nilai atribut, baik atribut PDO yang telah ditentukan sebelumnya atau atribut driver kustom.

Sintaks

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

Parameter

$atribut: Bilangan bulat, salah satu konstanta PDO::ATTR_* atau PDO::SQLSRV_ATTR_*. Lihat bagian Keterangan untuk daftar atribut yang tersedia.

$nilai: Nilai (campuran) yang akan ditetapkan untuk $attribute yang ditentukan.

Tampilkan Nilai

TRUE pada keberhasilan, FALSE jika tidak.

Keterangan

Tabel berikut berisi daftar atribut yang tersedia:

Atribut	Nilai	Deskripsi
PDO::SQLSRV_ATTR_CLIENT_BUFFER_MAX_KB_SIZE	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 PDO_SQLSRV).
PDO::SQLSRV_ATTR_DATA_CLASSIFICATION	BENAR atau SALAH	Menentukan apakah akan mengambil metadata klasifikasi data saat memanggil PDOStatement::getColumnMeta. Defaultnya adalah false.
PDO::SQLSRV_ATTR_DECIMAL_PLACES	Bilangan bulat antara 0 dan 4 (inklusif)	Menentukan jumlah tempat desimal saat memformat nilai uang yang diambil. Bilangan bulat atau nilai negatif apa pun lebih dari 4 akan diabaikan. Opsi ini hanya berfungsi ketika PDO::SQLSRV_ATTR_FORMAT_DECIMALS benar. Opsi ini juga dapat diatur pada tingkat koneksi. Jika demikian, maka opsi ini akan mengambil alih opsi tingkat koneksi. Untuk informasi selengkapnya, lihat Memformat String Desimal dan Nilai Uang (driver PDO_SQLSRV).
PDO::SQLSRV_ATTR_ENCODING	Bilangan bulat PDO::SQLSRV_ENCODING_UTF8 (Default) PDO::SQLSRV_ENCODING_SYSTEM PDO::SQLSRV_ENCODING_BINARY	Mengatur pengodean set karakter yang akan digunakan oleh driver untuk berkomunikasi dengan server.
PDO::SQLSRV_ATTR_FETCHES_DATETIME_TYPE	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 koneksi. Jika demikian, maka opsi ini akan mengambil alih opsi tingkat koneksi. Untuk informasi selengkapnya, lihat Cara: Mengambil Jenis Tanggal dan Waktu sebagai Objek DateTime PHP Menggunakan Driver PDO_SQLSRV.
PDO::SQLSRV_ATTR_FETCHES_NUMERIC_TYPE	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	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 depan untuk nilai kurang dari 1 digunakan. Opsi ini juga dapat diatur pada tingkat koneksi. Jika demikian, maka opsi ini akan mengambil alih opsi tingkat koneksi. Untuk informasi selengkapnya, lihat Memformat String Desimal dan Nilai Uang (driver PDO_SQLSRV).
PDO::SQLSRV_ATTR_QUERY_TIMEOUT	Bilangan bulat	Mengatur batas waktu kueri dalam detik. Secara default, driver akan menunggu tanpa batas waktu untuk hasil. Angka negatif tidak diperbolehkan. 0 berarti tidak ada batas waktu.

Contoh

<?php  
$database = "AdventureWorks";  
$server = "(local)";  
$conn = new PDO( "sqlsrv:server=$server ; Database = $database", "", "", array('MultipleActiveResultSets'=>false )  );  
  
$stmt = $conn->prepare('SELECT * FROM Person.ContactType');  
  
echo $stmt->getAttribute( constant( "PDO::ATTR_CURSOR" ) );  
  
echo "\n";  
  
$stmt->setAttribute(PDO::SQLSRV_ATTR_QUERY_TIMEOUT, 2);  
echo $stmt->getAttribute( constant( "PDO::SQLSRV_ATTR_QUERY_TIMEOUT" ) );  
?>  

Lihat Juga

Kelas PDOStatement

PDO