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

Copy
1<?php
2
3/**
4 * curl_error 関数の使用例：SSL証明書エラーの確認.
5 *
6 * CURLOPT_SSL_VERIFYPEER を true に設定した場合、SSL証明書の検証が行われる。
7 * 検証に失敗した場合、curl_error 関数で具体的なエラー内容を取得できる。
8 */
9
10// curl ハンドルを初期化
11$ch = curl_init('https://example.com');
12
13// SSL 証明書の検証を有効にする
14curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
15
16// CURLOPT_RETURNTRANSFER を true に設定して、結果を文字列として返すようにする
17curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
18
19// URL を取得
20$result = curl_exec($ch);
21
22// エラーが発生した場合
23if ($result === false) {
24    // エラー内容を取得
25    $error = curl_error($ch);
26
27    // エラーコードが60の場合（SSL証明書の問題）
28    if (strpos($error, '60') !== false) {
29        echo "SSL証明書のエラーが発生しました: " . $error . PHP_EOL;
30        echo "CURLOPT_CAINFO または CURLOPT_CAPATH が正しく設定されているか確認してください。" . PHP_EOL;
31    } else {
32        echo "cURL エラーが発生しました: " . $error . PHP_EOL;
33    }
34} else {
35    // 成功した場合の処理
36    echo "リクエスト成功!" . PHP_EOL;
37}
38
39// curl ハンドルを閉じる
40curl_close($ch);
41
42?>

curl_error関数は、cURLセッションで発生した最後のエラーメッセージを取得するために使用します。引数には、エラー情報を取得したいcURLハンドルのリソース $handle を指定します。この関数は文字列型の戻り値を返し、エラーが発生しなかった場合は空文字列を返します。

サンプルコードでは、SSL証明書の検証エラーが発生した場合に、curl_error関数を使ってエラー内容を取得する方法を示しています。CURLOPT_SSL_VERIFYPEER オプションを true に設定することで、cURLはSSL証明書の検証を行うようになります。検証に失敗した場合、curl_exec関数は false を返し、curl_error関数で具体的なエラー内容を確認できます。

サンプルコードでは、エラーメッセージにエラーコード 60 が含まれているかをチェックしています。エラーコード 60 は、通常、SSL証明書の検証に失敗した場合に発生します。このエラーが発生した場合、CURLOPT_CAINFO または CURLOPT_CAPATH オプションが正しく設定されているか確認する必要があります。これらのオプションは、信頼できる認証局（CA）の証明書ファイルまたはディレクトリを指定するために使用します。 curl_error関数を使用することで、cURLセッションで発生した問題を特定し、適切な対処を行うことができます。

Copy
1<?php
2
3// cURL エラー 7 は、接続エラー（ホストが見つからない、接続を拒否されたなど）を表します。
4// この例では、存在しないホストに接続を試み、エラーメッセージを取得します。
5
6$ch = curl_init('https://invalid.example.com'); // 存在しないホスト
7
8curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); // レスポンスを文字列として返す
9
10$result = curl_exec($ch);
11
12if ($result === false) {
13    $error_number = curl_errno($ch);
14    $error_message = curl_error($ch);
15
16    echo "cURL error ($error_number): $error_message\n";
17
18    // エラー番号 7 は、接続に失敗したことを示します。
19    if ($error_number === 7) {
20        echo "接続エラーが発生しました。ホスト名が正しいか、ネットワーク接続を確認してください。\n";
21    }
22} else {
23    echo "成功: " . $result . "\n";
24}
25
26curl_close($ch);
27
28?>

このPHPのサンプルコードは、cURLライブラリのcurl_error関数を使用して、cURL操作中に発生したエラーの詳細情報を取得する方法を示しています。特に、エラーコード7（CURLE_COULDNT_CONNECT）が発生した場合の対処法を解説しています。

curl_init関数で存在しないホスト（https://invalid.example.com）への接続を試み、`curl_exec`関数で実行します。`curl_exec`関数が`false`を返した場合、エラーが発生したことを意味します。

curl_errno関数は、最後に発生したエラーのエラーコードを整数値で返します。一方、curl_error関数は、同じエラーに対応するエラーメッセージを文字列で返します。引数には、cURLセッションを表すCurlHandleオブジェクトを渡します。

サンプルコードでは、curl_errnoでエラーコードを取得し、curl_errorでエラーメッセージを取得して表示します。エラーコードが7の場合、接続エラーが発生したことを示唆し、ホスト名が正しいか、ネットワーク接続に問題がないかを確認するよう促すメッセージを表示します。

最後に、curl_close関数でcURLセッションを閉じ、リソースを解放します。この例を通して、cURLエラー発生時のエラー情報の取得と、特定のエラーコードに対する適切な対応を学ぶことができます。システムエンジニアを目指す上で、外部APIとの連携などで発生する可能性のあるエラーへの対処は重要なスキルです。