array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.mysql-list-tables.php', 1 => 'mysql_list_tables', 2 => 'Lista as tabelas em um banco de dados MySQL', ), 'up' => array ( 0 => 'ref.mysql.php', 1 => 'Funções da MySQL', ), 'prev' => array ( 0 => 'function.mysql-list-processes.php', 1 => 'mysql_list_processes', ), 'next' => array ( 0 => 'function.mysql-num-fields.php', 1 => 'mysql_num_fields', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/mysql/functions/mysql-list-tables.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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

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