# get_attached_file()

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

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

## Сигнатура

```php
get_attached_file( int $attachment_id, bool $unfiltered = false ): string|false
```

## Описание

По умолчанию путь проходит через фильтр ‘get_attached_file’, но передача true в аргумент $unfiltered вернёт путь к файлу без фильтрации.
Функция работает, получая значение метаполя записи _wp_attached_file.
Это вспомогательная функция, позволяющая не искать имя метаполя и предоставляющая механизм передачи имени прикреплённого файла через фильтр.

## Параметры

- `$attachment_id` `int` — обязательный. Идентификатор вложения.
- `$unfiltered` `bool` — необязательный, по умолчанию `false`. Пропускать ли фильтр 'get_attached_file'.

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

`string|false`

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

Файл: `wp-includes/post.php:845`

```php
function get_attached_file( $attachment_id, $unfiltered = false ) {
	$file = get_post_meta( $attachment_id, '_wp_attached_file', true );

	// If the file is relative, prepend upload dir.
	if ( $file && ! str_starts_with( $file, '/' ) && ! preg_match( '|^.:\\\|', $file ) ) {
		$uploads = wp_get_upload_dir();
		if ( false === $uploads['error'] ) {
			$file = $uploads['basedir'] . "/$file";
		}
	}

	if ( $unfiltered ) {
		return $file;
	}

	/**
	 * Filters the attached file based on the given ID.
	 *
	 * @since 2.1.0
	 *
	 * @param string|false $file          The file path to where the attached file should be, false otherwise.
	 * @param int          $attachment_id Attachment ID.
	 */
	return apply_filters( 'get_attached_file', $file, $attachment_id );
}
```

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

- 2.0.0 — Introduced.

## Связанные

Использует: [`wp_get_upload_dir`](https://chugunov.pro/api-wordpress/functions/wp_get_upload_dir/), [`apply_filters`](https://chugunov.pro/api-wordpress/functions/apply_filters/), [`get_post_meta`](https://chugunov.pro/api-wordpress/functions/get_post_meta/).
Используется в: `WP_REST_Attachments_Controller::get_attachment_filename`, `WP_REST_Attachments_Controller::get_attachment_filesize`, [`wp_get_original_image_path`](https://chugunov.pro/api-wordpress/functions/wp_get_original_image_path/), `WP_Customize_Manager::_validate_header_video`, `WP_Customize_Manager::import_theme_starter_content`, `WP_Media_List_Table::column_title`, [`wp_attachment_is`](https://chugunov.pro/api-wordpress/functions/wp_attachment_is/), `File_Upload_Upgrader::__construct`, [`wp_restore_image`](https://chugunov.pro/api-wordpress/functions/wp_restore_image/), [`wp_save_image`](https://chugunov.pro/api-wordpress/functions/wp_save_image/), [`_copy_image_file`](https://chugunov.pro/api-wordpress/functions/_copy_image_file/), [`_load_image_to_edit_path`](https://chugunov.pro/api-wordpress/functions/_load_image_to_edit_path/), [`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/), `Custom_Image_Header::step_2`, `Custom_Image_Header::step_3`, [`wp_load_image`](https://chugunov.pro/api-wordpress/functions/wp_load_image/), [`get_attachment_icon_src`](https://chugunov.pro/api-wordpress/functions/get_attachment_icon_src/), [`wp_get_attachment_link`](https://chugunov.pro/api-wordpress/functions/wp_get_attachment_link/), [`wp_maybe_generate_attachment_metadata`](https://chugunov.pro/api-wordpress/functions/wp_maybe_generate_attachment_metadata/), [`wp_prepare_attachment_for_js`](https://chugunov.pro/api-wordpress/functions/wp_prepare_attachment_for_js/), [`get_attachment_taxonomies`](https://chugunov.pro/api-wordpress/functions/get_attachment_taxonomies/), [`image_downsize`](https://chugunov.pro/api-wordpress/functions/image_downsize/), [`wp_mime_type_icon`](https://chugunov.pro/api-wordpress/functions/wp_mime_type_icon/), [`wp_get_attachment_thumb_file`](https://chugunov.pro/api-wordpress/functions/wp_get_attachment_thumb_file/), [`wp_delete_attachment`](https://chugunov.pro/api-wordpress/functions/wp_delete_attachment/).

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