# get_tags()

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

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

## Сигнатура

```php
get_tags( string|array $args = '' ): WP_Term[]|int|WP_Error
```

## Описание

Извлекает все метки записей.

## Параметры

- `$args` `string|array` — необязательный, по умолчанию `''`. Аргументы для извлечения меток. Дополнительные параметры смотрите в get_terms().
  
  taxonomy stringТаксономия, для которой извлекаются термины. По умолчанию 'post_tag'.

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

`WP_Term[]|int|WP_Error` — 'post_tag' WP_Error

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

Файл: `wp-includes/category.php:295`

```php
function get_tags( $args = '' ) {
	$defaults = array( 'taxonomy' => 'post_tag' );
	$args     = wp_parse_args( $args, $defaults );

	$tags = get_terms( $args );

	if ( empty( $tags ) ) {
		$tags = array();
	} else {
		/**
		 * Filters the array of term objects returned for the 'post_tag' taxonomy.
		 *
		 * @since 2.3.0
		 *
		 * @param WP_Term[]|int|WP_Error $tags Array of 'post_tag' term objects, a count thereof,
		 *                                     or WP_Error if any of the taxonomies do not exist.
		 * @param array                  $args An array of arguments. See get_terms().
		 */
		$tags = apply_filters( 'get_tags', $tags, $args );
	}

	return $tags;
}
```

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

- 2.3.0 — Introduced.

## Связанные

Использует: [`get_terms`](https://chugunov.pro/api-wordpress/functions/get_terms/), [`wp_parse_args`](https://chugunov.pro/api-wordpress/functions/wp_parse_args/), [`apply_filters`](https://chugunov.pro/api-wordpress/functions/apply_filters/).
Используется в: [`export_wp`](https://chugunov.pro/api-wordpress/functions/export_wp/), `wp_xmlrpc_server::wp_getTags`.

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