basename

(PHP 4, PHP 5, PHP 7, PHP 8)

basenameВозвращает конечный компонент имени пути

Описание

basename(string $path, string $suffix = ""): string

Функция получит строку, которая содержит путь к файлу или каталогу, и вернёт конечный компонент имени пути.

Замечание:

Функция basename() наивно работает со входной строкой и не знает действительную файловую систему или компоненты пути наподобие «..».

Предостережение

Функция basename() учитывает региональные настройки. Поэтому, чтобы функция видела правильное базовое имя, путь которого содержит многобайтовые символы, требуется функцией setlocale() устанавливать локаль, которая соответствует этим символам. Функция basename() поведёт себя непредсказуемо, если имя пути path содержит неправильные для текущей локали символы.

Список параметров

path

Путь.

На платформах Windows как разделитель имён каталогов работает и прямой /, и обратный \ слеш. В других окружениях — прямой слеш /.

suffix

Функция также обрежет суффикс suffix, если компонент имени заканчивается этим суффиксом.

Возвращаемые значения

Функция возвращает базовое имя пути path.

Примеры

Пример #1 Пример использования функции basename()

<?php

echo "1) ".basename("/etc/sudoers.d", ".d").PHP_EOL;
echo
"2) ".basename("/etc/sudoers.d").PHP_EOL;
echo
"3) ".basename("/etc/passwd").PHP_EOL;
echo
"4) ".basename("/etc/").PHP_EOL;
echo
"5) ".basename(".").PHP_EOL;
echo
"6) ".basename("/");

?>

Результат выполнения приведённого примера:

1) sudoers
2) sudoers.d
3) passwd
4) etc
5) .
6)

Смотрите также

  • dirname() - Возвращает путь к родительскому каталогу
  • pathinfo() - Возвращает информацию о пути к файлу