Lista as tabelas em um banco de dados MySQL

# mysql_list_tables

(PHP 4, PHP 5)

mysql_list_tables — Lista as tabelas em um banco de dados MySQL

Aviso

Esta função foi descontinuada a partir do PHP 4.3.0 e ela e a extensão MySQL original foram removidas a partir do PHP 7.0.0. Em vez disso, use as extensões MySQLi ou PDO_MySQL, que são desenvolvidas ativamente. Veja também o guia MySQL: escolhendo uma API. Alternativas a esta função incluem:

- SQL Query: `SHOW TABLES FROM dbname`

### Descrição

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

Obtém uma lista de nomes de tabelas de um banco de dados MySQL.

Esta função foi preterida em favor de mysql_query() para emitir uma instrução SQL `SHOW TABLES [FROM db_name] [LIKE 'pattern']` em seu lugar.

### Parâmetros

`database`
  O nome do banco de dados
`link_identifier`
  A conexão MySQL. Se o identificador da conexão não for especificado, a última conexão aberta por mysql_connect() será usada. Se não houver uma conexão anterior, haverá uma tentativa de criar uma como se mysql_connect() tivesse sido chamada sem argumentos. Se nenhuma conexão for encontrada ou estabelecida, um erro de nível `E_WARNING` será gerado.

### Valor Retornado

Um ponteiro de resultado do tipo resource em caso de sucesso ou `false` em caso de falha.

A função mysql_tablename() deve ser usada para navegar pelo ponteiro de resultados, ou qualquer função para tabelas de resultados, como mysql_fetch_array().

### Exemplos

Exemplo #1 Exemplo alternativo de mysql_list_tables()

    <?php
    $dbname = 'mysql_dbname';

    if (!mysql_connect('mysql_host', 'mysql_user', 'mysql_password')) {
        echo 'Não foi possível conectar ao MySQL';
        exit;
    }

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

    if (!$result) {
        echo "Erro de BD, não foi possível listar as tabelas\n";
        echo 'Erro do MySQL: ' . mysql_error();
        exit;
    }

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

    mysql_free_result($result);
    ?>

### Notas

> Nota: Para compatibilidade com versões anteriores, o seguinte apelido descontinuado pode ser usado: mysql_listtables()

### Veja Também

- mysql_list_dbs() - Lista os bancos de dados disponíveis em um servidor MySQL
- mysql_tablename() - Obtém o nome da tabela do campo

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