(PHP 5, PHP 7, PHP 8)
mysqli::__construct -- mysqli::connect -- mysqli_connect — 新規に MySQL サーバーへの接続をオープンする
オブジェクト指向型
$hostname = ini_get("mysqli.default_host"),$username = ini_get("mysqli.default_user"),$password = ini_get("mysqli.default_pw"),$database = "",$port = ini_get("mysqli.default_port"),$socket = ini_get("mysqli.default_socket")$hostname = ini_get("mysqli.default_host"),$username = ini_get("mysqli.default_user"),$password = ini_get("mysqli.default_pw"),$database = "",$port = ini_get("mysqli.default_port"),$socket = ini_get("mysqli.default_socket")手続き型
$hostname = ini_get("mysqli.default_host"),$username = ini_get("mysqli.default_user"),$password = ini_get("mysqli.default_pw"),$database = "",$port = ini_get("mysqli.default_port"),$socket = ini_get("mysqli.default_socket")MySQL サーバーへの接続をオープンします。
hostname
ホスト名または IP アドレスです。この引数に null または "localhost" を渡すと
ローカルホストとみなされます。可能な場合は、TCP/IP プロトコルの代わりに
パイプが使用されます。
ホスト名とポートが一緒に指定された場合は、TCP/IP プロトコルが使われます。
例: localhost:3308.
ホストの前に p: をつけると、持続的な接続を開きます。
接続プールから開いた接続上で
mysqli_change_user() が自動的にコールされます。
usernameMySQL のユーザー名。
password
省略したり null を渡したりした場合、MySQL サーバーは
パスワードを持たないユーザーレコードについてのみ認証を試みます。
これによってひとつのユーザー名において(パスワードが指定されたか
否かによって)違うパーミッションを与えることができます。
database指定した場合は、 クエリが行われるデフォルトのデータベースとなります。
portMySQL サーバーに接続する際のポート番号を指定します。
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', 3306, null, '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 の読み込みに失敗します。