mysqli_stmt::execute

    mysqli_stmt_execute

    (PHP 5, PHP 7, PHP 8)

    mysqli_stmt::execute -- mysqli_stmt_execute — Exécute une requête préparée

    Description

    Style orienté objet

    publicmysqli_stmt::execute(?array$params = null): bool

    Style procédural

    mysqli_stmt_execute(mysqli_stmt$statement, ?array$params = null): bool

    Exécute une requête qui a été préalablement préparée en utilisant la fonction mysqli_prepare(), grâce à la ressource stmt. Lors de l'exécution, toutes les variables de la requête seront remplacées par les données appropriées.

    Si la requête est UPDATE, DELETE, ou INSERT, le nombre total de lignes affectées est disponible via la fonction mysqli_stmt_affected_rows(). Si la requête produit un ensemble de résultats, il peut être récupéré à l'aide de la fonction mysqli_stmt_get_result() ou en le récupérant ligne par ligne directement à partir de l'instruction à l'aide de la fonction mysqli_stmt_fetch().

    Liste de paramètres

    statement

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

    params

    Une liste facultative, en tant que tableau, avec autant d'éléments qu'il y a de paramètres liés dans l'instruction SQL en cours d'exécution. Chaque valeur est traitée comme une chaîne de caractères.

    Valeurs de retour

    Cette fonction retourne true en cas de succès ou false si une erreur survient.

    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.

    Historique

    VersionDescription
    8.1.0 Le paramètre facultatif params a été ajouté.

    Exemples

    Exemple #1 Exécuter une instruction préparée avec des variables liées

    Style orienté objet

    <?php

    mysqli_report    (MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
    $mysqli = new mysqli("localhost", "my_user", "my_password", "world");

    $mysqli->query("CREATE TEMPORARY TABLE myCity LIKE City");


    $stmt = $mysqli->prepare("INSERT INTO myCity (Name, CountryCode, District) VALUES (?,?,?)");


    $stmt->bind_param("sss", $val1, $val2, $val3);
    $val1 = 'Stuttgart';
    $val2 = 'DEU';
    $val3 = 'Baden-Wuerttemberg';


    $stmt->execute();
    $val1 = 'Bordeaux';
    $val2 = 'FRA';
    $val3 = 'Aquitaine';


    $stmt->execute();


    $query = "SELECT Name, CountryCode, District FROM myCity";
    $result = $mysqli->query($query);
    while (    $row = $result->fetch_row()) {
    printf("%s (%s,%s)\n", $row[0], $row[1], $row[2]);
    }

    Style procédural

    <?php

    mysqli_report    (MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
    $link = mysqli_connect("localhost", "my_user", "my_password", "world");

    mysqli_query($link, "CREATE TEMPORARY TABLE myCity LIKE City");


    $stmt = mysqli_prepare($link, "INSERT INTO myCity (Name, CountryCode, District) VALUES (?,?,?)");


    mysqli_stmt_bind_param($stmt, "sss", $val1, $val2, $val3);
    $val1 = 'Stuttgart';
    $val2 = 'DEU';
    $val3 = 'Baden-Wuerttemberg';


    mysqli_stmt_execute($stmt);
    $val1 = 'Bordeaux';
    $val2 = 'FRA';
    $val3 = 'Aquitaine';


    mysqli_stmt_execute($stmt);


    $query = "SELECT Name, CountryCode, District FROM myCity";
    $result = mysqli_query($link, $query);
    while (    $row = mysqli_fetch_row($result)) {
    printf("%s (%s,%s)\n", $row[0], $row[1], $row[2]);
    }

    Les exemples ci-dessus vont afficher :

    Stuttgart (DEU,Baden-Wuerttemberg) Bordeaux (FRA,Aquitaine)

    Exemple #2 Exécuter une instruction préparée avec un tableau de valeurs

    Style orienté objet

    <?php

    mysqli_report    (MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
    $mysqli = new mysqli('localhost', 'my_user', 'my_password', 'world');

    $mysqli->query('CREATE TEMPORARY TABLE myCity LIKE City');


    $stmt = $mysqli->prepare('INSERT INTO myCity (Name, CountryCode, District) VALUES (?,?,?)');


    $stmt->execute(['Stuttgart', 'DEU', 'Baden-Wuerttemberg']);


    $query = 'SELECT Name, CountryCode, District FROM myCity';
    $result = $mysqli->query($query);
    while (    $row = $result->fetch_row()) {
    printf("%s (%s,%s)\n", $row[0], $row[1], $row[2]);
    }

    Style procédural

    <?php

    mysqli_report    (MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
    $link = mysqli_connect('localhost', 'my_user', 'my_password', 'world');

    mysqli_query($link, 'CREATE TEMPORARY TABLE myCity LIKE City');


    $stmt = mysqli_prepare($link, 'INSERT INTO myCity (Name, CountryCode, District) VALUES (?,?,?)');


    mysqli_stmt_execute($stmt, ['Stuttgart', 'DEU', 'Baden-Wuerttemberg']);


    $query = 'SELECT Name, CountryCode, District FROM myCity';
    $result = mysqli_query($link, $query);
    while (    $row = mysqli_fetch_row($result)) {
    printf("%s (%s,%s)\n", $row[0], $row[1], $row[2]);
    }

    Les exemples ci-dessus vont afficher :

    Stuttgart (DEU,Baden-Wuerttemberg)

    Voir aussi

    To Top