(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:
deyimyer tutucular içeriyorsa, deyim PDO::prepare() ve PDOStatement::execute() yöntemleri kullanılarak hazırlanıp çalıştırılmalıdır.
deyimHazı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