# wp_get_post_terms()

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

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

## Сигнатура

```php
wp_get_post_terms( int $post_id, string|string[] $taxonomy = 'post_tag', array $args = array() ): array|WP_Error
```

## Описание

Возвращает термины записи.

## Параметры

- `$post_id` `int` — необязательный. ID записи. Не принимает по умолчанию ID глобального объекта $post. Значение по умолчанию 0.
- `$taxonomy` `string|string[]` — необязательный, по умолчанию `'post_tag'`. Слаг таксономии или массив слагов, для которых возвращаются термины. Значение по умолчанию 'post_tag'.
- `$args` `array` — необязательный, по умолчанию `array()`. Term query parameters. See [WP_Term_Query::__construct()](https://developer.wordpress.org/reference/classes/wp_term_query/__construct/) for supported arguments.
  
  - `fields` string Term fields to retrieve. Default `'all'`.

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

`array|WP_Error` — WP_Term WP_Error $taxonomy

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

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

```php
function wp_get_post_terms( $post_id = 0, $taxonomy = 'post_tag', $args = array() ) {
	$post_id = (int) $post_id;

	$defaults = array( 'fields' => 'all' );
	$args     = wp_parse_args( $args, $defaults );

	$tags = wp_get_object_terms( $post_id, $taxonomy, $args );

	return $tags;
}
```

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

- 2.8.0 — Introduced.

## Связанные

Использует: [`wp_get_object_terms`](https://chugunov.pro/api-wordpress/functions/wp_get_object_terms/), [`wp_parse_args`](https://chugunov.pro/api-wordpress/functions/wp_parse_args/).
Используется в: `WP_REST_Menu_Items_Controller::get_menu_id`, `WP_Customize_Nav_Menu_Item_Setting::populate_value`, [`wp_get_post_tags`](https://chugunov.pro/api-wordpress/functions/wp_get_post_tags/).

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