(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.1.0)
PDOStatement::bindParam — Bir bağımsız değişkeni belirtilen değişkenle ilişkilendirir
$bağımsız_değişken,&$değişken,$veri_türü = PDO::PARAM_STR,$uzunluk = 0,$seçenekler = nullBir PHP değişkenini hazır SQL deyimindeki bir isimli veya soru imli bağımsız değişkenle ilişkilendirir. PDOStatement::bindValue() yönteminin tersine değişken gönderimli olarak ilişkilendirilir ve sadece PDOStatement::execute() çağrısı sırasında değerlendirmeye alınır.
Bağımsız değişkenler çoğunlukla girdi bağımsız değişkenidir, yani bağımsız değişkenler sadece
sorguda salt okunur olarak ele alınır (ancak yine de
veri_türüne göre tür dönüşümü olabilir). Bazı
sürücüler, veriyi çıktı bağımsız değişkenlerinde döndüren kayıtlı yordamların
kullanımını mümkün kılar. Bazıları ise aynı bağımsız değişkenlerin hem girdi hem de
çıktı için kullanımını mümkün kılar.
bağımsız_değişkenBağımsız değişken betimleyicisi. İsimli bağımsız değişkenler için :isim biçemindedir. Soru imli bağımsız değişkenler için ise soru iminin konumudur. Konumlar 1'den başlar.
değişkenSQL deyimindeki bağımsız değişken ile ilişkilendirilecek PHP değişkeni.
veri_türü
PDO::PARAM_*
sabitlerinden biri olarak veri türü.
Bağımsız değişkenden değer de döndürmek istiyorsanız
PDO::PARAM_INPUT_OUTPUT sabitini burada, bit
seviyesinde VEYAlayın.
uzunluk
Veri türünün uzunluğu. Bağımsız değişken çıktı almak amacıyla kullanılacaksa
veri türü uzunluğu mutlaka belirtilmelidir. Sadece
veri_türü bağımsız değişkeninde
PDO::PARAM_INPUT_OUTPUT belirtilmişse anlamlıdır.
seçeneklerSürücü seçenekleri.
PDO::ATTR_ERRMODE özniteliğine
PDO::ERRMODE_WARNING atanırsa
E_WARNING düzeyinde bir hata çıktılanır.
PDO::ATTR_ERRMODE özniteliğine
PDO::ERRMODE_EXCEPTION atanırsa
PDOException istisnası oluşur.
Örnek 1 - İsimli bağımsız değişkenlerle PDOStatement::bindParam() örneği
<?php
/* PHP değişkenleriyle ilişkili bir hazır deyim çalıştıralım */
$calories = 150;
$colour = 'red';
$sth = $dbh->prepare('SELECT name, colour, calories
FROM fruit
WHERE calories < :calories AND colour = :colour');
$sth->bindParam('calories', $calories, PDO::PARAM_INT);
/* Dizi anahtarları ":" ile öncelenebiliyor (seçimlik) */
$sth->bindParam(':colour', $colour, PDO::PARAM_STR);
$sth->execute();
?>Örnek 2 - Soru imli bağımsız değişkenlerle PDOStatement::bindParam() örneği
<?php
/* PHP değişkenleriyle ilişkili bir hazır deyim çalıştıralım */
$calories = 150;
$colour = 'red';
$sth = $dbh->prepare('SELECT name, colour, calories
FROM fruit
WHERE calories < ? AND colour = ?');
$sth->bindParam(1, $calories, PDO::PARAM_INT);
$sth->bindParam(2, $colour, PDO::PARAM_STR);
$sth->execute();
?>Örnek 3 - Girdi/Çıktı bağımsız değişkeni kullanımı
<?php
/* Girdi/Çıktı bağımsız değişkenli bir kayıtlı yordam çağrısı yapalım */
$colour = 'red';
$sth = $dbh->prepare('CALL puree_fruit(?)');
$sth->bindParam(1, $colour, PDO::PARAM_STR|PDO::PARAM_INPUT_OUTPUT, 12);
$sth->execute();
print "Meyvenin posa rengi: $colour";
?>