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

Copy
1<?php
2
3/**
4 * CURLOPT_LOCALPORTRANGE を使用して、指定されたローカルポート範囲から
5 * HTTP リクエストを送信するサンプル関数です。
6 *
7 * @param string $url リクエストを送信するURL。
8 * @param int $startPort 使用を開始するローカルポート番号 (例: 60000)。
9 * @param int $portRange 開始ポートからのポート範囲のサイズ (例: 100)。
10 *                        cURLは $startPort から ($startPort + $portRange - 1) までの
11 *                        ポートを試行します。
12 * @return string|false リクエストのレスポンス本文、または失敗した場合は false。
13 */
14function sendCurlRequestWithLocalPortRange(string $url, int $startPort, int $portRange)
15{
16    // cURLセッションを初期化します。
17    $ch = curl_init();
18
19    if ($ch === false) {
20        echo "cURLセッションの初期化に失敗しました。\n";
21        return false;
22    }
23
24    // cURLオプションを設定します。
25    // リクエスト先のURLを設定します。
26    curl_setopt($ch, CURLOPT_URL, $url);
27    // リクエスト結果を文字列として取得するように設定します。
28    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
29    // タイムアウトを10秒に設定します。
30    curl_setopt($ch, CURLOPT_TIMEOUT, 10);
31
32    // 注意: 開発環境でのテスト目的でSSL証明書の検証を無効にしています。
33    // 本番環境では、セキュリティのため、この設定は使用せず、
34    // 適切なSSL証明書検証を行うようにしてください。
35    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
36    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
37
38    // cURLが送信元として使用するローカルポート番号の開始を設定します。
39    // このオプションは CURLOPT_LOCALPORTRANGE と組み合わせて使用されます。
40    curl_setopt($ch, CURLOPT_LOCALPORT, $startPort);
41
42    // 送信元ポート範囲のサイズを設定します。
43    // cURLは CURLOPT_LOCALPORT で指定されたポートから、この値までの範囲で
44    // 利用可能なポートをバインドしようとします。
45    // 例: CURLOPT_LOCALPORT が 60000、CURLOPT_LOCALPORTRANGE が 100 の場合、
46    // cURLは 60000 から 60099 の範囲のポートを試行します。
47    curl_setopt($ch, CURLOPT_LOCALPORTRANGE, $portRange);
48
49    // cURLリクエストを実行します。
50    $response = curl_exec($ch);
51
52    // エラーが発生した場合は表示します。
53    if (curl_errno($ch)) {
54        echo 'cURLエラー (' . curl_errno($ch) . '): ' . curl_error($ch) . "\n";
55        $response = false;
56    }
57
58    // cURLセッションを閉じ、リソースを解放します。
59    curl_close($ch);
60
61    return $response;
62}
63
64// --- サンプル使用例 ---
65// 実際に存在する、またはテスト用のURLを指定してください。
66$targetUrl = 'http://example.com'; 
67// 試行を開始するローカルポート番号
68$startPort = 60000;                
69// 試行するポート範囲のサイズ (例: 60000 から 60099 の範囲)
70$portRange = 100;                  
71
72echo "URL: {$targetUrl} へのリクエストを、ローカルポート {$startPort} から " .
73     ($startPort + $portRange - 1) . " の範囲で試行します。\n\n";
74
75$result = sendCurlRequestWithLocalPortRange($targetUrl, $startPort, $portRange);
76
77if ($result !== false) {
78    echo "リクエスト成功！\n";
79    echo "レスポンスの最初の200文字:\n";
80    echo substr($result, 0, 200) . "...\n";
81} else {
82    echo "リクエスト失敗。\n";
83}
84

このサンプルコードは、PHPのcURL拡張機能を利用してHTTPリクエストを送信する際に、送信元となるローカルポートを特定の範囲内で選択する方法を示しています。CURLOPT_LOCALPORTRANGEは、CURLOPT_LOCALPORTと組み合わせて使用することで、cURLがリクエストの送信元として利用するポートの範囲を定義する定数です。

sendCurlRequestWithLocalPortRange関数は、$urlで指定された宛先に対し、$startPortから始まる$portRange分のローカルポートを試行してHTTPリクエストを送信します。例えば、$startPortに60000、$portRangeに100を設定すると、cURLは60000番から60099番までのポートを順番に試行し、利用可能なポートを見つけて通信を行います。

関数内では、まずcURLセッションを初期化し、CURLOPT_URLでリクエスト先のURL、CURLOPT_RETURNTRANSFERでレスポンスを文字列として取得する設定を行います。そして、CURLOPT_LOCALPORTで送信元として試行を開始するポート番号を設定し、CURLOPT_LOCALPORTRANGEで開始ポートからのポート範囲のサイズを指定します。これにより、cURLは指定された範囲内のポートを試行し、リクエストを実行します。

リクエスト実行後、エラーが発生した場合はその詳細を表示し、最後にcURLセッションを閉じます。関数の戻り値は、リクエストが成功した場合は取得したレスポンス本文の文字列、失敗した場合はfalseとなります。サンプル使用例では、指定されたURLに対してローカルポート60000から60099の範囲でリクエストを試行し、その結果を表示しています。

Copy
1<?php
2
3/**
4 * 指定されたURLにPOSTリクエストを送信し、そのレスポンスを返します。
5 * システムエンジニアを目指す初心者向けに、cURLを使った基本的なPOSTリクエストの送信方法と、
6 * ローカルポート範囲の設定オプションの利用例を示します。
7 *
8 * @param string $url リクエストを送信するターゲットURL。
9 * @param array $data POSTするデータ（連想配列）。キーがフィールド名、値がその内容となります。
10 * @return string|false 成功した場合はレスポンス文字列、失敗した場合はfalse。
11 */
12function sendPostRequestWithLocalPortRangeExample(string $url, array $data)
13{
14    // cURLセッションを初期化します。
15    $ch = curl_init();
16
17    // cURLの初期化に失敗した場合はエラーログを出力し、処理を終了します。
18    if ($ch === false) {
19        error_log('cURLセッションの初期化に失敗しました。');
20        return false;
21    }
22
23    // POSTデータをURLエンコード形式に変換します。
24    // 例: ['key' => 'value'] が 'key=value' になります。
25    $postData = http_build_query($data);
26
27    // cURLオプションを設定します。
28    curl_setopt($ch, CURLOPT_URL, $url);                  // リクエストを送信するURL。
29    curl_setopt($ch, CURLOPT_POST, true);                 // POSTメソッドを使用することを指定します。
30    curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);      // キーワード: POSTするデータ本体を設定します。
31    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);       // レスポンスデータを文字列として取得するように設定します。
32
33    // リファレンス情報で指定された CURLOPT_LOCALPORTRANGE の利用例
34    // このオプションは、cURLが接続に使用するローカルポートの範囲を指定します。
35    // 通常のPOSTリクエストでは必須ではありませんが、特定のネットワーク環境下や
36    // セキュリティ要件（例: 特定の送信元ポートからの通信のみを許可するファイアウォール）
37    // などがある場合に利用されることがあります。
38    // CURLOPT_LOCALPORTRANGE は、CURLOPT_LOCALPORT と組み合わせて使用します。
39    // ここでは例として、ローカルポート5000番から始まり、10個のポート（5000～5009）の範囲で
40    // cURLがポートを選択するように指定しています。
41    curl_setopt($ch, CURLOPT_LOCALPORT, 5000);           // ローカルポートの開始番号を設定します。
42    curl_setopt($ch, CURLOPT_LOCALPORTRANGE, 10);        // 開始番号からのポート範囲サイズを設定します。
43
44    // cURLセッションを実行し、レスポンスを取得します。
45    $response = curl_exec($ch);
46
47    // cURL実行中にエラーが発生した場合は、エラーメッセージをログに出力します。
48    if (curl_errno($ch)) {
49        $errorMsg = curl_error($ch);
50        error_log("cURLエラーが発生しました: " . $errorMsg);
51        curl_close($ch);
52        return false;
53    }
54
55    // cURLセッションを閉じ、リソースを解放します。
56    curl_close($ch);
57
58    return $response;
59}
60
61// --- 関数実行例 ---
62// テスト用のダミーAPIを使用します。このAPIは受け取ったPOSTデータをJSON形式で返します。
63$targetUrl = 'https://jsonplaceholder.typicode.com/posts';
64// 送信するPOSTデータ。
65$postData = [
66    'title' => 'PHP cURL Example',
67    'body' => 'This is a test post request using PHP cURL.',
68    'userId' => 1,
69];
70
71echo "POSTリクエストを " . $targetUrl . " へ送信中...\n";
72$result = sendPostRequestWithLocalPortRangeExample($targetUrl, $postData);
73
74if ($result !== false) {
75    echo "--- レスポンス --- \n";
76    echo $result . "\n";
77    echo "------------------ \n";
78} else {
79    echo "POSTリクエストの送信に失敗しました。\n";
80}

このPHPコードは、PHP 8環境でcURLライブラリを用いて指定されたURLへPOSTリクエストを送信する方法を示しています。関数sendPostRequestWithLocalPortRangeExampleは、まずcurl_init()でcURLセッションを初期化し、その後、http_build_query()を使って連想配列形式のPOSTデータをURLエンコードされた文字列に変換します。

curl_setopt()関数を用いて、リクエストの詳細な設定を行います。CURLOPT_URLでリクエスト先のURLを、CURLOPT_POSTをtrueにすることでPOSTメソッドの使用を明示します。キーワードにも関連するCURLOPT_POSTFIELDSには、変換したPOSTデータ本体を設定し、CURLOPT_RETURNTRANSFERをtrueにすることで、サーバーからのレスポンスを文字列として取得できるようにします。

本リファレンス情報で言及されているCURLOPT_LOCALPORTRANGEは、CURLOPT_LOCALPORTと組み合わせて使用されます。CURLOPT_LOCALPORTはcURLが接続に使用するローカルポートの開始番号を指定し、CURLOPT_LOCALPORTRANGEはその開始番号からのポートの範囲サイズを設定します。これは通常必須のオプションではありませんが、特定のファイアウォール設定やセキュリティ要件など、送信元ポートを限定する必要がある場合に利用されることがあります。

設定後、curl_exec()でリクエストを実行し、結果を$responseに格納します。エラーが発生した場合はcurl_errno()とcurl_error()でエラー情報を取得し、最後にcurl_close()でcURLセッションを閉じ、使用したリソースを解放します。

sendPostRequestWithLocalPortRangeExample関数は、リクエストを送信するターゲットURLとPOSTするデータを引数に受け取ります。成功時にはサーバーからのレスポンス文字列を、失敗時にはfalseを戻り値として返します。