Retourne la valeur générée pour une colonne AUTO_INCREMENT par la dernière requête

# mysqli::$insert_id

# mysqli_insert_id

(PHP 5, PHP 7, PHP 8)

mysqli::$insert_id -- mysqli_insert_id — Retourne la valeur générée pour une colonne AUTO_INCREMENT par la dernière requête

### Description

Style orienté objet

int|string $mysqli->insert_id;

Style procédural

function mysqli_insert_id(mysqli `$mysql`): int|string

Retourne l'ID généré par une requête `INSERT` ou `UPDATE` sur une table avec une colonne ayant l'attribut `AUTO_INCREMENT`. Dans le cas des requêtes multilignes `INSERT`, ceci retourne la première valeur automatiquement générée qui a été insérée avec succès.

Exécuter une requête `INSERT` ou `UPDATE` utilisant la fonction MySQL `LAST_INSERT_ID()` modifiera aussi la valeur retournée par mysqli_insert_id(). Si `LAST_INSERT_ID(expr)` a été utilisé pour générer la valeur de `AUTO_INCREMENT`, ceci retourne la valeur de la dernière `expr` à la place de la valeur générée de `AUTO_INCREMENT`.

Retourne `0` si la requête précédente n'a pas changé la valeur de `AUTO_INCREMENT`. mysqli_insert_id() doit être appelé immédiatement après que la requête ait généré la valeur.

### Liste de paramètres

`mysql`
  Seulement en style procédural : Un objet mysqli retourné par la fonction mysqli_connect() ou mysqli_init().

### Valeurs de retour

La valeur du champ `AUTO_INCREMENT` modifiée par la dernière requête. Retourne zéro s'il n'y a pas eu de requête sur la connexion ou si la dernière requête n'a pas modifié la valeur de l'`AUTO_INCREMENT`.

Seules les requêtes émises par la connexion courante affectent la valeur de retour. La valeur n'est pas affectée par les requêtes utilisant d'autres connexions ou clients.

> Note:

> Si le nombre est plus grand que la valeur maximale d'un entier, elle sera retournée sous forme de chaîne de caractères.

### Exemples

Exemple #1 Exemple avec $mysqli->insert_id

Style orienté objet

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

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

    $query = "INSERT INTO myCity VALUES (NULL, 'Stuttgart', 'DEU', 'Stuttgart', 617000)";
    $mysqli->query($query);

    printf("Le nouvel enregistrement a l'ID %d.\n", $mysqli->insert_id);

    /* Supprime la table */
    $mysqli->query("DROP TABLE myCity");
    ?>

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 TABLE myCity LIKE City");

    $query = "INSERT INTO myCity VALUES (NULL, 'Stuttgart', 'DEU', 'Stuttgart', 617000)";
    mysqli_query($link, $query);

    printf("Le nouvel enregistrement a l'ID %d.\n", mysqli_insert_id($link));

    /* Supprime la table */
    mysqli_query($link, "DROP TABLE myCity");
    ?>

Les exemples ci-dessus vont afficher :

    Le nouvel enregistrement a l'ID 1.

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open