デフォルトのストリームコンテキストを取得する

# stream_context_get_default

(PHP 5 >= 5.1.0, PHP 7, PHP 8)

stream_context_get_default — デフォルトのストリームコンテキストを取得する

### 説明

function stream_context_get_default(?array `$options` = `null`): resource

（fopen()、file_get_contents() のような） ファイル操作関数がコンテキストパラメータなしでコールされた場合に使用される デフォルトのストリームコンテキストを返します。デフォルトコンテキストに 関するオプションは、stream_context_create() と同じ 構文で任意に指定することが可能です。

### パラメータ

`options`
  `options` は、 `$arr['wrapper']['option'] = $value` のような形式の、連想配列の連想配列、 または `null` である必要があります。

### 戻り値

ストリームコンテキストリソースを返します。

### 変更履歴

バージョン | 説明
--- | ---
8.0.0 | `options` は、nullable になりました。

### 例

例1 stream_context_get_default() の使用

    <?php
    $default_opts = [
      'http' => [
        'method' => "GET",
        'header' => "Accept-language: en\r\n" .
                    "Cookie: foo=bar",
        'proxy' =>  "tcp://10.54.1.39:8000",
      ]
    ];

    $alternate_opts = [
      'http' => [
        'method'  => "POST",
        'header'  => "Content-type: application/x-www-form-urlencoded\r\n" .
                     "Content-length: " . strlen("baz=bomb"),
        'content' => "baz=bomb",
      ]
    ];

    $default = stream_context_get_default($default_opts);
    $alternate = stream_context_create($alternate_opts);

    /* www.example.com に対する通常の GET リクエストを、プロキシサーバー 10.54.1.39
     * に対して送信します。コンテキストオプション $default_opts を使用します。
     */
    readfile('http://www.example.com');

    /* POST リクエストを、直接 www.example.com に送信します。
     * コンテキストオプション $alternate_opts を使用します。
     */
    readfile('http://www.example.com', false, $alternate);

    ?>

### 参考

- stream_context_create() - ストリームコンテキストを作成する
- stream_context_set_default() - デフォルトのストリームコンテキストを設定する
- サポートするラッパーとコンテキストオプションの一覧 (サポートするプロトコル/ラッパー).

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open