mysql_insert_id
Get the ID generated in the last query
Warning
This extension was deprecated in PHP 5.5.0, and it was removed in PHP 7.0.0.
Instead, the MySQLi or PDO_MySQL extension should be used.
See also MySQL: choosing an API guide.
Alternatives to this function include:
- mysqli_insert_id
- PDO::lastInsertId
Description
int mysql_insert_id(resource $link_identifier
= NULL)
Parameters
-
link_identifier
-
The MySQL connection. If the
link identifier is not specified, the last link opened by
mysql_connect is assumed. If no such link is found, it
will try to create one as if mysql_connect had been called
with no arguments. If no connection is found or established, an
E_WARNING
level error is generated.
Return Values
The ID generated for an AUTO_INCREMENT column by the previous
query on success, 0
if the previous
query does not generate an AUTO_INCREMENT value, or false
if
no MySQL connection was established.
Examples
Example #1 mysql_insert_id example
<?php
$link = mysql_connect('localhost', 'mysql_user', 'mysql_password');
if (!$link) {
die('Could not connect: ' . mysql_error());
}
mysql_select_db('mydb');
mysql_query("INSERT INTO mytable (product) values ('kossu')");
printf("Last inserted record has id %d\n", mysql_insert_id());
?>
Notes
Caution
mysql_insert_id will convert the return type of the
native MySQL C API function mysql_insert_id()
to a type
of long
(named int in PHP). If your
AUTO_INCREMENT column has a column type of BIGINT (64 bits) the
conversion may result in an incorrect value. Instead, use the internal
MySQL SQL function LAST_INSERT_ID() in an SQL query. For more information
about PHP's maximum integer values, please see the
integer documentation.
Note:
Because mysql_insert_id acts on the last performed
query, be sure to call mysql_insert_id immediately
after the query that generates the value.
Note:
The value of the MySQL SQL function
LAST_INSERT_ID()
always contains the most
recently generated AUTO_INCREMENT value, and is not reset
between queries.