mysqli_change_user

(PHP 5)

mysqli_change_user -- 指定されたデータベース接続のユーザー名を変更する

説明

bool mysqli_change_user ( resource link, string user, string password, string database)

mysqli_change_user()link 引数で指定されたデータベース接続のユーザー名を変更し、 database引数で指定されたデータベース をカレントにセットします。

成功した場合に TRUE 、失敗した場合に FALSE を返します。

database引数には NULL 値を渡すこともできます。 その場合ユーザーの変更だけでデータベースの選択はされません。 そのようなケースでデータベースを選択したい場合には mysqli_select_db()関数を使用してください。

ユーザーを正しく変更するにはusernamepassword引数を正しく渡す必要があります。 またそのユーザーは対象のデータベースに対する適切なパーミッションを 持っている必要があります。何であれ認証に失敗するとカレントのユーザーの 認証が継続されます。

注意: このコマンドを使用すると、常に、カレントのデータベース接続は あたかも完全に新しいデータベース接続であるかのようになります。 これにより、全てのアクティブなトランザクションはロールバックされ、 一次テーブルは全てクローズされ、ロックされたテーブルはすべて 開放されます。

例 1. mysqli_change_user 関数の使用例

<?php

    
/* foo@localhost としてデータベースに接続し、 foo_dbを選択 */
    
$link = mysqli_connect("localhost", "foo", "pass");
    
mysqli_select_db("foo_db");

    
/* ユーザーをbar@localhostに、またデフォルトのデータベースをbar_dbに変更 */
    
mysqli_change_user($link, "bar", "otherpass", "bar_db");

?>