6.5.31mysql_insert_id

Copyright 1997-2021 the PHP Documentation Group.

  • 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, 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 bymysql_connectis assumed. If no such link is found, it will try to create one as ifmysql_connecthad been called with no arguments. If no connection is found or established, anE_WARNINGlevel error is generated.

Return Values

The ID generated for an AUTO_INCREMENT column by the previous query on success,0if the previous query does not generate an AUTO_INCREMENT value, orfalseif no MySQL connection was established.

Examples

Example 6.38mysql_insert_idexample


Notes

Caution

mysql_insert_idwill 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.

Note

Becausemysql_insert_idacts on the last performed query, be sure to callmysql_insert_idimmediately after the query that generates the value.

Note

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