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

CURLINFO_SPEED_UPLOAD定数は、PHPのcURL拡張機能において、直前のcURL転送におけるアップロード処理の平均速度を表す定数です。この定数は、主にcurl_getinfo()関数と組み合わせて使用されます。

具体的には、curl_exec()関数によってデータ転送が完了した後、curl_getinfo()関数の第二引数にCURLINFO_SPEED_UPLOADを指定することで、実行されたcURLリクエストにおけるデータアップロードの平均速度を浮動小数点数（float）として取得できます。この速度は、バイト/秒（bytes per second）単位で表されます。

この定数によって得られる情報は、アプリケーションが外部サーバーへファイルをアップロードしたり、データを送信したりする際のネットワークパフォーマンスを評価する際に非常に役立ちます。例えば、特定のWebサービスへのファイルアップロード機能で、ユーザーに提示する進捗状況や、アップロード速度のボトルネックを特定して改善策を検討する場合などに利用されます。

CURLINFO_SPEED_UPLOAD定数を使用することで、開発者はcURLを利用したアップロード処理の効率を客観的な数値データで把握し、システム全体の応答性やユーザー体験の向上に繋がる具体的な分析やデバッグを行うことが可能です。

Copy
1<?php
2$ch = curl_init("https://example.com");
3curl_exec($ch);
4$upload_speed_bytes_per_second = curl_getinfo($ch, CURLINFO_SPEED_UPLOAD);
5curl_close($ch);
6?>

引数なし

引数はありません

戻り値なし

戻り値はありません