Manuel PHP

MySQLi
PHP Manual

mysqli::change_user

mysqli_change_user

(PHP 5)

mysqli::change_user -- mysqli_change_user — Change l'utilisateur de la connexion spécifiée

Description

Style orienté objet :

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

Style procédural :

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

Change l'utilisateur de la connexion spécifiée par le paramètre link et change la base de données courante pour celle spécifiée par le paramètre database .

Pour que cette fonction réussisse, les paramètres username et password doivent être valides et l'utilisateur en question doit avoir les permissions d'accès à la base de données désirée. Si pour une raison ou une autre, l'autorisation échoue, l'utilisateur courant sera conservé.

Liste de paramètres

link

Style procédural uniquement : Un identifiant de lien retourné par la fonction mysqli_connect() ou par la fonction mysqli_init()

user

Le nom d'utilisateur MySQL.

password

Le mot de passe MySQL.

database

La base de données à utiliser.

Vous pouvez passer la valeur NULL à ce paramètre pour ne changer que l'utilisateur. Dans ce cas, vous pouvez utiliser la fonction mysqli_select_db() pour changer de base de données.

Valeurs de retour

Cette fonction retourne TRUE en cas de succès, FALSE en cas d'échec.

Notes

Note: L'utilisation de cette commande implique toujours que la connexion soit considérée comme neuve, que la fonction réussisse ou non. Un appel à cette fonction annulera donc toutes les transactions actives, fermera les tables temporaires et déverrouillera les tables verrouillées.

Exemples

Exemple #1 Style orienté objet

  1. <?php
  2.  
  3. /* Connexion à la base de données test */  
  4. $mysqli = new mysqli("localhost", "my_user", "my_password", "test");  
  5.  
  6. /* Vérification de la connexion */  
  7. if (mysqli_connect_errno()) { 
  8.    printf("Échec de la connexion : %s\n", mysqli_connect_error()); 
  9.    exit();  
  10. }  
  11.  
  12. /* Définition de la variable "a" */  
  13. $mysqli->query("SET @a:=1");  
  14.  
  15. /* réinitialise tout et sélectionne une nouvelle base de données */  
  16. $mysqli->change_user("my_user", "my_password", "world");  
  17.  
  18. if ($result = $mysqli->query("SELECT DATABASE()")) { 
  19.    $row = $result->fetch_row(); 
  20.    printf("Base de données par défaut : %s\n", $row[0]); 
  21.    $result->close();  
  22. }  
  23.  
  24. if ($result = $mysqli->query("SELECT @a")) { 
  25.    $row = $result->fetch_row(); 
  26.    if ($row[0] === NULL) { 
  27.       printf("La valeur de la variable a est NULL\n"); 
  28.    } 
  29.    $result->close();  
  30. }  
  31.  
  32. /* Fermeture de la connexion */  
  33. $mysqli->close();  
  34. ?> 

Exemple #2 Style procédural

  1. <?php
  2. /* Connexion à la base de données test */  
  3. $link = mysqli_connect("localhost", "my_user", "my_password", "test");  
  4.  
  5. /* Vérification de la connexion */  
  6. if (!$link) { 
  7.    printf("Échec de la connexion : %s\n", mysqli_connect_error()); 
  8.    exit();  
  9. }  
  10.  
  11. /* Définition de la variable "a" */  
  12. mysqli_query($link, "SET @a:=1");  
  13.  
  14. /* réinitialise tout et sélectionne une nouvelle base de données */  
  15. mysqli_change_user($link, "my_user", "my_password", "world");  
  16.  
  17. if ($result = mysqli_query($link, "SELECT DATABASE()")) { 
  18.    $row = mysqli_fetch_row($result); 
  19.    printf("Base de données par défaut : %s\n", $row[0]); 
  20.    mysqli_free_result($result);  
  21. }  
  22.  
  23. if ($result = mysqli_query($link, "SELECT @a")) { 
  24.    $row = mysqli_fetch_row($result); 
  25.    if ($row[0] === NULL) { 
  26.       printf("La valeur de la variable a est NULL\n"); 
  27.    } 
  28.    mysqli_free_result($result);  
  29. }  
  30.  
  31. /* Fermeture de la connexion */  
  32. mysqli_close($link);  
  33. ?> 

L'exemple ci-dessus va afficher :

Base de données par défaut : world La valeur de la variable a est NULL

Voir aussi

MySQLi
PHP Manual

Remonter Remonter
L'éditeur javascript - CSS - Gentoo - Tutoriaux PHP - Tutoriels PHP - Bretagne - php - Moto - Kit graphique