PHP マニュアル
前のページ |  | 次のページ

# 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` を返します。

## 参考

mysqli_connect()、 mysqli_init()、 mysqli_options()、 mysqli_ssl_set() そして mysqli_close()

## 例

例 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

前のページ | ホーム | 次のページ
mysqli_query | 上に戻る | mysqli_real_escape_string