PHPのCURLコンテキストオプション徹底解説！各オプションの意味と使い方

はじめに

CURLコンテキストオプションは、PHPのCURL拡張モジュールが --with-curlwrappers という設定オプションを付けてコンパイルされている場合に利用できる機能です。これらのオプションを使うことで、file_get_contents() などのストリーム関数からHTTPリクエストを細かく制御できるようになります。

本記事では、CURLラッパーで使用可能なコンテキストオプションの一覧と、それぞれの役割についてわかりやすく解説します。

CURLコンテキストオプション一覧

使用例：POSTリクエストを送信する

実際に、stream_context_create() を使ってCURLコンテキストオプションを設定し、POSTリクエストを送信する例を見てみましょう。

<?php
$options = [
    'http' => [
        'method'        => 'POST',
        'header'        => "Content-Type: application/json\r\n",
        'content'       => json_encode(['name' => 'test']),
        'user_agent'    => 'MyApp/1.0',
        'max_redirects' => 10,
    ]
];

$context = stream_context_create($options);
$result  = file_get_contents('https://example.com/api', false, $context);
?>

セキュリティに関する注意点

curl_verify_ssl_host と curl_verify_ssl_peer はどちらもデフォルトで FALSE（無効）になっていますが、本番環境ではSSL証明書の検証を有効にすることを強く推奨します。検証を無効化したまま運用すると、中間者攻撃（MITM攻撃）などのリスクにさらされる可能性があります。

まとめ

CURLコンテキストオプションを使えば、外部ライブラリに頼らずとも標準のストリーム関数で柔軟なHTTP通信を実現できます。method や header、max_redirects などの基本オプションを正しく理解し、SSL検証の設定にも十分注意しながら活用しましょう。