WP_REST_Settings_Controller::sanitize_callback( mixed $value, WP_REST_Request $request, string $param )

Custom sanitize callback used for all options to allow the use of ‘null’.

Description

By default, the schema of settings will throw an error if a value is set to null as it’s not a valid value for something like "type => string". We provide a wrapper sanitizer to allow the use of null.

Parameters

$value: (mixed) (Required) The value for the setting.
$request: (WP_REST_Request) (Required) The request object.
$param: (string) (Required) The parameter name.

Return

(mixed|WP_Error)

Source

File: wp-includes/rest-api/endpoints/class-wp-rest-settings-controller.php

public function sanitize_callback( $value, $request, $param ) {
		if ( is_null( $value ) ) {
			return $value;
		}

		return rest_parse_request_arg( $value, $request, $param );
	}

Uses	Description
wp-includes/rest-api.php: rest_parse_request_arg()	Parse a request argument based on details registered to the route.

Changelog

Version	Description
4.7.0	Introduced.

© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/classes/wp_rest_settings_controller/sanitize_callback