(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.2.0)
PDO::query — Bir SQL deyimini yer tutucular olmaksızın hazırlar ve çalıştırır
$deyim
, ?int$getirme_kipi
= PDO::FETCH_COLUMN, int$sütun_num
): PDOStatement|false$deyim
,$getirme_kipi
= PDO::FETCH_CLASS,$sınıf_adı
,$kurucu_bağımsız değişkenleri
$deyim
, ?int$getirme_kipi
= PDO::FETCH_INTO, object$nesne
): PDOStatement|falseBir SQL deyimini tek bir işlev çağrısında çalıştırır ve deyimi bir PDOStatement nesnesi olarak döndürür.
Defalarca yineleyeceğiniz bir sorguyu PDO::prepare() yöntemini kullanarak bir PDOStatement nesnesi haline getirip bunu PDOStatement::execute() ile defalarca çalıştırmak başarımı arttıracaktır.
Tekrar bir PDO::query() çağrısı yapmadan önce sonuç kümesindeki veriyi almazsanız çağrınız başarısızlıkla sonuçlanabilir. Yeni bir PDO::query() çağrısını yapmadan önce PDOStatement nesnesi ile ilişkilendirilmiş kaynakları serbest bırakmak için PDOStatement::closeCursor() çağrısı yapmalısınız.
Bilginize:
deyim
yer tutucular içeriyorsa, deyim PDO::prepare() ve PDOStatement::execute() yöntemleri kullanılarak hazırlanıp çalıştırılmalıdır.
deyim
Hazırlanacak ve çalıştırılacak SQL deyimi.
SQL deyimi yer tutucular içeriyorsa, bu yöntem yerine PDO::prepare() ve PDOStatement::execute() yöntemleri kullanılmalıdır. Veya, SQL deyimi PDO::query() çağrılmadan önce elle hazırlanmalı, sürücü destekliyorsa PDO::quote() kullanılarak düzgünce öncelenmelidir.
getirme_kipi
Döndürülen PDOStatement nesnesi için öntanımlı getirme kipi. PDO::FETCH_*
sabitlerinden biri olmalıdır.
İşleve fazladan bağımsız değişken aktarılırsa, bunlar sonuç nesnesi üzerinde PDOStatement::setFetchMode() çağrısı yapılmış gibi ele alınır. Sonraki bağımsız değişkenler, seçilen getirme kipine bağlı olarak değişir.
Başarı durumunda PDOStatement nesnesi, başarısızlık durumunda false
döner.
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 - Yer tutucu içermeyen SQL deyimi kullanılan PDO::query() örneği
<?php
$sql = 'SELECT name, color, calories FROM fruit ORDER BY name';
foreach ($conn->query($sql) as $row) {
print $row['name'] . "\t";
print $row['color'] . "\t";
print $row['calories'] . "\n";
}
?>
Yukarıdaki örneğin çıktısı:
apple red 150 banana yellow 250 kiwi brown 75 lemon yellow 25 orange orange 300 pear green 150 watermelon pink 90