mysql_list_dbs
(PHP 4, PHP 5)
mysql_list_dbs — Возвращает список баз данных, доступных на сервере
Данное расширение устарело, начиная с версии PHP 5.5.0, и будет удалено в будущем. Используйте вместо него MySQLi или PDO_MySQL. Смотрите также инструкцию MySQL: выбор API и соответствующий FAQ для получения более подробной информации. Альтернативы для данной функции:
- SQL запрос: SHOW DATABASES
Описание
$link_identifier = NULL
] )Возвращает указатель на результат, содержащий список баз данных, доступных на указанном сервере.
Эта функция УСТАРЕЛА начиная с версии PHP 5.4.0. Использование этой функции не рекомендуется.
Список параметров
-
link_identifier -
Соединение MySQL. Если идентификатор соединения не был указан, используется последнее соединение, открытое mysql_connect(). Если такое соединение не было найдено, функция попытается создать таковое, как если бы mysql_connect() была вызвана без параметров. Если соединение не было найдено и не смогло быть создано, генерируется ошибка уровня
E_WARNING.
Возвращаемые значения
Возвращает resource результата в случае успеха, или
FALSE в случае ошибки. Используйте функцию
mysql_tablename(), чтобы получить
данные из результата, или любую другую функцию, работающую с результатами
запросов, например mysql_fetch_array().
Примеры
Пример #1 Пример использования mysql_list_dbs()
<?php
// Без использования mysql_list_dbs()
$link = mysql_connect('localhost', 'mysql_user', 'mysql_password');
$res = mysql_query("SHOW DATABASES");
while ($row = mysql_fetch_assoc($res)) {
echo $row['Database'] . "\n";
}
// Устарело, начиная с PHP 5.4.0
$link = mysql_connect('localhost', 'mysql_user', 'mysql_password');
$db_list = mysql_list_dbs($link);
while ($row = mysql_fetch_object($db_list)) {
echo $row->Database . "\n";
}
?>
Результатом выполнения данного примера будет что-то подобное:
database1 database2 database3
Примечания
Замечание:
Для обратной совместимости может быть использован следующий устаревший псевдоним: mysql_listdbs()
Смотрите также
- mysql_db_name() - Возвращает название базы данных из вызова к mysql_list_dbs
- mysql_select_db() - Выбирает базу данных MySQL
- PHP Руководство
- Функции по категориям
- Индекс функций
- Справочник функций
- Расширения для работы с базами данных
- Расширения для работы с базами данных отдельных производителей
- MySQL Drivers and Plugins
- Оригинальное API MySQL
- mysql_affected_rows
- mysql_client_encoding
- mysql_close
- mysql_connect
- mysql_create_db
- mysql_data_seek
- mysql_db_name
- mysql_db_query
- mysql_drop_db
- mysql_errno
- mysql_error
- mysql_escape_string
- mysql_fetch_array
- mysql_fetch_assoc
- mysql_fetch_field
- mysql_fetch_lengths
- mysql_fetch_object
- mysql_fetch_row
- mysql_field_flags
- mysql_field_len
- mysql_field_name
- mysql_field_seek
- mysql_field_table
- mysql_field_type
- mysql_free_result
- mysql_get_client_info
- mysql_get_host_info
- mysql_get_proto_info
- mysql_get_server_info
- mysql_info
- mysql_insert_id
- mysql_list_dbs
- mysql_list_fields
- mysql_list_processes
- mysql_list_tables
- mysql_num_fields
- mysql_num_rows
- mysql_pconnect
- mysql_ping
- mysql_query
- mysql_real_escape_string
- mysql_result
- mysql_select_db
- mysql_set_charset
- mysql_stat
- mysql_tablename
- mysql_thread_id
- mysql_unbuffered_query
Коментарии
The result pointer contains only the databases for which the mysql_user has the select priviledge granted.The example is wrong in Spanish version.
ERROR: mysql_fetch_assoc() expects parameter 1 to be resource, null given in XXX on line 5
while ($fila = mysql_fetch_assoc($res)) {
OK.
while ($fila = mysql_fetch_assoc($resultado)) {
There is no direct equivalent of mysql_list_dbs() as a mysqli_list_dbs() command, but you can query "show databases" instead.
So this:
$db_list = mysql_list_dbs($connect); //mysql
Is equivalent to this:
$db_list = mysqli_query($connect, "SHOW DATABASES"); //mysqli