統計情報

$mysqli = new mysqli();
$res = $mysqli->query("SELECT 'abc'");
$res->fetch_assoc();
$res->close();

毎回取得(fetch)操作をするたびにこの値が増加します。

この統計値は、結果セットがクライアント上でバッファリングされただけで、実際に取得されていない場合は変化しません。たとえば、次のようなコードの場合です:

$mysqli = new mysqli();
$res = $mysqli->query("SELECT 'abc'");
$res->close();

この統計値は PHP 5.3.4 から利用可能です。

• クライアントアプリケーションが不完全な場合

• クライアントは探していた情報を見つけたあと終了しますが、MySQL に必要以上のレコードを計算させてしまっている場合

• クライアントアプリケーションが予期せず終了する場合

• MYSQL_TYPE_NULL - proto_text_fetched_null

• MYSQL_TYPE_BIT - proto_text_fetched_bit

• MYSQL_TYPE_TINY - proto_text_fetched_tinyint

• MYSQL_TYPE_SHORT - proto_text_fetched_short

• MYSQL_TYPE_INT24 - proto_text_fetched_int24

• MYSQL_TYPE_LONG - proto_text_fetched_int

• MYSQL_TYPE_LONGLONG - proto_text_fetched_bigint

• MYSQL_TYPE_DECIMAL, MYSQL_TYPE_NEWDECIMAL - proto_text_fetched_decimal

• MYSQL_TYPE_FLOAT - proto_text_fetched_float

• MYSQL_TYPE_DOUBLE - proto_text_fetched_double

• MYSQL_TYPE_DATE, MYSQL_TYPE_NEWDATE - proto_text_fetched_date

• MYSQL_TYPE_YEAR - proto_text_fetched_year

• MYSQL_TYPE_TIME - proto_text_fetched_time

• MYSQL_TYPE_DATETIME - proto_text_fetched_datetime

• MYSQL_TYPE_TIMESTAMP - proto_text_fetched_timestamp

• MYSQL_TYPE_STRING, MYSQL_TYPE_VARSTRING, MYSQL_TYPE_VARCHAR - proto_text_fetched_string

• MYSQL_TYPE_TINY_BLOB, MYSQL_TYPE_MEDIUM_BLOB, MYSQL_TYPE_LONG_BLOB, MYSQL_TYPE_BLOB - proto_text_fetched_blob

• MYSQL_TYPE_ENUM - proto_text_fetched_enum

• MYSQL_TYPE_SET - proto_text_fetched_set

• MYSQL_TYPE_GEOMETRY - proto_text_fetched_geometry

• 上記にない MYSQL_TYPE_* (ないはずですが) - proto_text_fetched_other

MYSQL_*-type 定数は、 MySQL の各バージョンの同じSQLカラムタイプと結びついているとは限らないことに注意してください。

• $link = new mysqli(...); $link->real_connect(...)

• unset($link)

• 持続的接続の場合: プールされる接続は real_connect 関数を使って作成されますが、作成されたハンドルにはどんなオプションが設定されたかわからない場合があります。この場合、暗黙のうちに接続を閉じることで、どんなオプションが設定されたかわからない接続が返されることを防いでください。

• 持続的接続の場合: mysqli::ping や mysqli::change_user を実行すると失敗し、ext/mysqli が接続を閉じてしまいます。

• スクリプトの実行が終了する時: ユーザーが閉じていない接続は閉じられます。

これらの統計値は、コマンドをチェックした後、対応する MySQLクライアントサーバプロトコルのパケットが送信される前にインクリメントされます。mysqlnd がパケットの送信に失敗したとしても、統計情報は減りません。パケットの送信にした場合、PHP は "Error while sending %s packet. PID=%d." という、E_WARNING レベルの警告を発生させます。

使い方の例:

• PHP があるコマンドを MySQLに送信しているかどうかをチェックする。たとえば、クライアントが COM_PROCESS_KILL を送信しているかどうかをチェックする。

• COM_EXECUTE コマンドと COM_PREPARE コマンドの実行回数を比較することで、プリペアドステートメントの平均実行回数を割り出す。

• COM_QUERY コマンドの実行回数がゼロかどうかをチェックすることで、PHP がプリペアドステートメントでない通常のクエリを実行しているかどうかをチェックする

• COM_QUERY と COM_EXECUTE コマンドをチェックすることで、SQLを実行しすぎているPHPスクリプトを特定する

mysqlnd は、内部的に mysqlnd.net_cmd_buffer_size(php.iniで設定) バイトを接続毎にメモリに割り当てます。MySQL のクライアントサーバプロトコルの場合、COM_QUERY (通常クエリ) コマンドがバッファサイズより大きい場合、mysqlnd はコマンドを送信するのに必要なサイズまでバッファを拡張します。ひとつの接続につきバッファが拡張された際はいつでも、command_buffer_too_small の値がひとつインクリメントされます。

mysqlnd が ほぼすべての接続で デフォルトの mysqlnd.net_cmd_buffer_size (php.ini で設定) バイトを超えてバッファを拡張しなければならない場合、メモリの再割り当てを防ぐために、デフォルトの値を増やすことを検討すべきです。

PHP 5.3.0 では、デフォルトのバッファサイズが 2K バイトでした。将来のバージョンでは、この値は 4K バイト以上になる見込みです。このデフォルトの値は php.ini の mysqlnd.net_cmd_buffer_size を設定するか、mysqli_options(MYSQLI_OPT_NET_CMD_BUFFER_SIZE, int size) 関数を使うことで変更することができます。

4096バイト以上のバッファサイズを設定することを推奨します。なぜなら、mysqlnd は MySQL からある通信パケットを読み取っているときにそれだけのメモリを使うからです。PHP 5.3.0 では、MySQL が現在設定されているバッファサイズ以上のパケットを送信しても、mysqlnd は絶対にバッファサイズを拡大しません。その結果として、mysqlnd はパケットをデコードできず、クライアントアプリケーションがエラーを発生させることになります。PHP 5.3.0 における mysqlnd.net_cmd_buffer_size のデフォルトである 2048 バイト以上に大きなパケットが送られてくる場合はふたつしかありません: とても長いエラーメッセージを送信した場合と、COM_LIST_FIELD (mysql_list_fields()関数から投げられる内部コマンド) から発生したパケットに含まれるカラムのメタデータが、とても長いデフォルト値(1900バイト以上)を持つ文字列型のカラムを持っていた場合です。この問題に関するバグレポートは存在していません - こんなことは滅多に起きないはずです。

PHP 5.3.2 の mysqlnd は 4096バイトより小さいバッファを設定できません。