(PHP 5, PHP 7, PHP 8)
mysqli::change_user -- mysqli_change_user — Altera o usuário da conexão com o banco de dados
Estilo orientado a objetos
$username, #[\SensitiveParameter] string $password, ?string $database): boolEstilo procedural
$mysql,$username,$password,$databaseTenta conexão ao banco de dados especificado usando as credenciais fornecidas.
Em comparação ao método mysqli::connect(), este método não não fechará a conexão atual se a nova conexão não puder ser aberta.
Para conseguir mudar usuários com sucesso, os parâmetors username e
password fornecidos devem ser válidos e este usuário deve ter
permissões suficientes para acessar o banco de dados desejado. Se por qualquer motivo a autorização
falhar, a autenticação do usuário atual irá permanecer.
mysqlSomente no estilo procedural: Um objeto mysqli retornado por mysqli_connect() ou mysqli_init()
usernameO nome do usuário MySQL.
passwordA senha MySQL.
database
O nome do banco de dados. Se null ou uma string vazia forem passados,
a conexão ao servidor será aberta sem banco de dados padrão.
Se o relatório de erros da extensão mysqli estiver habilitado (MYSQLI_REPORT_ERROR) e a operação solicitada falhar,
um aviso será gerado. Se, além disso, o modo for definido como MYSQLI_REPORT_STRICT,
uma exceção mysqli_sql_exception será lançada em vez do aviso.
Exemplo #1 Redefinindo a sessão da conexão
Estilo orientado a objetos
<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$mysqli = new mysqli("localhost", "meu_usuario", "minha_senha", "teste");
$mysqli->query("SET @a:=1");
$mysqli->change_user("meu_usuario", "minha_senha", "mundo");
$result = $mysqli->query("SELECT DATABASE()");
$row = $result->fetch_row();
printf("Banco de dados padrão: %s\n", $row[0]);
$result = $mysqli->query("SELECT @a");
$row = $result->fetch_row();
if ($row[0] === null) {
printf("Valor da variável 'a' é NULL\n");
}Estilo procedural
<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$link = mysqli_connect("localhost", "meu_usuario", "minha_senha", "teste");
mysqli_query($link, "SET @a:=1");
mysqli_change_user($link, "meu_usuario", "minha_senha", "mundo");
$result = mysqli_query($link, "SELECT DATABASE()");
$row = mysqli_fetch_row($result);
printf("Banco de dados padrão: %s\n", $row[0]);
$result = mysqli_query($link, "SELECT @a");
$row = mysqli_fetch_row($result);
if ($row[0] === null) {
printf("Valor da variável 'a' é NULL\n");
}Os exemplos acima produzirão:
Banco de dados padrão: mundo Valor da variável 'a' é NULL
Exemplo #2 Se database for null a conexão é aberta sem selecionar nenhum banco de dados padrão
Estilo orientado a objetos
<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$mysqli = new mysqli("localhost", "meu_usuario", "minha_senha", "teste");
$mysqli->change_user("meu_usuario", "minha_senha", null);
$result = $mysqli->query("SELECT DATABASE()");
$row = $result->fetch_row();
printf("Banco de dados padrão: %s\n", $row[0]);Os exemplos acima produzirão:
Banco de dados padrão:
Nota:
Usar este comando sempre irá fazer com que a conexão atual se comporte como se fosse uma conexão totalmente nova, não importando se a operação foi completada com sucesso. Esta reinicialização inclui realizar uma reversão de dados em quaisquer transações ativas, fechando todas as tabelas temporárias e destravando todas as tabelas travadas.