mysqli_connect()

PHP関数リファレンス

mysqli_connect,

(PHP 5)
mysqli_connect, mysqli->__construct() — 新規に 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]]]]]] )
} 実行中の MySQL サーバへの接続をオープンします。

パラメータ

host

ホスト名または IP アドレスです。この引数に NULL または "localhost" を渡すと ローカルホストとみなされます。もし可能な場合、TCP/IP プロトコルの代わりに パイプが使用されます。

username

MySQL のユーザ名。

passwd

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

dbname

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

port

MySQL サーバに接続する際のポート番号を指定します。

socket

使用するソケットあるいは名前つきパイプを指定します。
注意: socket 引数を指定しても、MySQL サーバへの 接続時の型を明示的に定義することにはなりません。MySQL サーバへの 接続方法については host 引数で定義されます。

返り値

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

例

例 1377. オブジェクト指向型
<?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();
?>
例 1378. 手続き型
<?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