mysqli::change_user
mysqli_change_user
(PHP 5, PHP 7)
mysqli::change_user -- mysqli_change_user — Позволяет сменить пользователя подключённого к базе данных
Описание
Объектно-ориентированный стиль
$username, string $password, string|null $database): boolПроцедурный стиль
Меняет пользователя, от имени которого выполнено подключение к базе данных, и устанавливает текущую базу данных
Для успешной смены пользователя необходимы корректные username
и password, а также наличие достаточных прав для работы с базой.
Если смена пользователя закончится ошибкой, сохранится текущая авторизация пользователя,
до вызова функции.
Список параметров
-
link -
Только для процедурного стиля: Объект mysqli, полученный с помощью mysqli_connect() или mysqli_init()
-
username -
Имя пользователя для доступа к MySQL
-
password -
Пароль для доступа к MySQL
-
database -
Имя базы данных
Если требуется сменить пользователя без выбора базы данных, следует указывать
null. Для выбора базы данных, необходимо использовать функцию mysqli_select_db().
Возвращаемые значения
Возвращает true в случае успешного завершения или false в случае возникновения ошибки.
Примечания
Замечание:
В результате вызова функции текущее соединение с базой данных начинает вести себя так, как будто было создано новое соединение. Независимо от результата операции, вызов функции приводит к откату всех активных транзакций, закрытию временных таблиц и разблокировки всех заблокированных таблиц.
Примеры
Пример #1 Пример использования mysqli::change_user()
Объектно-ориентированный стиль
<?php
/* создаём подключение к базе данных test */
$mysqli = new mysqli("localhost", "my_user", "my_password", "test");
/* проверяем соединение */
if (mysqli_connect_errno()) {
printf("Подключение не удалось: %s\n", mysqli_connect_error());
exit();
}
/* устанавливаем переменную a */
$mysqli->query("SET @a:=1");
/* все сбрасываем и выбираем новую базу данных */
$mysqli->change_user("my_user", "my_password", "world");
if ($result = $mysqli->query("SELECT DATABASE()")) {
$row = $result->fetch_row();
printf("База данных по умолчанию: %s\n", $row[0]);
$result->close();
}
if ($result = $mysqli->query("SELECT @a")) {
$row = $result->fetch_row();
if ($row[0] === NULL) {
printf("Значение переменной - NULL\n");
}
$result->close();
}
/* закрываем соединение */
$mysqli->close();
?>
Процедурный стиль
<?php
/* создаём подключение к базе данных test */
$link = mysqli_connect("localhost", "my_user", "my_password", "test");
/* проверяем соединение */
if (!$link) {
printf("Подключение не удалось: %s\n", mysqli_connect_error());
exit();
}
/* устанавливаем переменную a */
mysqli_query($link, "SET @a:=1");
/* все сбрасываем и выбираем новую базу данных */
mysqli_change_user($link, "my_user", "my_password", "world");
if ($result = mysqli_query($link, "SELECT DATABASE()")) {
$row = mysqli_fetch_row($result);
printf("База данных по умолчанию: %s\n", $row[0]);
mysqli_free_result($result);
}
if ($result = mysqli_query($link, "SELECT @a")) {
$row = mysqli_fetch_row($result);
if ($row[0] === NULL) {
printf("Значение переменной - NULL\n");
}
mysqli_free_result($result);
}
/* закрываем соединение */
mysqli_close($link);
?>
Результат выполнения данных примеров:
База данных по умолчанию: world Значение переменной - NULL
Смотрите также
- mysqli_connect() - Псевдоним mysqli::__construct
- mysqli_select_db() - Устанавливает базу данных для выполняемых запросов
add a note
