mysqli
PHP Manual

mysqli_change_user

mysqli->change_user

(PHP 5)

mysqli->change_user — Сменить пользователя соединения

Описание

Процедурный стиль:

bool mysqli_change_user ( mysqli $link , string $user , string $password , string $database )

Объектно-ориентированный стиль (метод):

mysqli
bool change_user ( string $user , string $password , string $database )

Функция mysqli_change_user() используется для изменения пользователя соединения с базой данных, переданного в параметре link и устанавливает в качестве текущей базу данных, определенную параметром database .

В качестве параметра database может быть передан NULL. В результате будет изменен лишь пользователь, а база данных выбрана не будет. В этом случае для выбора базы данных используйте функцию mysqli_select_db().

Для успешной смены пользователя необходимо обеспечить передачу действительных параметров username и password , а указанный пользователь должен иметь достаточные права для доступа к запрашиваемой базе данных. Если по каким-либо причинам произойдет ошибка авторизации, авторизация текущего пользователя останется в прежнем состоянии.

Note: После этой функции, подключение к базе данных будет вести себя, как полностью новое соединение, вне зависимости от того, была ли операция завершена успешно. Это включает в себя откат всех незавершенных транзакций, закрытие всех временных и разблокирование заблокированных таблиц.

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

Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки.

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

mysqli_connect() и mysqli_select_db().

Примеры

Example#1 Объектно-ориентированный стиль

<?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("Значение переменной a: NULL\n");
    }
    
$result->close();
}

/* Закрытие соединения */
$mysqli->close();
?>

Example#2 Процедурный стиль

<?php
/* Подключение к базе данных  */
$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("Значение переменной a: NULL\n");
    }
    
mysqli_free_result($result);
}

/* Закрытие соединения */
mysqli_close($link);
?>

Результат выполнения данного примера:

База данных по-умолчанию: world Значение переменной a: NULL

mysqli
PHP Manual