1.20.x file.inc backdrop_realpath($uri)

Resolves the absolute filepath of a local URI or filepath.

The use of backdrop_realpath() is discouraged, because it does not work for remote URIs. Except in rare cases, URIs should not be manually resolved.

Only use this function if you know that the stream wrapper in the URI uses the local file system, and you need to pass an absolute path to a function that is incompatible with stream URIs.

Parameters

string $uri: A stream wrapper URI or a filepath, possibly including one or more symbolic links.

Return value

string|false: The absolute local filepath (with no symbolic links), or FALSE on failure.

See also

BackdropStreamWrapperInterface::realpath()

http://php.net/manual/function.realpath.php

Related topics

File interface Common file handling functions. PHP wrapper functions Functions that are wrappers or custom implementations of PHP functions.

File

includes/file.inc, line 2487
API for handling file uploads and server file management.

Code

function backdrop_realpath($uri) {
  // If this URI is a stream, pass it off to the appropriate stream wrapper.
  // Otherwise, attempt PHP's realpath. This allows use of backdrop_realpath even
  // for unmanaged files outside of the stream wrapper interface.
  if ($wrapper = file_stream_wrapper_get_instance_by_uri($uri)) {
    return $wrapper->realpath();
  }

  return realpath($uri);
}