PDOStatement::bindParam

    (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

    Açıklama

    publicPDOStatement::bindParam(
        string|int$bağımsız_değişken,
        mixed&$değişken,
        int$veri_türü = PDO::PARAM_STR,
        int$uzunluk = 0,
        mixed$seçenekler = null
    ): bool

    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şkenler

    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.

    Dönen Değerler

    Başarı durumunda true, başarısızlık durumunda false döner.

    Hatalar/İstisnalar

    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.

    Örnekler

    Örnek 1 - İsimli bağımsız değişkenlerle PDOStatement::bindParam() örneği

    <?php

    $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);
    $sth->execute();
    ?>

    Örnek 2 - Soru imli bağımsız değişkenlerle PDOStatement::bindParam() örneği

    <?php

    $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

    $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";
    ?>

    Ayrıca Bakınız

    To Top