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

Copy
1<?php
2
3/**
4 * 指定されたURLに対してcURLリクエストを実行し、名前解決にかかった時間を計測・表示します。
5 * この関数はCURLINFO_NAMELOOKUP_TIME_T定数を使用して、高精度な時間計測を行います。
6 *
7 * @param string $url 計測対象のURL (例: 'http://example.com')
8 * @return void
9 */
10function measureCurlNameLookupTime(string $url): void
11{
12    // 1. cURLセッションを初期化します。
13    //    これはウェブサイトへのリクエストを行うための準備です。
14    $ch = curl_init();
15
16    // 2. cURLオプションを設定します。
17    //    - CURLOPT_URL: リクエストを送るURLを指定します。
18    curl_setopt($ch, CURLOPT_URL, $url);
19    //    - CURLOPT_RETURNTRANSFER: curl_exec()の戻り値を、取得したデータとするように設定します。
20    //      これがない場合、データは直接出力されます。
21    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
22    //    - CURLOPT_HEADER: 応答のヘッダー部分を取得しないように設定します。
23    curl_setopt($ch, CURLOPT_HEADER, false);
24
25    // 3. cURLリクエストを実行します。
26    //    この処理中に、指定されたURLのDNS名前解決（ドメイン名をIPアドレスに変換する処理）が行われます。
27    $response = curl_exec($ch);
28
29    // 4. cURL実行中にエラーが発生したかチェックします。
30    if (curl_errno($ch)) {
31        echo "cURLエラーが発生しました: " . curl_error($ch) . "\n";
32        curl_close($ch); // エラー時はセッションを閉じて終了
33        return;
34    }
35
36    // 5. CURLINFO_NAMELOOKUP_TIME_T定数を使用して、名前解決にかかった時間を取得します。
37    //    この定数は、PHP 8以降で推奨される、マイクロ秒単位で時間を返すオプションです。
38    //    戻り値は整数 (int) で、マイクロ秒単位の時間が入ります。
39    $nameLookupTimeMicroseconds = curl_getinfo($ch, CURLINFO_NAMELOOKUP_TIME_T);
40
41    // 6. cURLセッションを閉じます。
42    //    リソースを解放するために重要です。
43    curl_close($ch);
44
45    // 7. 結果を表示します。
46    echo "測定対象URL: " . $url . "\n";
47    if ($nameLookupTimeMicroseconds !== false) {
48        // マイクロ秒を秒に変換して、小数点以下も分かりやすく表示します。
49        $nameLookupTimeSeconds = $nameLookupTimeMicroseconds / 1_000_000;
50        echo "名前解決にかかった時間 (Name Lookup Time): "
51             . $nameLookupTimeMicroseconds . " マイクロ秒 (約 "
52             . sprintf('%.6f', $nameLookupTimeSeconds) . " 秒)\n";
53    } else {
54        echo "名前解決時間の取得に失敗しました。\n";
55    }
56}
57
58// サンプルとして、有名なウェブサイトの名前解決時間を計測してみましょう。
59// 実際のネットワーク状況やDNSキャッシュによって時間は変動します。
60measureCurlNameLookupTime('http://example.com');
61
62// 別のURLで試すこともできます。
63// measureCurlNameLookupTime('https://www.google.com');
64
65?>

このPHPサンプルコードは、指定されたURLに対するcURLリクエストにおいて、ウェブサイトのドメイン名からIPアドレスへの「名前解決」にかかる時間を高精度に計測し、表示するものです。名前解決とは、インターネット上でウェブサイトにアクセスするために必要な、ドメイン名のIPアドレス変換処理を指します。

コードではまずcurl_init()でcURLセッションを初期化し、curl_setopt()関数を使ってリクエスト先のURLなどの必要なオプションを設定します。次にcurl_exec()を実行することで実際のHTTPリクエストが行われ、その過程で名前解決処理が実行されます。

名前解決にかかった時間の取得には、CURLINFO_NAMELOOKUP_TIME_T定数を使用します。この定数は、curl_getinfo()関数に渡すことで、名前解決にかかった時間をマイクロ秒単位の整数値として返します。PHP 8で導入された_Tサフィックスを持つ時間関連の定数は、従来の小数点以下の秒数を返す定数よりも高精度な時間計測が可能で、細かなパフォーマンス分析に適しています。取得されたマイクロ秒単位の時間は、分かりやすくするために秒単位に変換して出力されます。

このmeasureCurlNameLookupTime関数は、計測対象のURLを$urlという文字列型の引数として受け取ります。関数の戻り値はvoidとなっており、これは関数が直接値を返却せず、処理結果を画面に出力することでその役割を終えることを示しています。最後にcurl_close()でcURLセッションを閉じ、使用したリソースを適切に解放します。

Copy
1<?php
2
3/**
4 * 指定されたURLへのCURLリクエストにおける名前解決時間を取得し表示します。
5 * CURLINFO_NAMELOOKUP_TIME_T を使用して、マイクロ秒単位で名前解決にかかった時間を測定します。
6 * この定数はPHP 7.0以降で利用可能であり、より高精度な時間情報を提供します。
7 *
8 * @param string $url 測定対象となるウェブサイトのURL。
9 * @return void
10 */
11function measureCurlNameLookupTime(string $url): void
12{
13    // CURLセッションを初期化します。
14    $ch = curl_init();
15
16    if ($ch === false) {
17        echo "エラー: CURLセッションの初期化に失敗しました。\n";
18        return;
19    }
20
21    // CURLオプションを設定します。
22    // CURLOPT_URL: リクエストのターゲットURLを設定します。
23    curl_setopt($ch, CURLOPT_URL, $url);
24    // CURLOPT_RETURNTRANSFER: curl_exec()が結果を文字列として返すように設定します。
25    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
26    // CURLOPT_NOBODY: レスポンスボディをダウンロードせず、ヘッダーのみを取得するように設定します。
27    // これにより、名前解決の時間測定に焦点を当てることができます。
28    curl_setopt($ch, CURLOPT_NOBODY, true);
29
30    // CURLリクエストを実行します。
31    $response = curl_exec($ch);
32
33    // リクエスト実行時のエラーをチェックします。
34    if ($response === false) {
35        echo "エラー: CURLリクエストの実行に失敗しました - " . curl_error($ch) . "\n";
36        curl_close($ch);
37        return;
38    }
39
40    // CURLINFO_NAMELOOKUP_TIME_T を使用して、名前解決にかかった時間をマイクロ秒単位で取得します。
41    // DNSルックアップなど、名前解決プロセスにかかる時間です。
42    $nameLookupTimeMicroseconds = curl_getinfo($ch, CURLINFO_NAMELOOKUP_TIME_T);
43
44    // CURLセッションを閉じ、リソースを解放します。
45    curl_close($ch);
46
47    if ($nameLookupTimeMicroseconds !== false) {
48        // 取得したマイクロ秒を秒に変換して表示します。
49        $nameLookupTimeSeconds = $nameLookupTimeMicroseconds / 1_000_000;
50        echo "URL: {$url}\n";
51        echo "名前解決にかかった時間 (CURLINFO_NAMELOOKUP_TIME_T): {$nameLookupTimeMicroseconds} マイクロ秒 ({$nameLookupTimeSeconds} 秒)\n";
52    } else {
53        echo "警告: 名前解決時間の取得に失敗しました。\n";
54    }
55}
56
57// サンプルとして、Googleのウェブサイトの名前解決時間を測定します。
58measureCurlNameLookupTime("https://www.google.com");

PHPのCURLINFO_NAMELOOKUP_TIME_Tは、CURL拡張機能の一部として提供される定数です。この定数は、ウェブサイトへアクセスする際に行われる「名前解決」という処理にかかった時間を測定するために使用されます。名前解決とは、指定されたドメイン名（例：www.example.com）を、インターネット上で実際にサーバーを特定するためのIPアドレスに変換するプロセス（主にDNSルックアップ）を指します。

CURLINFO_NAMELOOKUP_TIME_T定数自体に引数や戻り値はありませんが、curl_getinfo()関数の第二引数として渡すことで、CURLセッションが名前解決に費やした時間をマイクロ秒単位で取得できます。この定数はPHP 7.0以降で利用可能となり、より詳細で高精度な時間情報を提供します。

サンプルコードでは、measureCurlNameLookupTime関数が引数として受け取ったURLの名前解決時間を計測し、その結果を表示します。関数内でcurl_init()によりCURLセッションを初期化し、CURLOPT_URLで対象URLを設定します。名前解決時間の測定に特化するため、CURLOPT_NOBODYオプションでレスポンスボディのダウンロードを省略しています。curl_exec()でリクエストを実行後、curl_getinfo($ch, CURLINFO_NAMELOOKUP_TIME_T)を使用して名前解決にかかった時間をマイクロ秒で取得します。この値は秒に変換されて分かりやすく表示され、最後にcurl_close()でCURLリソースが適切に解放されます。これにより、ウェブアプリケーションのパフォーマンス分析や問題診断に役立てることが可能です。