# wp_embed_handler_youtube()

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

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

## Сигнатура

```php
wp_embed_handler_youtube( array $matches, array $attr, string $url, array $rawattr ): string
```

## Описание

Перехватывает URL-адреса встраивания iframe YouTube, которые не распознаются oEmbed, но могут быть преобразованы в распознаваемый URL.

## Параметры

- `$matches` `array` — обязательный. Совпадения регулярного выражения, полученные при вызове wp_embed_register_handler() .
- `$attr` `array` — обязательный. Атрибуты встраивания.
- `$url` `string` — обязательный. Исходный URL, совпавший с регулярным выражением.
- `$rawattr` `array` — обязательный. Исходные неизменённые атрибуты.

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

`string`

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

Файл: `wp-includes/embed.php:242`

```php
function wp_embed_handler_youtube( $matches, $attr, $url, $rawattr ) {
	global $wp_embed;
	$embed = $wp_embed->autoembed( sprintf( 'https://youtube.com/watch?v=%s', urlencode( $matches[2] ) ) );

	/**
	 * Filters the YouTube embed output.
	 *
	 * @since 4.0.0
	 *
	 * @see wp_embed_handler_youtube()
	 *
	 * @param string $embed   YouTube embed output.
	 * @param array  $attr    An array of embed attributes.
	 * @param string $url     The original URL that was matched by the regex.
	 * @param array  $rawattr The original unmodified attributes.
	 */
	return apply_filters( 'wp_embed_handler_youtube', $embed, $attr, $url, $rawattr );
}
```

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

- 4.0.0 — Introduced.

## Связанные

Использует: `WP_Embed::autoembed`, `WP_Embed::shortcode`, [`apply_filters`](https://chugunov.pro/api-wordpress/functions/apply_filters/).

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