# get_attachment_taxonomies()

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

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

## Сигнатура

```php
get_attachment_taxonomies( int|array|object $attachment, string $output = 'names' ): string[]|WP_Taxonomy[]
```

## Описание

Получает таксономии, привязанные к указанному вложению.

## Параметры

- `$attachment` `int|array|object` — обязательный. Идентификатор вложения, массив данных или объект данных.
- `$output` `string` — необязательный, по умолчанию `'names'`. Тип вывода. 'names' — вернуть массив имён таксономий, 'objects' — вернуть массив объектов таксономий.
  
  Значение по умолчанию — 'names'.

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

`string[]|WP_Taxonomy[]`

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

Файл: `wp-includes/media.php:4024`

```php
function get_attachment_taxonomies( $attachment, $output = 'names' ) {
	if ( is_int( $attachment ) ) {
		$attachment = get_post( $attachment );
	} elseif ( is_array( $attachment ) ) {
		$attachment = (object) $attachment;
	}

	if ( ! is_object( $attachment ) ) {
		return array();
	}

	$file     = get_attached_file( $attachment->ID );
	$filename = wp_basename( $file );

	$objects = array( 'attachment' );

	if ( str_contains( $filename, '.' ) ) {
		$objects[] = 'attachment:' . substr( $filename, strrpos( $filename, '.' ) + 1 );
	}

	if ( ! empty( $attachment->post_mime_type ) ) {
		$objects[] = 'attachment:' . $attachment->post_mime_type;

		if ( str_contains( $attachment->post_mime_type, '/' ) ) {
			foreach ( explode( '/', $attachment->post_mime_type ) as $token ) {
				if ( ! empty( $token ) ) {
					$objects[] = "attachment:$token";
				}
			}
		}
	}

	$taxonomies = array();

	foreach ( $objects as $object ) {
		$taxes = get_object_taxonomies( $object, $output );

		if ( $taxes ) {
			$taxonomies = array_merge( $taxonomies, $taxes );
		}
	}

	if ( 'names' === $output ) {
		$taxonomies = array_unique( $taxonomies );
	}

	return $taxonomies;
}
```

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

- 4.7.0 — Introduced the $output parameter.
- 2.5.0 — Introduced.

## Связанные

Использует: [`get_object_taxonomies`](https://chugunov.pro/api-wordpress/functions/get_object_taxonomies/), [`get_attached_file`](https://chugunov.pro/api-wordpress/functions/get_attached_file/), [`wp_basename`](https://chugunov.pro/api-wordpress/functions/wp_basename/), [`get_post`](https://chugunov.pro/api-wordpress/functions/get_post/).
Используется в: [`get_attachment_fields_to_edit`](https://chugunov.pro/api-wordpress/functions/get_attachment_fields_to_edit/), [`get_compat_media_markup`](https://chugunov.pro/api-wordpress/functions/get_compat_media_markup/), [`media_upload_form_handler`](https://chugunov.pro/api-wordpress/functions/media_upload_form_handler/), [`wp_ajax_save_attachment_compat`](https://chugunov.pro/api-wordpress/functions/wp_ajax_save_attachment_compat/), [`get_object_taxonomies`](https://chugunov.pro/api-wordpress/functions/get_object_taxonomies/).

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