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

Copy
1<?php
2
3/**
4 * 特定のホスト名を特定のIPアドレスに解決してHTTPリクエストを実行する関数。
5 *
6 * この関数は、cURLの `CURLOPT_RESOLVE` オプションを使用して、DNS解決を迂回し、
7 * 指定されたホスト名を直接特定のIPアドレスにマッピングしてからHTTPリクエストを行います。
8 * これは、特定のIPアドレスにあるサーバーへの直接接続テストなどに利用されます。
9 *
10 * @param string $hostName 解決するホスト名 (例: "example.com")
11 * @param string $ipAddress 強制的に解決させるIPアドレス (例: "93.184.216.34" for example.com)
12 * @param string $url リクエストを送信するURL (通常は $hostName を含む)
13 * @return string|false リクエストのレスポンス本文、または失敗した場合はfalse
14 */
15function fetchContentWithSpecificIp(string $hostName, string $ipAddress, string $url)
16{
17    $ch = curl_init();
18
19    // ホスト名とIPアドレスの解決を強制する設定
20    // "ホスト名:ポート:IPアドレス" の形式で指定します。
21    // ここでは、HTTP(80)とHTTPS(443)の両方に対応できるようにしています。
22    $port = (str_starts_with($url, 'https://')) ? 443 : 80;
23    $resolveEntry = [$hostName . ':' . $port . ':' . $ipAddress];
24
25    curl_setopt($ch, CURLOPT_URL, $url);
26    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); // レスポンスを文字列として取得
27    curl_setopt($ch, CURLOPT_RESOLVE, $resolveEntry); // 特定のIPアドレスに解決を強制
28
29    // SSL証明書の検証をスキップ (開発・テスト目的。本番環境では非推奨)
30    // これは、URLのホスト名と、実際に接続するIPアドレスの証明書が異なる場合に
31    // エラーとなるのを避けるためですが、セキュリティリスクを伴います。
32    if ($port === 443) {
33        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
34        curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
35    }
36
37    $response = curl_exec($ch);
38
39    // cURL実行時のエラーチェック
40    if (curl_errno($ch)) {
41        echo 'cURLエラー (' . curl_errno($ch) . '): ' . curl_error($ch) . PHP_EOL;
42        // PHP 8で導入された CURLPX_BAD_ADDRESS_TYPE は、
43        // 主に curl_multi_* 関数によって返されるマルチハンドルエラーコードの一部です。
44        // この定数は、例えば `CURLOPT_ADDRESS_SCOPE` などのオプションが不正なアドレスタイプを
45        // 指定した場合などに発生する可能性があります。
46        // 単一のcURLリクエスト (curl_exec) では直接このエラーが返されることは稀ですが、
47        // cURLがアドレスを扱おうとした際に問題が発生した場合に参照される可能性のある定数です。
48        curl_close($ch);
49        return false;
50    }
51
52    // HTTPステータスコードの確認
53    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
54    if ($httpCode >= 400) {
55        echo 'HTTPエラー: ' . $httpCode . ' for ' . $url . PHP_EOL;
56        curl_close($ch);
57        return false;
58    }
59
60    curl_close($ch);
61    return $response;
62}
63
64// --- 使用例 ---
65// ターゲットホスト名と、そのホストの特定のIPv4アドレス
66$targetHost = 'example.com';
67$targetIp = '93.184.216.34'; // example.com のIPv4アドレスの一つ
68$requestUrl = 'http://' . $targetHost . '/';
69
70echo "特定のIPアドレス ({$targetIp}) を使用して {$requestUrl} からコンテンツを取得します..." . PHP_EOL;
71$content = fetchContentWithSpecificIp($targetHost, $targetIp, $requestUrl);
72
73if ($content !== false) {
74    echo "取得成功。コンテンツの最初の200文字:\n";
75    echo substr($content, 0, 200) . "..." . PHP_EOL;
76} else {
77    echo "コンテンツの取得に失敗しました。" . PHP_EOL;
78}
79
80// 参考: CURLPX_BAD_ADDRESS_TYPE 定数の値を出力
81echo "\n定数 CURLPX_BAD_ADDRESS_TYPE の値: " . CURLPX_BAD_ADDRESS_TYPE . PHP_EOL;
82
83?>

このPHPコードは、cURLライブラリを使用してHTTPリクエストを送信する際に、特定のホスト名を指定されたIPアドレスに強制的に解決してから接続する方法を示しています。通常、ウェブサイトにアクセスする際はDNSという仕組みでホスト名からIPアドレスが自動的に解決されますが、このコードではCURLOPT_RESOLVEオプションを使用し、example.comのようなホスト名を93.184.216.34のような特定のIPアドレスに直接マッピングして接続します。これは、DNSが機能していない状況でのサーバー接続テストや、特定のIPアドレスを持つサーバーへの直接アクセスが必要な場合に有効です。

fetchContentWithSpecificIp関数は、強制的に解決したい$hostName、そのホストに割り当てる$ipAddress、そしてリクエスト先の$urlの3つの文字列を引数として受け取ります。関数は、HTTPリクエストが成功した場合にはウェブサーバーからのレスポンス本文を文字列として返し、何らかのエラーが発生した場合にはfalseを返します。

コードの最後で参照されているCURLPX_BAD_ADDRESS_TYPE定数は、PHP 8で導入されたint型の値を持つ定数で、引数はありません。この定数は、主にcurl_multi_*関数など、複数のcURLリクエストを同時に扱う際に、不正なアドレスタイプが指定された場合に発生しうるエラーコードの一部として定義されています。単一のcurl_execリクエストでは直接このエラーが返されることは稀ですが、cURLがIPアドレスやネットワークアドレスの処理を行う際に問題が発生した場合に参照される可能性がある内部的な定数です。

また、HTTPS接続時には、開発やテスト目的でSSL証明書の検証をスキップする設定が含まれていますが、これはセキュリティリスクを伴うため、本番環境での利用は推奨されません。エラーが発生した際には、cURLのエラー情報やHTTPステータスコードを基に問題が報告されるようになっています。

Copy
1<?php
2
3/**
4 * 指定されたURLにPOSTリクエストを送信し、そのレスポンスを取得します。
5 *
6 * システムエンジニアを目指す初心者向けに、PHPのcURL拡張を使った
7 * 基本的なPOSTリクエストの実行方法を示します。
8 *
9 * @param string $url POSTリクエストを送信するターゲットURL。
10 * @param array $postData 送信するPOSTデータ（連想配列）。
11 * @return string|false リクエストのレスポンス本文、またはリクエストが失敗した場合は false。
12 */
13function sendPostRequest(string $url, array $postData): string|false
14{
15    // cURLセッションを初期化します。
16    $ch = curl_init();
17
18    // cURLオプションを設定します。
19    // CURLOPT_URL: リクエストを送信するURL。
20    curl_setopt($ch, CURLOPT_URL, $url);
21
22    // CURLOPT_POST: POSTメソッドを有効にします。
23    curl_setopt($ch, CURLOPT_POST, true);
24
25    // CURLOPT_POSTFIELDS: POSTするデータを設定します。
26    // 配列形式のデータを送信する場合、http_build_query() でURLエンコードすることが一般的です。
27    curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($postData));
28
29    // CURLOPT_RETURNTRANSFER: curl_exec() が結果を直接出力せず、文字列として返すようにします。
30    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
31
32    // cURLセッションを実行し、レスポンスを取得します。
33    $response = curl_exec($ch);
34
35    // cURL実行後のエラーチェックを行います。
36    if (curl_errno($ch)) {
37        // エラーが発生した場合、エラーメッセージをログに出力します。
38        // 例えば、CURLPX_BAD_ADDRESS_TYPE (int型) のように、
39        // curl_errno() が返す特定のエラーコードをここでチェックすることで、
40        // より詳細なエラーハンドリングが可能です。
41        error_log('cURL リクエストエラー: ' . curl_error($ch));
42        // エラー時は false を返します。
43        $response = false;
44    }
45
46    // cURLセッションを閉じ、リソースを解放します。
47    curl_close($ch);
48
49    return $response;
50}
51
52// --- サンプルコードの使用例 ---
53
54// テスト用のダミーURLを設定します。
55// 実際のPOSTリクエストを受け付けるAPIエンドポイントに置き換えてください。
56// 例: https://httpbin.org/post のようなサービスを利用すると、テストが容易です。
57$targetUrl = 'https://example.com/api/submit';
58
59// 送信するPOSTデータを連想配列で定義します。
60$userData = [
61    'username' => 'test_user',
62    'email' => 'test@example.com',
63    'message' => 'Hello from PHP cURL!',
64];
65
66echo "{$targetUrl} へPOSTリクエストを送信中...\n";
67
68// sendPostRequest関数を呼び出してリクエストを送信し、結果を受け取ります。
69$apiResponse = sendPostRequest($targetUrl, $userData);
70
71if ($apiResponse !== false) {
72    echo "サーバーからのレスポンス本文:\n";
73    echo $apiResponse . "\n";
74} else {
75    echo "POSTリクエストの送信に失敗しました。\n";
76}

このPHPサンプルコードは、PHPのcURL拡張機能を利用して、指定されたURLにPOSTリクエストを送信し、その結果としてサーバーからのレスポンス本文を取得する基本的な手法を、システムエンジニアを目指す初心者向けに解説しています。外部のWeb APIにデータを送信する際の基盤となる処理です。

sendPostRequest関数は、POSTリクエストを送信する対象のURLを文字列として、送信するデータを連想配列として引数に受け取ります。処理が成功した場合はサーバーからのレスポンス本文を文字列で返し、リクエストの送信や実行に失敗した場合はfalseを返します。

関数内では、まずcurl_init()でcURLセッションを初期化し、curl_setopt()関数を用いて様々な設定を行います。具体的には、CURLOPT_URLで送信先のURLを設定し、CURLOPT_POSTをtrueにすることでPOSTメソッドでのリクエストを有効化します。送信するデータはCURLOPT_POSTFIELDSで指定し、配列形式のデータを送信する際はhttp_build_query()でURLエンコードするのが一般的です。CURLOPT_RETURNTRANSFERをtrueに設定することで、curl_exec()の戻り値としてレスポンス本文を文字列で受け取れるようになります。

リクエスト実行後にはcurl_errno()でエラーの有無を確認し、もしエラーが発生していれば、CURLPX_BAD_ADDRESS_TYPEのような整数値のエラーコードを基に詳細なエラーハンドリングを行うことも可能です。最終的にcurl_close()でcURLセッションのリソースを適切に解放します。この一連の流れは、PHPでHTTP通信を行う際の基本的なパターンです。