mysql_unbuffered_query

MySQL に SQL クエリを送信するが、結果に対してのフェッチやバッファリングは行わない

警告

この拡張モジュールは PHP 5.5.0 で非推奨になり、PHP 7.0.0 で削除されました。 MySQLi あるいは PDO_MySQL を使うべきです。詳細な情報は MySQL: API の選択を参照ください。この関数の代替として、これらが使えます。

Buffered and Unbuffered queries を参照

説明

resource mysql_unbuffered_query(string $query, resource $link_identifier = NULL)

mysql_unbuffered_query は SQL クエリ query を MySQL に送信します。その際、 mysql_query が行っているような自動バッファリングを行いません。一方、この挙動により SQL クエリが消費するメモリの量をおさえられます。また、最初の 1 行目が取得されたらすぐに処理をはじめることができます。SQL の処理が完全に終わるまで待つ必要がありません。複数の DB 接続を利用する場合には、オプションのパラメータ link_identifier を指定する必要があります。

パラメータ

query

実行する SQL クエリ。

クエリ内のデータは適切にエスケープする必要があります。

link_identifier

MySQL 接続。指定されない場合、mysql_connect により直近にオープンされたリンクが指定されたと仮定されます。そのようなリンクがない場合、引数を指定せずに mysql_connect がコールした時と同様にリンクを確立します。リンクが見付からない、または、確立できない場合、E_WARNING レベルのエラーが生成されます。

戻り値

SELECT, SHOW, DESCRIBE あるいは EXPLAIN では、 mysql_unbuffered_query は成功した場合に resource 、エラー時に false を返します。

UPDATE, DELETE, DROP, などその他の SQL 文では、 mysql_unbuffered_query は成功した場合に true 、エラー時に false を返します。

注意

注意:
mysql_unbuffered_query の利点には、以下のような代償があります: mysql_unbuffered_query から返される結果セットには、すべての行をフェッチするまでは mysql_num_rows や mysql_data_seek を使用できません。また、結果の行をすべてフェッチするまで、同じ link_identifier を使って MySQL に新しいクエリを送信することができません。

参考

mysql_query