Introduction - Récupération

Introduction - Récupération – Récupération des lignes depuis une requête

Description

Fonctions de récupération

Pour pouvoir récupérer les données depuis une ressource de résultats, vous pouvez utiliser une des méthodes suivantes : fetchInto() , fetchOne() . , fetchRow() . , fetchCol() . et fetchAll() . Toutes les méthodes ci-dessus, exceptée la méthode fetchOne(), retournent les données demandées dans un tableau (multi-dimentionnel), NULL s'il n'y a plus de données de disponible, ou un objet MDB_Error , si une erreur survient. Toutes les méthodes préfixés avec fetch() libèreront le jeu de résultats une fois exécutée.

Récupération d'un jeu de résultats

<?php
...
$db MDB::connect($dsn);
$res $db->query("SELECT * FROM mytable");

// Récupération de chaque ligne de données, à chaque
// itération, tant qu'il y a des données
while ($row $db->fetchInto($res)) {
   
$id $row[0];
}

// Si vous n'êtes intéressé que par la première colonne de la première ligne
$id $db->fetchOne($res);

// Vu que les méthodes de récupération libèrent toujours
// le jeu de résultats, nous ne pouvons pas boucler sur le
// jeu de résultats mais, plutôt, choisir une autre méthode
// de récupération
$data $db->getAll($res);
foreach(
$data as $row) {
   
$id $row[0];
}
?>

Sélection du format de la ligne récupérée

Les modes de récupération supportés sont :

  • MDB_FETCHMODE_ORDERED (par défaut)

    Les méthodes fetch*() retournent un tableau ordonné. L'ordre est fourni par la requête.

    Récupération d'un tableau ordonné

    <?php
         $res 
    $db->query('SELECT id, name, email FROM users');
    $row $db->fetchRow($resMDB_FETCHMODE_ORDERED);
    /*
    $row contiendra :
    array (
       0 => <column "id" data>,
       1 => <column "name" data>,
       2 => <column "email" data>
    )
    */
    // Accès aux données par :
    $id    $row[0];
    $name  $row[1];
    $email $row[2];
    ?>

  • MDB_FETCHMODE_ASSOC

    Retourne un tableau associatif avec les noms de colonnes comme clés du tableau

    Récupération d'un tableau associatif

    <?php
    $res 
    $db->query('SELECT id, name, email FROM users');
    $row $db->fetchRow($resMDB_FETCHMODE_ASSOC);
    /*
    $row contiendra :
    array (
       'id'    => <column "id" data>,
       'name'  => <column "name" data>,
       'email' => <column "email" data>
    )
    */
    // Accès aux données par :
    $id    $row['id'];
    $name  $row['name'];
    $email $row['email'];
    ?>

Définission du format pour la ligne récupérée

Vous pouvez définir le mode de récupération pour chaque appel ou pour l'instance MDB dans sa totalité.

À chaque appel

<?php
while ($row $db->fetchInto($resMDB_FETCHMODE_ASSOC)) {
   
$id $row['id'];
}
?>

Une fois par instance

<?php
$db 
MDB::connect($dsn);
// ceci va définit un mode de récupération par défaut pour l'instance PEAR MDB
// (pour toutes les requêtes)
$db->setFetchMode(MDB_FETCHMODE_ASSOC);

$result $db->query(...);

while (
$row $db->fetchRow($res)) {
   
$id $row['id'];
}
?>

Récupération des lignes par numéro

Le système de récupération PEAR MDB supporte également un paramètre supplémentaire pour la requête de récupération. Donc, vous pouvez récupérer les lignes depuis un résultat par son numéro. Ceci est particulièrement utile si vous voulez uniquement voir le jeu d'un résultat complet (par exemple, lors de la pagination HTML), récupération des lignes dans un ordre particulier, etc.

Récupération par numéro

<?php
...
// la ligne de début de récupération
$from 50;

// combien de résultats par page
$resPage 10;

// la dernière ligne à récupérer pour cette page
$to $from $resPage;

foreach (
range($from$to) as $rowNum) {
   if (!
$row $db->fetchInto($res$fetchmode$rowNum)) {
      break;
   }
   
$id $row[0];
   ....
}
?>

Libération du jeu de résultats

Il est recommandé de terminer le jeu de résultats après l'exécution afin de préserver la mémoire. Utilisez la méthode freeResult() pour cela.

Libération du jeu de résultats

<?php
...
$res $db->query('SELECT * FROM clients');
while (
$row $res->fetchInto($res)) {
   ...
}
$db->freeResult($res);
?>

Récupération rapide de données

MDB fournit des façons spéciales pour récupérer de l'information depuis une requête sans avoir besoin d'utiliser de méthodes fetch*() et de boucler les résultats.

queryOne() récupère le premier résultat de la première colonne d'une requête.

<?php
$numrows 
$db->queryOne('select count(id) from clients');
?>

queryRow() récupère la première ligne et la retourne sous la forme d'un tableau.

<?php
$sql 
'select name, address, phone from clients where id=1';
if (
is_array($row $db->queryRow($sql))) {
   list(
$name$address$phone) = $row;
}
?>

queryCol() retourne un tableau contenant les données des colonnes sélectionnées. Elle accepte le numéro de la colonne à récupérer dans le second paramètre.

<?php
$all_client_names 
$db->queryCol('SELECT name FROM clients');
?>

La requête ci-dessus retourne, par exemple :

<?php
$all_client_names 
= array('Stig''Jon''Colin');
?>

getAll() récupère toutes les lignes retournées d'une requête. Cette méthode a également plusieurs paramètres qui vous permettent de retourner les données sous la forme d'un tableau associatif, en utilisant la première colonne en tant que clé.

<?php
$data 
getAll('SELECT id, text, date FROM mytable');
/*
Retournera :
array(
   1 => array('4', 'four', '2004'),
   2 => array('5', 'five', '2005'),
   3 => array('6', 'six', '2006')
)
*/
?>

La famille de méthodes query*() effectue tout le sal boulot à votre place, c'est-à-dire : lancer la requête, récupérer les donées et libérer le résultat. Notez que toutes les fonctions PEAR MDB retournent un objet MDB_Error si une erreur survient.

Récupération de plus d'informations depuis les résultats

Avec MDB, vous avez plusieurs amnières de récupérer des informations utiles depuis les résultats. Elles sont :

  • numRows() : Retourne le nombre total de lignes retourné depuis une requête "SELECT".

    <?php
    // Nombre de lignes
    echo $db->numRows($res);
    ?>

  • numCols() : Retourne le nombre total de colonnes retourné depuis une requête "SELECT".

    <?php
    // Nombre de colonnes
    echo $db->numCols($res);
    ?>

  • affectedRows() : Retourne le nombre de lignes affectées par une requête de manipulation de données ("INSERT", "UPDATE" ou "DELETE").

    <?php
    // Cette requête ne retourne pas d'objet résultat
    $db->query('DELETE * FROM clients');
    echo 
    'J\'ai effacé ' $db->affectedRows() . ' clients.';
    ?>

  • tableInfo() : Retourne un tableau associatif contenant les informations sur les champs retournés d'une requête "SELECT".

    <?php
    // Information sur la table
    print_r($db->tableInfo($res));
    ?>

N'oubliez pas de vérifier si le résultat retourné par votre action n'est pas un objet MDB_Error. Si vous obtenez un message d'erreur comme "MDB_Error: database not capable", cela signifie que votre gestionnaire de base de données ne supporte pas cette action.

Exécution d'une requête sur une base de données (Previous) Séquences de base de données (Next)
Last updated: Sun, 29 Aug 2010 — Download Documentation
Do you think that something on this page is wrong? Please file a bug report or add a note.
View this page in:

User Notes:

There are no user contributed notes for this page.