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

# mysqli_connect

(PHP 5)

mysqli_connect

(no version information, might be only in CVS)

mysqli() -- 新規に MySQL サーバへの接続をオープンする

## 説明

手続き型

mysqli mysqli_connect ( [string host [, string username [, string passwd [, string dbname [, int port [, string socket]]]]]] )

オブジェクト指向型（コンストラクタ）:

class mysqli {
__construct ( [string host [, string username [, string passwd [, string dbname [, int port [, string socket]]]]]] )
}

mysqli_connect() は host 上の MySQL サーバへの接続のオープンを試みます。host は ホスト名または IP アドレスです。この引数に `NULL` または "localhost" を渡すと ローカルホストとみなされます。もし可能な場合、TCP/IP プロトコルの代わりに パイプが使用されます。オープンに成功した場合に mysqli_connect() は データベース接続のリソースを返します。失敗の場合は `FALSE` を返します。

username と password は MySQL サーバに接続するためのユーザ名とパスワードを指定します。 パスワードを指定しない場合(`NULL` 値が渡されます)、MySQL サーバは パスワードを持たないユーザレコードについてのみ認証を試みます。 これによってひとつのユーザ名において(パスワードが指定されたか 否かによって)違うパーミッションを与えることができます。

dbname 引数が指定された場合それは クエリが行われるデフォルトのデータベースとなります。

port と socket は hostname 引数とあわせ、データベースサーバに 接続する方法のコントロールに使用されます。port は MySQL サーバに接続するためのポート番号を指定し、 socket は使用するソケットまたは パイプ名を指定します。

> 注意: socket 引数を指定しても、MySQL サーバへの 接続時の型を明示的に定義することにはなりません。MySQL サーバへの 接続方法については host 引数で定義されます。

## 返り値

MySQL サーバへの接続を表すオブジェクトを返します。接続に失敗した場合には `FALSE` を返します。

## 例

例 1. オブジェクト指向型
`<?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); /* 接続の状況をチェックします */ if (mysqli_connect_errno()) { printf("Connect failed: %s\n", mysqli_connect_error()); exit(); } printf("Host information: %s\n", $mysqli->host_info); /* 接続を閉じます */ $mysqli->close(); ?>`

例 2. 手続き型
`<?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); /* 接続の状況をチェックします */ if (!$link) { printf("Connect failed: %s\n", mysqli_connect_error()); exit(); } printf("Host information: %s\n", mysqli_get_host_info($link)); /* 接続を閉じます */ mysqli_close($link); ?>`

上の例の出力は以下となります。

    Host information: Localhost via UNIX socket

前のページ | ホーム | 次のページ
mysqli_connect_error | 上に戻る | mysqli_data_seek