rest_validate_enum( mixed $value, array $args, string $param ): true|WP_Error

Validates that the given value is a member of the JSON Schema “enum”.

Contents

Parameters

$value mixed Required
The value to validate.
$args array Required
The schema array to use.
$param string Required
The parameter name, used in error messages.

Top ↑

Return

true|WP_Error True if the "enum" contains the value or a WP_Error instance otherwise.

Top ↑

Source

File: wp-includes/rest-api.php. View all references 

function rest_validate_enum( $value, $args, $param ) {
	$sanitized_value = rest_sanitize_value_from_schema( $value, $args, $param );
	if ( is_wp_error( $sanitized_value ) ) {
		return $sanitized_value;
	}

	foreach ( $args['enum'] as $enum_value ) {
		if ( rest_are_values_equal( $sanitized_value, $enum_value ) ) {
			return true;
		}
	}

	$encoded_enum_values = array();
	foreach ( $args['enum'] as $enum_value ) {
		$encoded_enum_values[] = is_scalar( $enum_value ) ? $enum_value : wp_json_encode( $enum_value );
	}

	if ( count( $encoded_enum_values ) === 1 ) {
		/* translators: 1: Parameter, 2: Valid values. */
		return new WP_Error( 'rest_not_in_enum', wp_sprintf( __( '%1$s is not %2$s.' ), $param, $encoded_enum_values[0] ) );
	}

	/* translators: 1: Parameter, 2: List of valid values. */
	return new WP_Error( 'rest_not_in_enum', wp_sprintf( __( '%1$s is not one of %2$l.' ), $param, $encoded_enum_values ) );
}

View on Trac View on GitHub

Top ↑

Top ↑

Uses

Uses
Uses Description
rest_are_values_equal() wp-includes/rest-api.php

Checks the equality of two values, following JSON Schema semantics.
rest_sanitize_value_from_schema() wp-includes/rest-api.php

Sanitize a value based on a schema.
wp_sprintf() wp-includes/formatting.php

WordPress’ implementation of PHP sprintf() with filters.
wp_json_encode() wp-includes/functions.php

Encodes a variable into JSON, with some sanity checks.
__() wp-includes/l10n.php

Retrieves the translation of $text.
is_wp_error() wp-includes/load.php

Checks whether the given variable is a WordPress Error.
WP_Error::__construct() wp-includes/class-wp-error.php

Initializes the error.
Show 4 more uses Hide more uses

Top ↑

Changelog

Changelog
Version Description
5.7.0 Introduced.

Top ↑

User Contributed Notes

  1. Skip to note 1 content
    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
    Contributed by Brian Mutende —

    NOTE: Do not provide enums if the property accepts array values. The example below will fail.

    array(
	'description' => 'Testing',
	'context'     => array( 'view', 'edit' ),
	'enum'        => array( 'first', 'second', 'third' ),
	'type'        => 'array',
	'items'       => array(
		'type' => 'string',
	),
	'default'     => array( 'first', 'second' ),
	'required'    => false,
)

You must log in before being able to contribute a note or feedback.