【PHP8.x】curl_exec関数の使い方

Copy
1<?php
2
3/**
4 * curl_exec を使用してリクエストを実行し、エラー処理を行うサンプル
5 *
6 * @return void
7 */
8function executeCurlRequest(): void
9{
10    // curl ハンドルを初期化
11    $ch = curl_init();
12
13    // URLを設定
14    curl_setopt($ch, CURLOPT_URL, 'https://example.com');
15
16    // CURLOPT_RETURNTRANSFER を true に設定して、結果を文字列として返すようにする
17    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
18
19    // リクエストを実行し、結果を取得
20    $result = curl_exec($ch);
21
22    // エラーが発生した場合の処理
23    if ($result === false) {
24        echo 'cURL error: ' . curl_error($ch) . PHP_EOL;
25    } else {
26        // 結果を処理
27        echo 'cURL result: ' . $result . PHP_EOL;
28    }
29
30    // curl ハンドルを閉じる
31    curl_close($ch);
32}
33
34// 関数を実行
35executeCurlRequest();

curl_exec関数は、PHPのcURL拡張に含まれる関数で、cURLセッションを実行し、サーバーからのレスポンスを取得するために使用します。引数には、curl_init関数などで初期化されたCurlHandleオブジェクトを渡します。このCurlHandleオブジェクトには、リクエスト先のURLやHTTPメソッド、ヘッダーなど、リクエストに関する様々なオプションが設定されています。

curl_exec関数は、通常、サーバーからのレスポンスボディを文字列として返します。もしエラーが発生した場合は、falseを返します。そのため、curl_execの実行後には、戻り値がfalseかどうかをチェックし、エラーハンドリングを行うことが重要です。エラーが発生した場合は、curl_error関数を使用して、具体的なエラーメッセージを取得できます。

サンプルコードでは、まずcurl_init関数でcURLセッションを初期化し、curl_setopt関数でリクエスト先のURLと、レスポンスを文字列として受け取るためのオプションCURLOPT_RETURNTRANSFERを設定しています。curl_exec関数を実行後、戻り値がfalseかどうかを判定し、エラーが発生した場合はcurl_error関数でエラーメッセージを表示します。エラーが発生しなかった場合は、取得したレスポンスを表示します。最後に、curl_close関数でcURLセッションをクローズします。このサンプルは、curl_exec関数を使用した基本的なリクエストの実行方法と、エラー処理の方法を示しています。

Copy
1<?php
2
3/**
4 * 指定されたURLからデータを取得し、タイムアウトを設定する例
5 *
6 * @param string $url 取得するURL
7 * @param int $timeout タイムアウト時間（秒）
8 * @return string|false 成功時はデータ、失敗時はfalse
9 */
10function fetch_data_with_timeout(string $url, int $timeout = 10): string|false
11{
12    // cURLハンドラを初期化
13    $ch = curl_init($url);
14
15    if ($ch === false) {
16        error_log("cURLの初期化に失敗しました。");
17        return false;
18    }
19
20    // オプションを設定
21    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); // データを文字列として返す
22    curl_setopt($ch, CURLOPT_TIMEOUT, $timeout);    // タイムアウト時間を設定
23
24    // リクエストを実行
25    $result = curl_exec($ch);
26
27    // エラーが発生した場合
28    if ($result === false) {
29        error_log("cURLエラー: " . curl_error($ch));
30    }
31
32    // cURLハンドラを閉じる
33    curl_close($ch);
34
35    return $result;
36}
37
38// 使用例
39$url = 'https://example.com';
40$data = fetch_data_with_timeout($url, 5); // タイムアウトを5秒に設定
41
42if ($data !== false) {
43    echo "データ取得成功:\n";
44    echo substr($data, 0, 200) . "...\n"; // 最初の200文字だけ表示
45} else {
46    echo "データ取得失敗。\n";
47}
48
49?>

curl_exec関数は、PHPでHTTPリクエストを送信し、レスポンスを取得するために使用されます。この関数は、初期化されたcURLハンドラ（CurlHandle $handle）を引数に取り、指定されたURLにリクエストを送信します。

サンプルコードでは、fetch_data_with_timeout関数内でcurl_execを使用し、タイムアウト時間を設定する方法を示しています。まず、curl_init関数でcURLハンドラを初期化し、curl_setopt関数でオプションを設定します。CURLOPT_RETURNTRANSFERオプションをtrueに設定することで、curl_execがレスポンスを文字列として返すようにします。CURLOPT_TIMEOUTオプションでタイムアウト時間を秒単位で設定します。

curl_exec($ch)を実行すると、指定されたURLにリクエストが送信され、レスポンスが取得されます。成功した場合はレスポンスの文字列が返され、失敗した場合はfalseが返されます。エラーが発生した場合は、curl_error関数でエラーメッセージを取得し、ログに出力します。最後に、curl_close関数でcURLハンドラを閉じます。

この例では、example.comからデータを取得し、タイムアウトを5秒に設定しています。取得したデータがfalseでない場合、データの最初の200文字を表示します。curl_exec関数を使うことで、タイムアウトを設定し、安全に外部のWebサイトからデータを取得することができます。