【PHP8.x】CURLINFO_CONTENT_LENGTH_DOWNLOAD_T定数の使い方

CURLINFO_CONTENT_LENGTH_DOWNLOAD_T定数は、PHPのCURL拡張機能において、HTTPリクエストを通じてダウンロードされるコンテンツの予測されるサイズ（バイト単位）を、より大きな整数型で取得するために使用される定数です。CURL拡張機能は、ウェブサーバーとの通信を行い、HTTPリクエストの送信やその応答の受信といったネットワーク操作を実現します。

この定数は、curl_getinfo() 関数と組み合わせて利用されます。curl_getinfo() 関数は、実行されたCURL転送に関する詳細な情報を取得するために用いられ、その際にCURLINFO_CONTENT_LENGTH_DOWNLOAD_T を指定することで、サーバーから提供されるContent-Lengthヘッダで示されるコンテンツのサイズを取得できます。

特にPHP 8.1以降で導入されたこの定数は、従来のCURLINFO_CONTENT_LENGTH_DOWNLOADが浮動小数点数（float）で値を返していたのに対し、非常に大きなファイルサイズであっても64ビット整数型（int）で正確な値を取得できる点が大きな特徴です。これにより、浮動小数点数特有の精度誤差の問題を回避し、ギガバイトやテラバイトといった大容量のデータを扱う場合でも、ダウンロードされるコンテンツのサイズを確実に把握することが可能になります。システムが転送量を正確に管理し、進捗状況をユーザーに適切に伝える上で重要な役割を果たします。

Copy
1<?php
2$curlHandle = curl_init("https://example.com");
3curl_exec($curlHandle);
4$downloadContentLength = curl_getinfo($curlHandle, CURLINFO_CONTENT_LENGTH_DOWNLOAD_T);
5curl_close($curlHandle);

引数なし

引数はありません

戻り値なし

戻り値はありません