mysqli_real_connect
(PHP 5)
mysqli_real_connect
(no version information, might be only in CVS)
mysqli->real_connect -- mysql サーバとの接続をオープンする
説明
手続き型
bool
mysqli_real_connect ( mysqli link [, string hostname [, string username [, string passwd [, string dbname [, int port [, string socket [, int flags]]]]]]] )
オブジェクト指向型（メソッド）
class
mysqli {
bool
real_connect ( [string hostname [, string username [, string passwd [, string dbname [, int port [, string socket [, int flags]]]]]]] )
}
mysqli_real_connect() は
hostname で稼動中の MySQL データベースとの
接続の確立を試みます。
この関数は mysqli_connect() とは違います。
mysqli_real_connect() は、
mysqli_init() が作成した接続オブジェクトを
必要とします。
mysqli_options() 関数を使用して、さまざまな
接続オプションを設定することが可能です。
flags パラメータで、別の接続オプションを
設定可能です。
表 1. サポートされるフラグ
| 名前 | 説明 |
|---|
| MYSQLI_CLIENT_COMPRESS | 圧縮プロトコルを使用します。 |
| MYSQLI_CLIENT_FOUND_ROWS | 変更された行数ではなく、マッチした行数を返します。 |
| MYSQLI_CLIENT_IGNORE_SPACE | 関数名に続く空白文字を許可します。すべての関数名を予約語とします。 |
| MYSQLI_CLIENT_INTERACTIVE |
接続を閉じるまでのタイムアウト時間として、
（wait_timeout のかわりに）
interactive_timeout の使用を許可します。
|
| MYSQLI_CLIENT_SSL | SSL（暗号化）を使用します。 |
注意:
セキュリティの観点から、PHP では MULTI_STATEMENT
フラグはサポートされていません。複数のクエリを実行したい場合は、
mysqli_multi_query() 関数を使用してください。
返り値
成功した場合に TRUE を、失敗した場合に FALSE を返します。
例
例 1. オブジェクト指向型
<?php
/* 接続オブジェクトを作成します。まだ接続はしていません */
$mysqli = mysqli_init();
/* 接続オプションを設定します */
$mysqli->options(MYSQLI_INIT_COMMAND, "SET AUTOCOMMIT=0");
$mysqli->options(MYSQLI_OPT_CONNECT_TIMEOUT, 5);
/* サーバに接続します */
$mysqli->real_connect('localhost', 'my_user', 'my_password', 'world');
/* 接続状況をチェックします */
if (mysqli_connect_errno()) {
printf("Connect failed: %s\n", mysqli_connect_error());
exit();
}
printf ("Connection: %s\n.", $mysqli->host_info);
$mysqli->close();
?>
|
|
例 2. 手続き型
<?php
/* 接続オブジェクトを作成します。まだ接続はしていません */
$link = mysqli_init();
/* 接続オプションを設定します */
mysqli_options($link, MYSQLI_INIT_COMMAND, "SET AUTOCOMMIT=0");
mysqli_options($link, MYSQLI_OPT_CONNECT_TIMEOUT, 5);
/* サーバに接続します */
mysqli_real_connect($link, 'localhost', 'my_user', 'my_password', 'world');
/* 接続状況をチェックします */
if (mysqli_connect_errno()) {
printf("Connect failed: %s\n", mysqli_connect_error());
exit();
}
printf ("Connection: %s\n.", mysqli_get_host_info($link));
mysqli_close($link);
?>
|
|
上の例の出力は以下となります。
Connection: Localhost via UNIX socket |