【PHP8.x】CURLINFO_DATA_IN定数の使い方
CURLINFO_DATA_IN定数の使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
CURLINFO_DATA_IN定数は、PHPのcURL拡張機能において、特定のcURL転送操作でサーバーからクライアントへ受信したデータの総バイト数を表す定数です。cURLは、ウェブサーバーとのHTTP通信をはじめ、さまざまなプロトコルを用いたデータ転送を行うための強力なライブラリであり、PHP 8環境でその機能を手軽に利用できます。
このCURLINFO_DATA_IN定数は、cURLが実行したデータ転送に関する統計情報を取得する際に、curl_getinfo()関数とともに使用されます。具体的には、curl_getinfo($ch, CURLINFO_DATA_IN)のように記述することで、指定されたcURLハンドル($ch)が処理した通信において、サーバーからクライアント側へと受信されたデータ本体(例えばHTTPレスポンスのボディ部分など)の合計サイズをバイト単位の整数値として取得できます。
この情報は、ネットワーク通信のパフォーマンスを測定したり、データの送受信量をデバッグしたり、あるいは転送に要したリソースを把握したりする際に非常に役立ちます。受信したヘッダー情報(CURLINFO_HEADER_INで取得可能)とは区別され、純粋なデータ部分の量を知りたい場合に利用される重要な定数の一つです。
構文(syntax)
1<?php 2$curlHandle = curl_init("https://www.example.com"); 3curl_setopt($curlHandle, CURLOPT_RETURNTRANSFER, true); 4curl_exec($curlHandle); 5$bytesReceived = curl_getinfo($curlHandle, CURLINFO_DATA_IN); 6curl_close($curlHandle); 7?>
引数(parameters)
引数なし
引数はありません
戻り値(return)
戻り値なし
戻り値はありません