Home › API reference › file.inc

file_stream_wrapper_get_instance_by_uri

  1. drupal
    1. 7
Versions
7 file_stream_wrapper_get_instance_by_uri($uri)

Returns a reference to the stream wrapper class responsible for a given URI.

The scheme determines the stream wrapper class that should be used by consulting the stream wrapper registry.

Parameters

$uri A stream, referenced as "scheme://target".

Return value

Returns a new stream wrapper object appropriate for the given URI or FALSE if no registered handler could be found. For example, a URI of "private://example.txt" would return a new private stream wrapper object (DrupalPrivateStreamWrapper).

Related topics

File interface
Common file handling functions.

▸ 5 functions call file_stream_wrapper_get_instance_by_uri()

▾ 5 functions call file_stream_wrapper_get_instance_by_uri()

drupal_chmod in drupal/includes/file.inc
Set the permissions on a file or directory.
drupal_realpath in drupal/includes/file.inc
Returns the absolute path of a file or directory
file_create_url in drupal/includes/file.inc
Creates a web-accessible URL for a stream to an external or local file.
file_get_mimetype in drupal/includes/file.inc
Determine an Internet Media Type, or MIME type from a filename.
image_style_url in drupal/modules/image/image.module
Return the URL for an image derivative given a style and image path.

Code

drupal/includes/file.inc, line 312

<?php
function file_stream_wrapper_get_instance_by_uri($uri) {
  $scheme = file_uri_scheme($uri);
  $class = file_stream_wrapper_get_class($scheme);
  if (class_exists($class)) {
    $instance = new $class();
    $instance->setUri($uri);
    return $instance;
  }
  else {
    return FALSE;
  }
}
?>