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
| Parameter | Type | What it takes |
|---|---|---|
| $options | ?array | options 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
| Version | Change |
|---|---|
| 8.0.0 | options 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.