Manuel PHP
Précédent |  | Suivant

# 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

PDOStatement PDO::query ( string statement )
bool PDO::query ( string statement, int PDO::FETCH_COLUMN, int colno )
bool PDO::query ( string statement, int PDO::FETCH_CLASS, string classname, array ctorargs )
bool PDO::query ( string statement, int PDO::FETCH_INTO, object object )

PDO::query() 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 que vous devez exécuter plusieurs fois, vous réaliserez de meilleurs performances si vous préparez l'objet PDOStatement en utilisant la fonction PDO::prepare() et exécutez la requête via plusieurs appels à la fonction PDOStatement::execute().

Si vous ne récupérez pas toutes les données du jeux de résultats avant d'exécuter le prochain appel à PDO::query(), votre appel peut échouer. Appeler PDOStatement::closeCursor() pour libérer les ressources de la base de données associées à l'objet PDOStatement avant d'exécuter votre prochain appel à la fonction PDO::query().

> Note : Bien que la documentation de cette fonction autorise de passer un seul paramètre, vous pouvez y passer d'autres paramètres. Ils seront traités via l'appel à PDOStatement::setFetchMode() sur le résultat du traitement de l'objet.

## 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édent | Sommaire | Suivant
PDO::prepare | Niveau supérieur | PDO::quote