enmi-conf.org: comparison wp/wp-includes/rest-api/class-wp-rest-server.php

equal deleted inserted replaced

-:c7c34916027a
+:177826044cd9
 	public function __construct() {
 		$this->endpoints = array(
 			// Meta endpoints.
 			'/' => array(
 				'callback' => array( $this, 'get_index' ),
-				'methods' => 'GET',
+				'methods'  => 'GET',
-				'args' => array(
+				'args'     => array(
 					'context' => array(
 						'default' => 'view',
 					),
 				),
 			),
 		$errors = array();
 		foreach ( (array) $error->errors as $code => $messages ) {
 			foreach ( (array) $messages as $message ) {
-				$errors[] = array( 'code' => $code, 'message' => $message, 'data' => $error->get_error_data( $code ) );
+				$errors[] = array(
+					'code'    => $code,
+					'message' => $message,
+					'data'    => $error->get_error_data( $code ),
+				);
 			}
 		}
 		$data = $errors[0];
 		if ( count( $errors ) > 1 ) {
 		 * @since 4.4.0
 		 * @deprecated 4.7.0 Use the rest_authentication_errors filter to restrict access to the API
 		 *
 		 * @param bool $rest_enabled Whether the REST API is enabled. Default true.
 		 */
-		apply_filters_deprecated( 'rest_enabled', array( true ), '4.7.0', 'rest_authentication_errors',
+		apply_filters_deprecated(
+			'rest_enabled',
+			array( true ),
+			'4.7.0',
+			'rest_authentication_errors',
 			__( 'The REST API can no longer be completely disabled, the rest_authentication_errors filter can be used to restrict access to the API, instead.' )
 		);
 		/**
 		 * Filters whether jsonp is enabled.
 			$result = wp_json_encode( $result );
 			$json_error_message = $this->get_json_last_error();
 			if ( $json_error_message ) {
 				$json_error_obj = new WP_Error( 'rest_encode_error', $json_error_message, array( 'status' => 500 ) );
-				$result = $this->error_to_response( $json_error_obj );
+				$result         = $this->error_to_response( $json_error_obj );
-				$result = wp_json_encode( $result->data[0] );
+				$result         = wp_json_encode( $result->data[0] );
 			}
 			if ( $jsonp_callback ) {
 				// Prepend '/**/' to mitigate possible JSONP Flash attacks.
 				// https://miki.it/blog/2014/7/8/abusing-jsonp-with-rosetta-flash/
 	 *
 	 * Extracts the links from a response into a structured hash, suitable for
 	 * direct output.
 	 *
 	 * @since 4.4.0
-	 * @static
 	 *
 	 * @param WP_REST_Response $response Response to extract links from.
 	 * @return array Map of link relation to list of link hashes.
 	 */
 	public static function get_response_links( $response ) {
 		$data = array();
 		foreach ( $links as $rel => $items ) {
 			$data[ $rel ] = array();
 			foreach ( $items as $item ) {
-				$attributes = $item['attributes'];
+				$attributes         = $item['attributes'];
 				$attributes['href'] = $item['href'];
-				$data[ $rel ][] = $attributes;
+				$data[ $rel ][]     = $attributes;
 			}
 		}
 		return $data;
 	}
 	 *
 	 * Extracts the links from a response into a structured hash, suitable for
 	 * direct output.
 	 *
 	 * @since 4.5.0
-	 * @static
 	 *
 	 * @param WP_REST_Response $response Response to extract links from.
 	 * @return array Map of link relation to list of link hashes.
 	 */
 	public static function get_compact_response_links( $response ) {
 		if ( empty( $links ) ) {
 			return array();
 		}
-		$curies = $response->get_curies();
+		$curies      = $response->get_curies();
 		$used_curies = array();
 		foreach ( $links as $rel => $items ) {
 			// Convert $rel URIs to their compact versions if they exist.
 				// Relation now changes from '$uri' to '$curie:$relation'.
 				$rel_regex = str_replace( '\{rel\}', '(.+)', preg_quote( $curie['href'], '!' ) );
 				preg_match( '!' . $rel_regex . '!', $rel, $matches );
 				if ( $matches ) {
-					$new_rel = $curie['name'] . ':' . $matches[1];
+					$new_rel                       = $curie['name'] . ':' . $matches[1];
 					$used_curies[ $curie['name'] ] = $curie;
-					$links[ $new_rel ] = $items;
+					$links[ $new_rel ]             = $items;
 					unset( $links[ $rel ] );
 					break;
 				}
 			}
 		}
 	 */
 	public function register_route( $namespace, $route, $route_args, $override = false ) {
 		if ( ! isset( $this->namespaces[ $namespace ] ) ) {
 			$this->namespaces[ $namespace ] = array();
-			$this->register_route( $namespace, '/' . $namespace, array(
+			$this->register_route(
+				$namespace,
+				'/' . $namespace,
 				array(
-					'methods' => self::READABLE,
+					array(
-					'callback' => array( $this, 'get_namespace_index' ),
+						'methods'  => self::READABLE,
-					'args' => array(
+						'callback' => array( $this, 'get_namespace_index' ),
-						'namespace' => array(
+						'args'     => array(
-							'default' => $namespace,
+							'namespace' => array(
-						),
+								'default' => $namespace,
-						'context' => array(
+							),
-							'default' => 'view',
+							'context'   => array(
+								'default' => 'view',
+							),
 						),
 					),
-				),
+				)
-			) );
+			);
 		}
 		// Associative to avoid double-registration.
 		$this->namespaces[ $namespace ][ $route ] = true;
-		$route_args['namespace'] = $namespace;
+		$route_args['namespace']                  = $namespace;
 		if ( $override || empty( $this->endpoints[ $route ] ) ) {
 			$this->endpoints[ $route ] = $route_args;
 		} else {
 			$this->endpoints[ $route ] = array_merge( $this->endpoints[ $route ], $route_args );
 				}
 				$handler['methods'] = array();
 				foreach ( $methods as $method ) {
-					$method = strtoupper( trim( $method ) );
+					$method                        = strtoupper( trim( $method ) );
 					$handler['methods'][ $method ] = true;
 				}
 			}
 		}
 					$args[ $param ] = $value;
 				}
 			}
 			foreach ( $handlers as $handler ) {
-				$callback  = $handler['callback'];
+				$callback = $handler['callback'];
 				$response = null;
 				// Fallback to GET method if no HEAD method is registered.
 				$checked_method = $method;
 				if ( 'HEAD' === $method && empty( $handler['methods']['HEAD'] ) ) {
 				 * Note that this filter will not be called for requests that
 				 * fail to authenticate or match to a registered route.
 				 *
 				 * @since 4.7.0
 				 *
-				 * @param WP_HTTP_Response $response Result to send to the client. Usually a WP_REST_Response.
+				 * @param WP_HTTP_Response|WP_Error $response Result to send to the client. Usually a WP_REST_Response or WP_Error.
-				 * @param WP_REST_Server   $handler  ResponseHandler instance (usually WP_REST_Server).
+				 * @param array                     $handler  Route handler used for the request.
-				 * @param WP_REST_Request  $request  Request used to generate the response.
+				 * @param WP_REST_Request           $request  Request used to generate the response.
 				 */
 				$response = apply_filters( 'rest_request_before_callbacks', $response, $handler, $request );
 				if ( ! is_wp_error( $response ) ) {
 					// Check permission specified on the route.
 					 * Allow plugins to override dispatching the request.
 					 *
 					 * @since 4.4.0
 					 * @since 4.5.0 Added `$route` and `$handler` parameters.
 					 *
-					 * @param bool            $dispatch_result Dispatch result, will be used if not empty.
+					 * @param mixed           $dispatch_result Dispatch result, will be used if not empty.
 					 * @param WP_REST_Request $request         Request used to generate the response.
 					 * @param string          $route           Route matched for the request.
 					 * @param array           $handler         Route handler used for the request.
 					 */
 					$dispatch_result = apply_filters( 'rest_dispatch_request', null, $request, $route, $handler );
 				 * Note that an endpoint's `permission_callback` can still be
 				 * called after this filter - see `rest_send_allow_header()`.
 				 *
 				 * @since 4.7.0
 				 *
-				 * @param WP_HTTP_Response $response Result to send to the client. Usually a WP_REST_Response.
+				 * @param WP_HTTP_Response|WP_Error $response Result to send to the client. Usually a WP_REST_Response or WP_Error.
-				 * @param WP_REST_Server   $handler  ResponseHandler instance (usually WP_REST_Server).
+				 * @param array                     $handler  Route handler used for the request.
-				 * @param WP_REST_Request  $request  Request used to generate the response.
+				 * @param WP_REST_Request           $request  Request used to generate the response.
 				 */
 				$response = apply_filters( 'rest_request_after_callbacks', $response, $handler, $request );
 				if ( is_wp_error( $response ) ) {
 					$response = $this->error_to_response( $response );
 		if ( ! isset( $this->namespaces[ $namespace ] ) ) {
 			return new WP_Error( 'rest_invalid_namespace', __( 'The specified namespace could not be found.' ), array( 'status' => 404 ) );
 		}
-		$routes = $this->namespaces[ $namespace ];
+		$routes    = $this->namespaces[ $namespace ];
 		$endpoints = array_intersect_key( $this->get_routes(), $routes );
-		$data = array(
+		$data     = array(
 			'namespace' => $namespace,
-			'routes' => $this->get_data_for_routes( $endpoints, $request['context'] ),
+			'routes'    => $this->get_data_for_routes( $endpoints, $request['context'] ),
 		);
 		$response = rest_ensure_response( $data );
 		// Link to the root index.
 		$response->add_link( 'up', rest_url( '/' ) );
 	 * @return array|null Data for the route, or null if no publicly-visible data.
 	 */
 	public function get_data_for_route( $route, $callbacks, $context = 'view' ) {
 		$data = array(
 			'namespace' => '',
-			'methods' => array(),
+			'methods'   => array(),
 			'endpoints' => array(),
 		);
 		if ( isset( $this->route_options[ $route ] ) ) {
 			$options = $this->route_options[ $route ];
 			if ( empty( $callback['show_in_index'] ) ) {
 				continue;
 			}
 			$data['methods'] = array_merge( $data['methods'], array_keys( $callback['methods'] ) );
-			$endpoint_data = array(
+			$endpoint_data   = array(
 				'methods' => array_keys( $callback['methods'] ),
 			);
 			if ( isset( $callback['args'] ) ) {
 				$endpoint_data['args'] = array();
 	 */
 	public function get_headers( $server ) {
 		$headers = array();
 		// CONTENT_* headers are not prefixed with HTTP_.
-		$additional = array( 'CONTENT_LENGTH' => true, 'CONTENT_MD5' => true, 'CONTENT_TYPE' => true );
+		$additional = array(
+			'CONTENT_LENGTH' => true,
+			'CONTENT_MD5'    => true,
+			'CONTENT_TYPE'   => true,
+		);
 		foreach ( $server as $key => $value ) {
 			if ( strpos( $key, 'HTTP_' ) === 0 ) {
 				$headers[ substr( $key, 5 ) ] = $value;
 			} elseif ( isset( $additional[ $key ] ) ) {

changeset 9	177826044cd9
parent 7	cf61fcea0001
child 16	a86126ab1dd4