PHP Conference Nagoya 2025

    mysqli_stmt::fetch

    mysqli_stmt_fetch

    (PHP 5, PHP 7, PHP 8)

    mysqli_stmt::fetch -- mysqli_stmt_fetch — Lit des résultats depuis une requête MySQL préparée dans des variables liées

    Description

    Style orienté objet

    public mysqli_stmt::fetch(): ?bool

    Style procédural

    mysqli_stmt_fetch(mysqli_stmt $statement): ?bool

    Retourne le résultat d'une requête préparée dans une variable, liée par mysqli_stmt_bind_result().

    Note:

    Notez que toutes les colonnes doivent être liées par l'application avant d'appeler mysqli_stmt_fetch().

    Note:

    Les données sont transférées sans être bufferisées, sans appeler la fonction mysqli_stmt_store_result(), ce qui peut avoir un impact sur les performances (mais aussi, réduire l'utilisation mémoire).

    Liste de paramètres

    statement

    Style procédural uniquement : Un objet mysqli_stmt retourné par la fonction mysqli_stmt_init().

    Valeurs de retour

    Valeurs de retour
    Value Description
    true Réussite. Les données ont été lues.
    false Une erreur est survenue.
    null Il n'y a plus de ligne à lire ou les données ont été tronquées.

    Erreurs / Exceptions

    Si le rapport d'erreurs mysqli est activé (MYSQLI_REPORT_ERROR) et que l'opération demandée échoue, un avertissement est généré. Si, en plus, le mode est défini sur MYSQLI_REPORT_STRICT, une mysqli_sql_exception est lancée à la place.

    Exemples

    Exemple #1 Style orienté objet

    <?php
    $mysqli     = new mysqli("localhost", "my_user", "my_password", "world");

    /* Vérifie la connexion */
    if (mysqli_connect_errno()) {
    printf("Échec de la connexion : %s\n", mysqli_connect_error());
    exit();
    }

    $query = "SELECT Name, CountryCode FROM City ORDER by ID DESC LIMIT 150,5";

    if (    $stmt = $mysqli->prepare($query)) {

    /* Exécution de la requête */
    $stmt->execute();

    /* Association des variables de résultat */
    $stmt->bind_result($name, $code);

    /* Lecture des valeurs */
    while ($stmt->fetch()) {
    printf ("%s (%s)\n", $name, $code);
    }

    /* Fermeture de la commande */
    $stmt->close();
    }

    /* Fermeture de la connexion */
    $mysqli->close();
    ?>

    Exemple #2 Style procédural

    <?php
    $link     = mysqli_connect("localhost", "my_user", "my_password", "world");

    /* Vérifie la connexion */
    if (mysqli_connect_errno()) {
    printf("Échec de la connexion : %s\n", mysqli_connect_error());
    exit();
    }

    $query = "SELECT Name, CountryCode FROM City ORDER by ID DESC LIMIT 150,5";

    if (    $stmt = mysqli_prepare($link, $query)) {

    /* Exécution de la requête */
    mysqli_stmt_execute($stmt);

    /* Association des variables de résultat */
    mysqli_stmt_bind_result($stmt, $name, $code);

    /* Lecture des valeurs */
    while (mysqli_stmt_fetch($stmt)) {
    printf ("%s (%s)\n", $name, $code);
    }

    /* Fermeture de la commande */
    mysqli_stmt_close($stmt);
    }

    /* Fermeture de la connexion */
    mysqli_close($link);
    ?>

    Les exemples ci-dessus vont afficher :

    Rockford (USA)
Tallahassee (USA)
Salinas (USA)
Santa Clarita (USA)
Springfield (USA)

    Voir aussi

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 5 notes

    up
    19
    Bruce Martin
    12 years ago
    I was trying to use a generic select * from table statment and have the results returned in an array. I finally came up with this solution, others have similar solutions, but they where not working for me.
    <?php
    //Snip use normal methods to get to this point
    $stmt->execute();
    $metaResults = $stmt->result_metadata();
    $fields = $metaResults->fetch_fields();
    $statementParams='';
    //build the bind_results statement dynamically so I can get the results in an array
    foreach($fields as $field){
    if(empty(    $statementParams)){
    $statementParams.="\$column['".$field->name."']";
    }else{
    $statementParams.=", \$column['".$field->name."']";
    }
    }
    $statment="\$stmt->bind_result($statementParams);";
    eval(    $statment);
    while(    $stmt->fetch()){
    //Now the data is contained in the assoc array $column. Useful if you need to do a foreach, or
    //if your lazy and didn't want to write out each param to bind.
    }
    // Continue on as usual.
    ?>
    up
    6
    dan dot latter at gmail dot com
    17 years ago
    The following function taken from PHP Cookbook 2, returns an associative array of a row in the resultset, place in while loop to iterate through whole result set.

    <?php
    public function fetchArray () {
    $data = mysqli_stmt_result_metadata($this->stmt);
    $fields = array();
    $out = array();

    $fields[0] = &$this->stmt;
    $count = 1;

    while(    $field = mysqli_fetch_field($data)) {
    $fields[$count] = &$out[$field->name];
    $count++;
    }

    call_user_func_array(mysqli_stmt_bind_result, $fields);
    mysqli_stmt_fetch($this->stmt);
    return (    count($out) == 0) ? false : $out;

    }
    ?>
    up
    1
    piedone at pyrocenter dot hu
    16 years ago
    I tried the mentioned stmt_bind_assoc() function, but somehow, very strangely it doesn't allow the values to be written in an array! In the while loop, the row is fetched correctly, but if I write $array[] = $row;, the array will be filled up with the last element of the dataset... Unfortunately I couldn't find a solution.
    up
    3
    Lyndon
    16 years ago
    This function uses the same idea as the last, but instead binds the fields to a given array.
    <?php
    function stmt_bind_assoc (&$stmt, &$out) {
    $data = mysqli_stmt_result_metadata($stmt);
    $fields = array();
    $out = array();

    $fields[0] = $stmt;
    $count = 1;

    while(    $field = mysqli_fetch_field($data)) {
    $fields[$count] = &$out[$field->name];
    $count++;
    }
    call_user_func_array(mysqli_stmt_bind_result, $fields);
    }

    // example

    $stmt = $mysqli->prepare("SELECT name, userid FROM somewhere");
    $stmt->execute();

    $row = array();
    stmt_bind_assoc($stmt, $row);

    // loop through all result rows
    while ($stmt->fetch()) {
    print_r($row);
    }
    ?>
    up
    2
    andrey at php dot net
    19 years ago
    IMPORTANT note: Be careful when you use this function with big result sets or with BLOB/TEXT columns. When one or more columns are of type (MEDIUM|LONG)(BLOB|TEXT) and ::store_result() was not called mysqli_stmt_fetch() will try to allocate at least 16MB for every such column. It _doesn't_ matter that the longest value in the result set is for example 30 bytes, 16MB will be allocated. Therefore it is not the best idea ot use binding of parameters whenever fetching big data. Why? Because once the data is in the mysql result set stored in memory and then second time in the PHP variable.
    ＋add a note
    To Top