stream_context_get_default()

stream_context_get_default() — Retrieve the default stream context.

Built-in function of PHP 8.5. The manual lists it as available in PHP 5 >= 5.1.0, PHP 7, PHP 8. This page is the reference card: signature, parameters and return value, plus the changelog and the example the manual provides.

What it does

Returns the default stream context which is used whenever file operations (fopen(), file_get_contents(), etc...) are called without a context parameter. Options for the default context can optionally be specified with this function using the same syntax as stream_context_create().

Signature

stream_context_get_default(?array $options = null): resource

Parameters

ParameterTypeWhat it takes
$options?arrayoptions must be an associative array of associative arrays in the format $arr['wrapper']['option'] = $value, or null.

Return value

A stream context resource.

Example

A runnable snippet:

$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); /* Sends a regular GET request to proxy server at 10.54.1.39 * For www.example.com using context options specified in $default_opts */ readfile('http://www.example.com'); /* Sends a POST request directly to www.example.com * Using context options specified in $alternate_opts */ readfile('http://www.example.com', false, $alternate);

Changelog

VersionChange
8.0.0options is now nullable.

See also

stream_context_create(), stream_context_set_default()

All PHP 8.5 built-in functions

Reference card built from the PHP manual page stream_context_get_default() (PHP documentation, CC BY 3.0). The page is generated from the manual, so the wording of the parameter and return value text follows php.net.