stream_is_local

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

stream_is_localChecks if a stream is a local stream

Description

stream_is_local(resource|string $stream): bool

Checks if a stream, or a URL, is a local one or not.

Parameters

stream

The stream resource or URL to check.

Return Values

Returns true on success or false on failure.

Examples

Example #1 stream_is_local() example

Basic usage example.

<?php
var_dump
(stream_is_local("http://example.com"));
var_dump(stream_is_local("/etc"));
?>

The above example will output something similar to:

bool(false)
bool(true)

add a note add a note

User Contributed Notes 4 notes

up
3
Gemorroj
6 years ago
but hhvm for `file://shouldbelocal.jpg` returns true
https://3v4l.org/ULCni
up
2
php at kalpaitch dot com
6 years ago
It appears to return incorrectly for 'file://' wrapper which I would consider to be local.

CODE:
$file1 = '/somefile.jpg';
$file2 = 'file://shouldbelocal.jpg';
$file3 = 'http://someotherfile.jpg';

$local = stream_is_local($file1);
$shouldbelocal = stream_is_local($file2);
$remote = stream_is_local($file3);
var_dump($local, $shouldbelocal, $remote);

RESULT:
bool(true)
bool(false)
bool(false)
up
1
Anonymous
7 years ago
this is not a bug
mounting a remote filesystem locally "imports" it so it is available to userland programs like a local directory.
up
-1
sam at NOSPAM dot bogus dot tld
7 years ago
The function stream_is_local() does not work with remote mounts points, like sshfs mount points (it will return true as if it was local).
To Top