Same name and namespace in other branches
  1. 8.9.x core/includes/file.inc \drupal_basename()

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

http://bugs.php.net/bug.php?id=37738

basename()

Related topics

File interface
Common file handling functions.
PHP wrapper functions
Functions that are wrappers or custom implementations of PHP functions.
32 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

File

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

Code

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

    // 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;
}