prep_atom_text_construct() — описание функции WordPress на русском

Сигнатура

prep_atom_text_construct( string $data ): array

Описание

Сообщает, является ли тип text, HTML или XHTML согласно разделу 3.1 RFC 4287.
В WordPress text определяется как не содержащий разметки, XHTML — как «правильно построенный», а HTML — как «суп из тегов» (то есть всё остальное).
К значениям XHTML добавляются обрамляющие теги div согласно разделу 3.1.1.3.

Оригинал (английский)

Tell whether the type is text, HTML, or XHTML, per RFC 4287 section 3.1.

In the case of WordPress, text is defined as containing no markup, XHTML is defined as “well formed”, and HTML as tag soup (i.e., the rest).

Container div tags are added to XHTML values, per section 3.1.1.3.

Параметры

$data string обязательный

Входная строка.

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

array

Исходный код

wp-includes/feed.php:588

function prep_atom_text_construct( $data ) {
	if ( ! str_contains( $data, '<' ) && ! str_contains( $data, '&' ) ) {
		return array( 'text', $data );
	}

	if ( ! function_exists( 'xml_parser_create' ) ) {
		wp_trigger_error( '', __( "PHP's XML extension is not available. Please contact your hosting provider to enable PHP's XML extension." ) );

		return array( 'html', "<![CDATA[$data]]>" );
	}

	$parser = xml_parser_create();
	xml_parse( $parser, '<div>' . $data . '</div>', true );
	$code = xml_get_error_code( $parser );

	if ( PHP_VERSION_ID < 80000 ) { // xml_parser_free() has no effect as of PHP 8.0.
		xml_parser_free( $parser );
	}

	unset( $parser );

	if ( ! $code ) {
		if ( ! str_contains( $data, '<' ) ) {
			return array( 'text', $data );
		} else {
			$data = "<div xmlns='http://www.w3.org/1999/xhtml'>$data</div>";
			return array( 'xhtml', $data );
		}
	}

	if ( ! str_contains( $data, ']]>' ) ) {
		return array( 'html', "<![CDATA[$data]]>" );
	} else {
		return array( 'html', htmlspecialchars( $data ) );
	}
}

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

Версия	Описание
2.5.0	Introduced.