Bagikan melalui

PDOStatement::setAttribute

  • Artikel

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 tataan hasil untuk kursor sisi klien.

Defaultnya adalah 10.240 KB (10 MB).

Untuk informasi selengkapnya tentang kursor sisi klien, lihat Jenis Kursor (PDO_SQLSRV Driver).
PDO::SQLSRV_ATTR_DATA_CLASSIFICATION BENAR atau SALAH Menentukan apakah akan mengambil metadata klasifikasi data saat memanggil PDOStatement::getColumnMeta. Defaultnya adalah false (salah).
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 (PDO_SQLSRV Driver).
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, smallint, tinyint, float, atau nyata).

Saat bendera opsi koneksi ATTR_STRINGIFY_FETCHES aktif, nilai yang dikembalikan adalah string bahkan saat SQLSRV_ATTR_FETCHES_NUMERIC_TYPE aktif.

Saat jenis PDO yang dikembalikan dalam kolom ikatan 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 awal 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 (PDO_SQLSRV Driver).
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 waktu habis.

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