Извлекает список таблиц базы данных MySQL

# mysql_list_tables

(PHP 4, PHP 5)

mysql_list_tables — Извлекает список таблиц базы данных MySQL

Внимание

Функция устарела в PHP 4.3.0, а в PHP 7.0.0 функцию удалили вместе с модулем MySQL. Вместо этой функции пользуются модулями MySQLi или PDO_MySQL, которые активно развиваются. Смотрите также раздел «MySQL: выбор API». Разработчикам доступны следующие альтернативы:

- SQL запрос: `SHOW TABLES FROM dbname`

### Описание

function mysql_list_tables(string `$database`, resource `$link_identifier` = NULL): resource|false

Функция возвращает список имён таблиц базы данных MySQL.

Функция устарела. Вместо неё рекомендуют использовать функцию mysql_query() с запросом `SHOW TABLES [FROM db_name] [LIKE 'pattern']`.

### Список параметров

`database`
  Имя базы данных.
`link_identifier`
  Соединение MySQL. Если идентификатор соединения не был указан, будет использовано последнее соединение, открытое mysql_connect(). Если такое соединение не было найдено, функция попытается создать таковое, как если бы mysql_connect() была вызвана без параметров. Если соединение не было найдено и не смогло быть создано, генерируется ошибка уровня `E_WARNING`.

### Возвращаемые значения

В случае успешного выполнения функция возвращает дескриптор результата (resource) или `false`, если возникла ошибка.

Для работы с результатом запроса вызывают функцию mysql_tablename() или другую функцию, которая умеет это делать, например функцию mysql_fetch_array().

### Примеры

Пример #1 Пример извлечения списка таблиц БД MySQL функцией mysql_list_tables()

    <?php

    $dbname = 'mysql_dbname';

    if (!mysql_connect('mysql_host', 'mysql_user', 'mysql_password')) {
        echo 'Ошибка подключения к mysql';
        exit;
    }

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

    if (!$result) {
        echo "Ошибка базы, не удалось получить список таблиц\n";
        echo 'Ошибка MySQL: ' . mysql_error();
        exit;
    }

    while ($row = mysql_fetch_row($result)) {
        echo "Таблица: {$row[0]}\n";
    }

    mysql_free_result($result);

    ?>

### Примечания

> Замечание: Для обратной совместимости может быть использован следующий устаревший псевдоним: mysql_listtables()

### Смотрите также

- mysql_list_dbs() - Возвращает список баз данных, доступных на сервере
- mysql_tablename() - Возвращает имя таблицы, содержащей указанное поле

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open