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

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

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

portsockethostname 引数とあわせ、データベースサーバに 接続する方法のコントロールに使用されます。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