(PECL maxdb:1.0-7.6.00.38)
maxdb_change_user -- maxdb->change_user — 指定したデータベース接続のユーザを変更する
手続き型
オブジェクト指向型 (メソッド)
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);
?>
上の例の出力は、たとえば 以下のようになります。
結果: a データベースが稼動中です