(PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)
PDOStatement->bindParam — Bir değiştirgeyi belirtilen değişkenle ilişkilendirir
Bir PHP değişkenini hazır SQL deyimindeki bir isimli veya soru imli değiştirgeyle 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.
Değiştirgeler çoğunlukla girdi değiştirgesidir, yani değiştirgeler sadece sorguda salt okunur olarak ele alınır. Bazı sürücüler, veriyi çıktı değiştirgelerinde döndüren kayıtlı yordamların kullanımını mümkün kılar. Bazıları ise aynı değiştirgelerin hem girdi hem de çıktı için kullanımını mümkün kılar.
Değiştirge betimleyicisi. İsimli değiştirgeler için :isim biçemindedir. Soru imli değiştirgeler için ise soru iminin konumudur. Konumlar 1'den başlar.
SQL deyimindeki değiştirge ile ilişkilendirilecek PHP değişkeni.
PDO::PARAM_* sabitlerinden biri olarak veri türü. PDO::PARAM_STR öntanımlıdır. Değiştirgeden değer de döndürmek istiyorsanız PDO::PARAM_INPUT_OUTPUT sabitini burada, bit seviyesinde VEYAlayın.
Veri türünün uzunluğu. Değiştirge çıktı almak amacıyla kullanılacaksa veri türü uzunluğu mutlaka belirtilmelidir.
Sürücü seçenekleri.
Başarı durumunda TRUE, başarısızlık durumunda FALSE döner.
Örnek 1 - İsimli değiştirgelerle 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);
$sth->bindParam(':colour', $colour, PDO::PARAM_STR, 12);
$sth->execute();
?>
Örnek 2 - Soru imli değiştirgelerle 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, 12);
$sth->execute();
?>
Örnek 3 - Girdi/Çıktı değiştirgesi kullanımı
<?php
/* Girdi/Çıktı değiştirgeli 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");
?>