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

作成日: 2025年09月11日更新日: 2025年10月03日

『stream_context_set_options関数は、既存のストリームコンテキストにオプションを設定、または上書きを実行する関数です』ストリームコンテキストとは、file_get_contents関数やfopen関数といったストリーム対応関数が、ファイルやネットワークにアクセスする際の動作をカスタマイズするための設定情報の集まりを指します。この関数は、stream_context_create関数などであらかじめ作成されたコンテキストリソースに対し、後から動的に設定を追加したり、既存の値を変更したりするために利用されます。例えば、外部APIへHTTPリクエストを送信する際に、特定のHTTPヘッダーを追加する、通信のタイムアウト値を指定する、プロキシサーバー経由で接続するといった、より詳細な通信制御を実現できます。第一引数には設定対象のコンテキストリソースを、第二引数には設定したいオプションをhttpやsslなどのラッパー名をキーとした多次元連想配列で指定します。一度作成したコンテキストを再利用しつつ、状況に応じて設定を柔軟に変更できるため、効率的で保守性の高いコード記述に役立ちます。この関数は、処理が成功した場合にtrueを、失敗した場合にはfalseを返します。

基本的な使い方

構文(syntax)

<?php

// 設定したいオプションを連想配列で定義します。
// ここではHTTPリクエストのヘッダーやメソッドを指定しています。
$options = [
    'http' => [
        'method'  => 'GET',
        'header'  => "Accept-language: en\r\n",
        'timeout' => 60, // タイムアウトを60秒に設定
    ],
];

// stream_context_create() で作成したコンテキストリソースを用意します。
$context = stream_context_create();

// stream_context_set_options() を使い、コンテキストにオプションを設定します。
// 第1引数: オプションを設定するコンテキストリソース
// 第2引数: 設定するオプションの連想配列
$result = stream_context_set_options($context, $options);

?>

引数(parameters)

resource $context, array $options

resource $context: オプションを設定したいストリームコンテキストリソース
array $options: 設定したいオプションを連想配列で指定

戻り値(return)

bool

指定されたストリームコンテキストオプションの設定が成功したかどうかを示す真偽値を返します。成功した場合は TRUE、失敗した場合は FALSE を返します。