Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【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)

戻り値なし

戻り値はありません

関連コンテンツ