8.5.x file.inc drupal_basename($uri, $suffix = NULL)
8.0.x file.inc drupal_basename($uri, $suffix = NULL)
8.1.x file.inc drupal_basename($uri, $suffix = NULL)
8.2.x file.inc drupal_basename($uri, $suffix = NULL)
8.3.x file.inc drupal_basename($uri, $suffix = NULL)
8.4.x file.inc drupal_basename($uri, $suffix = NULL)
8.6.x file.inc drupal_basename($uri, $suffix = NULL)
7.x file.inc drupal_basename($uri, $suffix = NULL)

Gets the filename from a given path.

PHP's basename() does not properly support streams or filenames beginning with a non-US-ASCII character.

See also



Related topics

26 calls to drupal_basename()
color_scheme_form_submit in modules/color/color.module
Form submission handler for color_scheme_form().
DrupalErrorCollectionUnitTest::assertError in modules/simpletest/tests/common.test
Assert that a collected error matches what we are expecting.
DrupalLocalStreamWrapper::getLocalPath in includes/stream_wrappers.inc
Returns the canonical absolute path of the URI, if possible.
DrupalLocalStreamWrapper::getMimeType in includes/stream_wrappers.inc
Base implementation of getMimeType().
drupal_get_css in includes/common.inc
Returns a themed representation of all stylesheets to attach to the page.

... See full list


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


function drupal_basename($uri, $suffix = NULL) {
  $separators = '/';

    // For Windows OS add special separator.
    $separators .= DIRECTORY_SEPARATOR;

  // Remove right-most slashes when $uri points to directory.
  $uri = rtrim($uri, $separators);

  // Returns the trailing part of the $uri starting after one of the directory
  // separators.
  $filename = preg_match('@[^' . preg_quote($separators, '@') . ']+$@', $uri, $matches) ? $matches[0] : '';

  // Cuts off a suffix from the filename.
  if ($suffix) {
    $filename = preg_replace('@' . preg_quote($suffix, '@') . '$@', '', $filename);
  return $filename;


jamiegrinnell’s picture

Does this code need to replace something in the file.inc? On my line 2288 I have:

@param $uri
* A URI or pathname.
* @param $mode
* By default the Drupal mode is used.
* @param $recursive
* Default to FALSE.
* @param $context
* Refer to http://php.net/manual/en/ref.stream.php
* @return
* Boolean TRUE on success, or FALSE on failure.
* @see mkdir()
* @ingroup php_wrappers