basename

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

basenameПовертає останній компонент рядка шляху

Опис

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

При передачі рядка, що містить шлях до файла чи директорії, ця функція повертає останній компонент наданого рядка.

Зауваження:

Можна сказати, що basename() працює умовно зі "шляхами", бо вона фактично не дивиться у файлову систему, та не враховує таких компонентів як "..".

Застереження

basename() враховує налаштування локалі, отже щоб мати коректний результат при роботі з мультибайтними рядками, потрібно встановлювати відповідну локаль використовуючи функцію setlocale().

Параметри

path

Шлях.

На Windows, в якості роздільників директорій використовується як прямий слеш (/) так і зворотній (\). В інших середовищах - це прямий слеш (/).

suffix

Якщо рядок закінчується на suffix, він також буде обрізатись.

Значення, що повертаються

Повертає кінцевий компонент рядка path (шляху).

Приклади

Приклад #1 Використання basename()

<?php
+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() - Returns a parent directory's path
  • pathinfo() - Returns information about a file path