maxdb_change_user
(PECL)
maxdb_change_user
(no version information, might be only in CVS)
maxdb->change_user -- 指定したデータベース接続のユーザを変更する
説明
手続き型
bool
maxdb_change_user ( resource link, string user, string password, string database )
オブジェクト指向型 (メソッド)
class
maxdb {
bool
change_user ( string user, string password, string database )
}
maxdb_change_user() は、パラメータ link
で指定したデータベース接続のユーザを変更し、現在のデータベースを
database で指定したものに変更するために使用します。
ユーザの変更を行うには、username および
password に有効な値が指定されていること、
そして指定したデータベースに対する適切なアクセス権がユーザに与えられていることが必要です。
何らかの理由で認証に失敗すると、現在のユーザ認証のままの状態となります。
注意:
このコマンドを使用すると、その操作が正常に終了したか否かにかかわらず、
新しくデータベースに接続したのと同じように扱われます。つまり、
現在アクティブなトランザクションはすべてロールバックされ、
一時テーブルはすべて閉じられ、テーブルに対するロックもすべて解除されます。
返り値
成功した場合に TRUE を、失敗した場合に FALSE を返します。
例
例 1. オブジェクト指向型
<?php
/* test データベースに接続します */ $maxdb = new maxdb("localhost", "MONA", "RED", "DEMODB");
/* 接続を調べます */ if (maxdb_connect_errno()) { printf("接続に失敗しました: %s\n", maxdb_connect_error()); exit(); }
if ($result = $maxdb->query("SELECT * FROM dual")) { $row = $result->fetch_row(); printf("結果: %s\n", $row[0]); $result->free(); }
/* すべてをリセットし、新しいデータベースを選択します */ if (!$maxdb->change_user("DBADMIN", "SECRET", "DEMODB")) { printf("データベースが稼動していません\n"); } else { printf("データベースが稼動中です\n"); }
/* 接続を閉じます */ $maxdb->close(); ?>
|
|
例 2. 手続き型
<?php $link = maxdb_connect("localhost", "MONA", "RED", "DEMODB");
/* 接続を調べます */ if (!$link) { printf("接続に失敗しました: %s\n", maxdb_connect_error()); exit(); }
if ($result = maxdb_query($link, "SELECT * FROM dual")) { $row = maxdb_fetch_row($result); printf("結果: %s\n", $row[0]); maxdb_free_result($result); }
/* すべてをリセットし、新しいデータベースを選択します */ if (!maxdb_change_user($link, "DBADMIN", "SECRET", "DEMODB")) { printf("データベースが稼動していません\n"); } else { printf("データベースが稼動中です\n"); }
/* 接続を閉じます */ maxdb_close($link); ?>
|
|
上の例の出力は、たとえば以下のようになります。