Become Zend Certified

Prepare for the ZCE exam using our quizzes (web or iPad/iPhone). More info...

When you're ready get 7.5% off your exam voucher using voucher CJQNOV23 at the Zend Store


(PHP 4, PHP 5)

mysql_list_tablesList tables in a MySQL database


This extension is deprecated as of PHP 5.5.0, and will be removed in the future. Instead, the MySQLi or PDO_MySQL extension should be used. See also MySQL: choosing an API guide and related FAQ for more information. Alternatives to this function include:

  • SQL Query: SHOW TABLES FROM sometable


resource mysql_list_tables ( string $database [, resource $link_identifier = NULL ] )

Retrieves a list of table names from a MySQL database.

This function is deprecated. It is preferable to use mysql_query() to issue an SQL SHOW TABLES [FROM db_name] [LIKE 'pattern'] statement instead.



The name of the database


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() was called with no arguments. If no connection is found or established, an E_WARNING level error is generated.

Return Values

A result pointer resource on success or FALSE on failure.

Use the mysql_tablename() function to traverse this result pointer, or any function for result tables, such as mysql_fetch_array().


Version Description
4.3.7 This function became deprecated.


Example #1 mysql_list_tables() alternative example


if (!
mysql_connect('mysql_host''mysql_user''mysql_password')) {
'Could not connect to mysql';

$sql "SHOW TABLES FROM $dbname";
$result mysql_query($sql);

if (!
$result) {
"DB Error, could not list tables\n";
'MySQL Error: ' mysql_error();

while (
$row mysql_fetch_row($result)) {
"Table: {$row[0]}\n";




For backward compatibility, the following deprecated alias may be used: mysql_listtables()

See Also

PHP Manual