# mysqli::$insert_id

# mysqli_insert_id

(PHP 5, PHP 7, PHP 8)

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

### Description

Style orienté objet

int|string $mysqli->insert_id;

Style procédural

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é qui a été inséré avec succès.

Exécuter une requête `INSERT` ou `UPDATE` utilisant la fonction MySQL `LAST_INSERT_ID()` modifiera aussi la valeur retourné 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é 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`.

Seul les requêtes émises par la connexion courante affecte la valeur de retour. La valeur n'est pas affecté 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é sous une 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("New record has ID %d.\n", $mysqli->insert_id);
/* drop 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("New record has ID %d.\n", mysqli_insert_id($link));
/* drop table */
mysqli_query($link, "DROP TABLE myCity");
?>`

Les exemples ci-dessus vont afficher :

    New record has ID 1.