mysqli::__construct

mysqli::connect

mysqli_connect

(PHP 5, PHP 7, PHP 8)

mysqli::__construct -- mysqli::connect -- mysqli_connect新規に MySQL サーバーへの接続をオープンする

説明

オブジェクト指向型

public mysqli::__construct(
    string $hostname = ini_get("mysqli.default_host"),
    string $username = ini_get("mysqli.default_user"),
    string $password = ini_get("mysqli.default_pw"),
    string $database = "",
    int $port = ini_get("mysqli.default_port"),
    string $socket = ini_get("mysqli.default_socket")
)
public mysqli::connect(
    string $hostname = ini_get("mysqli.default_host"),
    string $username = ini_get("mysqli.default_user"),
    string $password = ini_get("mysqli.default_pw"),
    string $database = "",
    int $port = ini_get("mysqli.default_port"),
    string $socket = ini_get("mysqli.default_socket")
): void

手続き型

mysqli_connect(
    string $hostname = ini_get("mysqli.default_host"),
    string $username = ini_get("mysqli.default_user"),
    string $password = ini_get("mysqli.default_pw"),
    string $database = "",
    int $port = ini_get("mysqli.default_port"),
    string $socket = ini_get("mysqli.default_socket")
): mysqli|false

MySQL サーバーへの接続をオープンします。

パラメータ

hostname

ホスト名または IP アドレスです。この引数に null または "localhost" を渡すと ローカルホストとみなされます。可能な場合は、TCP/IP プロトコルの代わりに パイプが使用されます。 ホスト名とポートが一緒に指定された場合は、TCP/IP プロトコルが使われます。 例: localhost:3308.

ホストの前に p: をつけると、持続的な接続を開きます。 接続プールから開いた接続上で mysqli_change_user() が自動的にコールされます。

username

MySQL のユーザー名。

password

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

database

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

port

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

socket

使用するソケットあるいは名前つきパイプを指定します。

注意:

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

戻り値

mysqli::__construct() は、成功、失敗に関わらず、MySQL サーバへの接続を表すオブジェクトを常に返します。

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

mysqli::connect() は、成功した場合に null を返します。 失敗した場合に false を返します.

エラー / 例外

MYSQLI_REPORT_STRICT が有効になっており、 かつ、データベースへの接続が失敗した場合は、 mysqli_sql_exception がスローされます。

例1 mysqli::__construct() の例

オブジェクト指向型

<?php

/* You should enable error reporting for mysqli before attempting to make a connection */
mysqli_report(MYSQLI_REPORT_ERROR MYSQLI_REPORT_STRICT);

$mysqli = new mysqli('localhost''my_user''my_password''my_db');

/* Set the desired charset after establishing a connection */
$mysqli->set_charset('utf8mb4');

printf("Success... %s\n"$mysqli->host_info);

手続き型

<?php

/* You should enable error reporting for mysqli before attempting to make a connection */
mysqli_report(MYSQLI_REPORT_ERROR MYSQLI_REPORT_STRICT);

$mysqli mysqli_connect('localhost''my_user''my_password''my_db');

/* Set the desired charset after establishing a connection */
mysqli_set_charset($mysqli'utf8mb4');

printf("Success... %s\n"mysqli_get_host_info($mysqli));

上の例の出力は、 たとえば以下のようになります。

Success... localhost via TCP/IP

例2 mysqli クラスを拡張する

<?php

class FooMysqli extends mysqli {
    public function 
__construct($host$user$pass$db$port$socket$charset) {
        
mysqli_report(MYSQLI_REPORT_ERROR MYSQLI_REPORT_STRICT);
        
parent::__construct($host$user$pass$db$port$socket);
        
$this->set_charset($charset);
    }
}

$db = new FooMysqli('localhost''my_user''my_password''my_db'3306null'utf8mb4');

例3 手動によるエラーハンドリング

エラーの報告機能が無効になっている場合、 開発者がエラーのチェックとエラー処理を行う必要があります。

オブジェクト指向型

<?php

error_reporting
(0);
mysqli_report(MYSQLI_REPORT_OFF);
$mysqli = new mysqli('localhost''my_user''my_password''my_db');
if (
$mysqli->connect_errno) {
    throw new 
RuntimeException('mysqli connection error: ' $mysqli->connect_error);
}

/* Set the desired charset after establishing a connection */
$mysqli->set_charset('utf8mb4');
if (
$mysqli->errno) {
    throw new 
RuntimeException('mysqli error: ' $mysqli->error);
}

手続き型

<?php

error_reporting
(0);
mysqli_report(MYSQLI_REPORT_OFF);
$mysqli mysqli_connect('localhost''my_user''my_password''my_db');
if (
mysqli_connect_errno()) {
    throw new 
RuntimeException('mysqli connection error: ' mysqli_connect_error());
}

/* Set the desired charset after establishing a connection */
mysqli_set_charset($mysqli'utf8mb4');
if (
mysqli_errno($mysqli)) {
    throw new 
RuntimeException('mysqli error: ' mysqli_error($mysqli));
}

注意

注意:

MySQLnd は常に、サーバーのデフォルト文字セットを想定しています。この文字セットは接続時の ハンドシェイク/認証 のときに送信され、これを mysqlnd が使います。

Libmysqlclient が使うデフォルトの文字セットは my.cnf で設定したものです。あるいは明示的に mysqli_options() をコールして設定することもできます。 これは、mysqli_init() のあとで mysqli_real_connect() を実行する前にコールします。

注意:

オブジェクト指向型 に関する注意: 接続に失敗した場合にもオブジェクトが返されます。 接続が失敗したかどうかを確かめるには、先ほどの例のように mysqli_connect_error() 関数あるいは mysqli->connect_error プロパティを使用しましょう。

注意:

接続タイムアウトなどのオプションを設定する必要がある場合は、かわりに mysqli_real_connect() を使わなければなりません。

注意:

コンストラクタをパラメータなしでコールするのは、 mysqli_init() をコールするのと同じ意味になります。

注意:

エラー "Can't create TCP/IP socket (10106)" が発生するのは、たいていは variables_order 設定ディレクティブに E が含まれていない場合です。 Windows では、これが含まれていなければ SYSTEMROOT 環境変数が使用できず、PHP が Winsock の読み込みに失敗します。

参考

関連キーワード:  mysqli, 接続, string, default, サーバー, オープン, 注意, 新規, 失敗, エラー