# wp_basename()

URL: https://chugunov.pro/api-wordpress/functions/wp_basename/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 3.1.0.

## Сигнатура

```php
wp_basename( string $path, string $suffix = '' ): string
```

## Описание

Версия basename(), совместимая с i18n.

## Параметры

- `$path` `string` — обязательный. Путь.
- `$suffix` `string` — необязательный, по умолчанию `''`. Если имя файла заканчивается на суффикс, он также будет отсечён.

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

`string`

## Исходный код

Файл: `wp-includes/formatting.php:5683`

```php
function wp_basename( $path, $suffix = '' ) {
	return urldecode( basename( str_replace( array( '%2F', '%5C' ), '/', urlencode( $path ) ), $suffix ) );
}
```

## История изменений

- 3.1.0 — Introduced.

## Связанные

Используется в: `WP_REST_Attachments_Controller::get_attachment_filename`, [`wp_copy_parent_attachment_properties`](https://chugunov.pro/api-wordpress/functions/wp_copy_parent_attachment_properties/), `WP_REST_Attachments_Controller::edit_media_item`, [`wp_image_src_get_dimensions`](https://chugunov.pro/api-wordpress/functions/wp_image_src_get_dimensions/), `WP_REST_Attachments_Controller::insert_attachment`, [`_wp_image_meta_replace_original`](https://chugunov.pro/api-wordpress/functions/_wp_image_meta_replace_original/), [`verify_file_signature`](https://chugunov.pro/api-wordpress/functions/verify_file_signature/), [`wp_delete_attachment_files`](https://chugunov.pro/api-wordpress/functions/wp_delete_attachment_files/), [`wp_print_theme_file_tree`](https://chugunov.pro/api-wordpress/functions/wp_print_theme_file_tree/), `WP_Customize_Manager::import_theme_starter_content`, `WP_Customize_Manager::prepare_starter_content_attachments`, `WP_REST_Attachments_Controller::prepare_item_for_response`, `WP_Customize_Manager::get_return_url`, [`wp_image_add_srcset_and_sizes`](https://chugunov.pro/api-wordpress/functions/wp_image_add_srcset_and_sizes/), [`wp_calculate_image_srcset`](https://chugunov.pro/api-wordpress/functions/wp_calculate_image_srcset/), `WP_Site_Icon::create_attachment_object`, `WP_Media_List_Table::column_title`, `WP_Customize_Media_Control::to_json`, [`wp_image_editor`](https://chugunov.pro/api-wordpress/functions/wp_image_editor/), [`_copy_image_file`](https://chugunov.pro/api-wordpress/functions/_copy_image_file/), [`wp_generate_attachment_metadata`](https://chugunov.pro/api-wordpress/functions/wp_generate_attachment_metadata/), [`wp_crop_image`](https://chugunov.pro/api-wordpress/functions/wp_crop_image/), [`attachment_submitbox_metadata`](https://chugunov.pro/api-wordpress/functions/attachment_submitbox_metadata/), [`get_media_item`](https://chugunov.pro/api-wordpress/functions/get_media_item/), [`wp_media_upload_handler`](https://chugunov.pro/api-wordpress/functions/wp_media_upload_handler/), [`media_sideload_image`](https://chugunov.pro/api-wordpress/functions/media_sideload_image/), [`media_handle_upload`](https://chugunov.pro/api-wordpress/functions/media_handle_upload/), [`media_handle_sideload`](https://chugunov.pro/api-wordpress/functions/media_handle_sideload/), [`wp_ajax_send_link_to_editor`](https://chugunov.pro/api-wordpress/functions/wp_ajax_send_link_to_editor/), [`wp_import_handle_upload`](https://chugunov.pro/api-wordpress/functions/wp_import_handle_upload/), `Custom_Image_Header::create_attachment_object`, `Custom_Image_Header::step_2`, `Custom_Image_Header::step_2_manage_upload`, `Custom_Image_Header::step_3`, `Custom_Background::handle_upload`, [`get_theme_data`](https://chugunov.pro/api-wordpress/functions/get_theme_data/), [`get_attachment_icon_src`](https://chugunov.pro/api-wordpress/functions/get_attachment_icon_src/), `WP_Query::get_posts`, `WP_Query::parse_tax_query`, `WP_Image_Editor_Imagick::_save`.

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/wp_basename/