(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
= null
Bir 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şken
Bağı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şken
SQL 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çenekler
Sü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";
?>