# Функция WP_BASENAME()
## Общее описание
Функция wp_basename()
— это удобный способ получить имя файла из полного пути. Она обрезает любые суффиксы (например, .jpg или .png) и возвращает только нужную часть. Эта функция удобна, когда вам нужно работать с именами файлов в WordPress.
### Скорость выполнения
- **1 раз** — 0.000025 сек (очень быстро)
- **50000 раз** — 0.30 сек (также очень быстро)
## Параметры функции
Функция wp_basename()
принимает два параметра:
- **$path (строка)** (обязательный) — Полный путь к файлу, например, http://example.com/image.jpg
.
- **$suffix (строка)** (необязательный) — Если имя файла заканчивается на указанный суффикс, этот суффикс будет удалён. По умолчанию равен пустой строке ''
.
## Возвращаемое значение
Функция возвращает строку — имя файла без пути и, при необходимости, без суффикса.
## Примеры использования
Вот нескольк�� примеров работы функции wp_basename()
:
```php
echo wp_basename('http://domain/image.jpg', '.jpg'); //> image
echo wp_basename('/etc/image.jpg', '.jpg'); //> image
echo wp_basename('/etc/image.jpg'); //> image.jpg
echo wp_basename('/etc/passwd'); //> passwd
echo wp_basename('/etc/'); //> etc
echo wp_basename('.'); //> .
echo wp_basename('/'); //> пустая строка
echo wp_basename('/спiдма'); //> спiдма
Код функции
Функция реализована следующим образом:
function wp_basename( $path, $suffix = '' ) {
return urldecode( basename( str_replace( array( '%2F', '%5C' ), '/', urlencode( $path ) ), $suffix ) );
}
Примечания
- Функция удобно обрабатывает специальные символы и разные форматы пути.
- Используйте
wp_basename()
, когда нужно получить имя файла из полного пути в ваших проектах WordPress.
Связанные функции
- get_attached_file() — Получает путь к файлу, связанному с вложением.
- get_home_path() — Возвращает путь к корневой папке сайта.
- get_template() — Возвращает имя текущей темы.
Эти функции могут оказаться полезными, если вы хотите работать с файлами и путями в WordPress.