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

Copy
1<?php
2
3/**
4 * プロキシサーバー経由で指定されたURLのコンテンツを取得するサンプル関数です。
5 * システムエンジニアを目指す初心者の方に、CURLOPT_PROXY (プロキシ設定) と
6 * CURLOPT_PROXYUSERPWD (プロキシ認証情報) の使い方を示します。
7 *
8 * @param string $url 取得したいターゲットURL。
9 * @param string $proxyServer プロキシサーバーのアドレスとポート (例: "http://your_proxy_ip:8080")。
10 * @param string $proxyUserPwd プロキシ認証情報 (例: "username:password")。認証が不要な場合は空文字列 '' を指定。
11 * @return string|false 成功した場合は取得したコンテンツ、失敗した場合は false を返します。
12 */
13function fetchDataViaProxy(string $url, string $proxyServer, string $proxyUserPwd): string|false
14{
15    // cURLセッションを初期化します。
16    $ch = curl_init();
17
18    // 取得したいURLを設定します。
19    curl_setopt($ch, CURLOPT_URL, $url);
20
21    // プロキシサーバーのアドレスとポートを設定します。
22    // 例: "http://192.168.1.1:8080" や "socks5://192.168.1.1:1080" など。
23    // ご自身の環境で実際に動作するプロキシサーバー情報を設定してください。
24    curl_setopt($ch, CURLOPT_PROXY, $proxyServer);
25
26    // プロキシ認証が必要な場合のユーザー名とパスワードを設定します。
27    // 例: "proxyuser:proxypassword"。
28    // プロキシ認証が不要な場合は、この行をコメントアウトするか、空文字列を渡してください。
29    if (!empty($proxyUserPwd)) {
30        curl_setopt($ch, CURLOPT_PROXYUSERPWD, $proxyUserPwd);
31    }
32
33    // 実行結果を直接出力せず、文字列として取得するように設定します。
34    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
35
36    // SSL証明書の検証に関する設定 (開発・テスト環境向け。本番環境では注意が必要です)。
37    // 環境によっては、以下の行のコメントアウトを解除しないと動作しない場合があります。
38    // curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
39    // curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
40
41    // cURLリクエストを実行し、結果を取得します。
42    $response = curl_exec($ch);
43
44    // cURLでエラーが発生したか確認します。
45    if (curl_errno($ch)) {
46        // エラーメッセージを表示します。
47        echo 'cURL エラーが発生しました: ' . curl_error($ch) . PHP_EOL;
48        $response = false; // 失敗として処理します。
49    }
50
51    // cURLセッションを閉じ、リソースを解放します。
52    curl_close($ch);
53
54    return $response;
55}
56
57// --------------------------------------------------------------------------
58// サンプルコードの実行例
59// 以下の値は、ご自身の環境に合わせて置き換えてください。
60// --------------------------------------------------------------------------
61
62// 取得したいターゲットURLを指定します。
63// ※このURLは、実際にアクセス可能なものに置き換えてください。
64//   例: 'http://example.com' や 'https://api.github.com/zen' など
65$targetUrl = 'http://httpbin.org/get'; // テスト用の公開API (自身のIPアドレスなどを返す)
66
67// プロキシサーバーのアドレスとポートを指定します。
68// ※ご自身の環境で利用可能なプロキシサーバーの情報に置き換えてください。
69//   プロキシが不要な場合や設定が不明な場合は、このサンプルコードは正しく動作しません。
70$proxyAddress = 'http://127.0.0.1:8888'; // 例: FiddlerやSquidなどのローカルプロキシ
71
72// プロキシ認証情報 (ユーザー名とパスワード) を指定します。
73// ※プロキシ認証が不要な場合は、空文字列 '' を設定してください。
74$proxyCredentials = 'proxy_user:proxy_pass'; // 例: 'myuser:mypassword'
75
76echo "プロキシ経由で '{$targetUrl}' のコンテンツを取得しています..." . PHP_EOL;
77echo "プロキシサーバー: {$proxyAddress}" . PHP_EOL;
78
79$content = fetchDataViaProxy($targetUrl, $proxyAddress, $proxyCredentials);
80
81if ($content !== false) {
82    echo PHP_EOL . "--- 取得したコンテンツの一部 (最初の200文字) ---" . PHP_EOL;
83    echo substr($content, 0, 200) . '...' . PHP_EOL;
84    echo "---------------------------------------------------" . PHP_EOL;
85    echo "成功しました！" . PHP_EOL;
86} else {
87    echo PHP_EOL . "コンテンツの取得に失敗しました。" . PHP_EOL;
88    echo "プロキシ設定 ('{$proxyAddress}') またはターゲットURL ('{$targetUrl}') を確認してください。" . PHP_EOL;
89    echo "プロキシ認証情報が正しいか ('{$proxyCredentials}') も確認してください。" . PHP_EOL;
90}

このPHPサンプルコードは、CURLOPT_PROXY定数を利用してプロキシサーバー経由で指定されたURLのコンテンツを取得する方法を示しています。CURLOPT_PROXYは、cURL通信で利用するプロキシサーバーのアドレスとポートを設定するために使われる定数で、戻り値はint型です。プロキシ認証が必要な場合には、CURLOPT_PROXYUSERPWD定数でユーザー名とパスワードを設定します。

関数fetchDataViaProxyは、取得したいターゲットURL ($url)、プロキシサーバーのアドレスとポート ($proxyServer)、そしてオプションでプロキシ認証情報 ($proxyUserPwd) を引数として受け取ります。関数内では、まずcurl_init()でcURLセッションを初期化し、curl_setopt()を使ってこれらのプロキシ関連設定や、取得結果を文字列として返すCURLOPT_RETURNTRANSFERなどの必要なオプションを設定します。その後、curl_exec()でHTTPリクエストを実行し、エラーが発生した場合はcurl_error()で詳細を確認します。最後にcurl_close()でセッションを閉じ、リソースを解放します。

戻り値は、コンテンツの取得に成功した場合は取得したコンテンツの文字列を、何らかのエラーが発生して失敗した場合はfalseを返します。サンプルコードを実行する際は、ご自身の環境に合わせてプロキシサーバーのアドレスや認証情報を適切に設定する必要がある点にご注意ください。