Copyright 1997-2021 the PHP Documentation Group.
mysql_insert_id
Get the ID generated in the last query
This extension was deprecated in PHP 5.5.0, and it was removed in PHP 7.0.0. Instead, theMySQLiorPDO_MySQLextension should be used. See alsoMySQL: choosing an APIguide. Alternatives to this function include:
mysqli_insert_id |
PDO::lastInsertId |
Description
intmysql_insert_id(resourcelink_identifier= =NULL);
Retrieves the ID generated for an AUTO_INCREMENT column by the previous query (usually INSERT).
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 ifmysql_connect
had been called with no arguments. If no connection is found or established, anE_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, orfalse
if no MySQL connection was established.
Examples
Notes
mysql_insert_id
will convert the return type of the native MySQL C API functionmysql_insert_id()
to a type oflong
(namedintin 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 theintegerdocumentation.
Becausemysql_insert_id
acts on the last performed query, be sure to callmysql_insert_id
immediately after the query that generates the value.
The value of the MySQL SQL functionLAST_INSERT_ID()
always contains the most recently generated AUTO_INCREMENT value, and is not reset between queries.
See Also
mysql_query |
mysql_info |