Introduce rest_parse_request_arg() wrapper to perform a validation and

joehoyle · joehoyle · commit 35cd7862c68b · 2016-09-28T11:39:59.000-04:00
sanitization in one step.
diff --git a/plugin.php b/plugin.php
@@ -414,6 +414,33 @@ function rest_sanitize_request_arg( $value, $request, $param ) {
 	}
 }
 
+
+if ( ! function_exists( 'rest_parse_request_arg' ) ) {
+	/**
+	 * Parse a request argument based on details registered to the route.
+	 *
+	 * Runs a validation check and sanitizes the value, primarily to be used via
+	 * the `sanitize_callback` arguments in the endpoint args registration.
+	 *
+	 * @param  mixed            $value
+	 * @param  WP_REST_Request  $request
+	 * @param  string           $param
+	 * @return mixed
+	 */
+	function rest_parse_request_arg( $value, $request, $param ) {
+
+		$is_valid = rest_validate_request_arg( $value, $request, $param );
+
+		if ( is_wp_error( $is_valid ) ) {
+			return $is_valid;
+		}
+
+		$value = rest_sanitize_request_arg( $value, $request, $param );
+
+		return $value;
+	}
+}
+
 if ( ! function_exists( 'rest_is_ip_address' ) ) {
 	/**
 	 * Determines if a IPv4 address is valid.
