функция since 5.5.0

rest_handle_multi_type_schema()

Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.

Сигнатура

rest_handle_multi_type_schema( mixed $value, array $args, string $param = '' ): string

Описание

Это обёртка над rest_get_best_type_for_value(), которая обеспечивает обратную совместимость для схем, использующих недопустимые типы.

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

This is a wrapper for rest_get_best_type_for_value() that handles backward compatibility for schemas that use invalid types.

Параметры

$value mixed обязательный
Значение для проверки.
$args array обязательный
Используемый массив схемы.
$param string необязательный = ''
Имя параметра, используемое в сообщениях об ошибках.

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

string

Исходный код

wp-includes/rest-api.php:1715

function rest_handle_multi_type_schema( $value, $args, $param = '' ) {
	$allowed_types = array( 'array', 'object', 'string', 'number', 'integer', 'boolean', 'null' );
	$invalid_types = array_diff( $args['type'], $allowed_types );

	if ( $invalid_types ) {
		_doing_it_wrong(
			__FUNCTION__,
			/* translators: 1: Parameter, 2: List of allowed types. */
			wp_sprintf( __( 'The "type" schema keyword for %1$s can only contain the built-in types: %2$l.' ), $param, $allowed_types ),
			'5.5.0'
		);
	}

	$best_type = rest_get_best_type_for_value( $value, $args['type'] );

	if ( ! $best_type ) {
		if ( ! $invalid_types ) {
			return '';
		}

		// Backward compatibility for previous behavior which allowed the value if there was an invalid type used.
		$best_type = reset( $invalid_types );
	}

	return $best_type;
}

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

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

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.