Manuel PHP
PrécédentSuivant

PDO::query

(no version information, might be only in CVS)

PDO::query --  Exécute une requête SQL, retourne un jeu de résultats en tant qu'objet PDOStatement

Description

object PDO::query ( string statement )

Avertissement

Cette fonction est EXPERIMENTALE. Cela signifie que le comportement de cette fonction, son nom et concrètement, TOUT ce qui est documenté ici peut changer dans un futur proche, SANS PREAVIS! Soyez-en conscient, et utilisez cette fonction à vos risques et périls.

PDO::query() prépare et exécute une requête SQL en appelant une seule fonction, retourne le jeu de résultats (s'il y en a) retourné par la requête en tant qu'objet PDOStatement.

Pour une requête SELECT que vous devez utiliser plusiers fois, préparez un objet PDOStatement avec la fonction PDO::prepare() et exécutez la requête avec la fonction PDOStatement::execute().

Liste de paramètres

statement

La requête SQL à préparer et à exécuter.

Valeurs de retour

PDO::query() retourne un objet PDOStatement.

Exemples

Exemple 1. Exemple avec PDO::query

Une fonctionnalité intéressante de PDO::query() est qu'il vous permet d'itérer à travers un jeu de résultats retourné par une requête SELECT exécutée avec succès.

<?php
function getFruit($conn) {
  $sql = 'SELECT name, colour, calories FROM fruit ORDER BY name';
  foreach ($conn->query($sql) as $row) {
    print $row['NAME'] . "\t";
    print $row['COLOUR'] . "\t";
    print $row['CALORIES'] . "\n";
  }
}
?>

L'exemple ci-dessus va afficher :

apple   red     150
banana  yellow  250
kiwi    brown   75
lemon   yellow  25
orange  orange  300
pear    green   150
watermelon      pink    90

Voir aussi

PDO::exec()
PDO::prepare()
PDOStatement::execute()

PrécédentSommaireSuivant
PDO::prepareNiveau supérieurPDO::quote