rest_handle_options_request

函式
rest_handle_options_request ( $response, $handler, $request )
引數
  • (mixed) $response Current response, either response or `null` to indicate pass-through.
    Required:
  • (WP_REST_Server) $handler ResponseHandler instance (usually WP_REST_Server).
    Required:
  • (WP_REST_Request) $request The request that was used to make current response.
    Required:
返回值
  • (WP_REST_Response) Modified response, either response or `null` to indicate pass-through.
定義位置
相關方法
rest_do_requestrest_ensure_requestrest_sanitize_request_argrest_validate_request_arg_delete_option_fresh_site
引入
4.4.0
棄用
-

rest_handle_options_request: 這是一個WordPress的函式,用於處理一個REST API端點的HTTP OPTIONS請求: 該函式在HTTP允許頭中為端點傳送允許的HTTP方法,以及該端點支援的任何額外的頭。

處理伺服器的OPTIONS請求。

這是在伺服器程式碼之外處理的,因為它不服從正常的路由對映。

function rest_handle_options_request( $response, $handler, $request ) {
	if ( ! empty( $response ) || $request->get_method() !== 'OPTIONS' ) {
		return $response;
	}

	$response = new WP_REST_Response();
	$data     = array();

	foreach ( $handler->get_routes() as $route => $endpoints ) {
		$match = preg_match( '@^' . $route . '$@i', $request->get_route(), $matches );

		if ( ! $match ) {
			continue;
		}

		$args = array();
		foreach ( $matches as $param => $value ) {
			if ( ! is_int( $param ) ) {
				$args[ $param ] = $value;
			}
		}

		foreach ( $endpoints as $endpoint ) {
			// Remove the redundant preg_match() argument.
			unset( $args[0] );

			$request->set_url_params( $args );
			$request->set_attributes( $endpoint );
		}

		$data = $handler->get_data_for_route( $route, $endpoints, 'help' );
		$response->set_matched_route( $route );
		break;
	}

	$response->set_data( $data );
	return $response;
}

常見問題

FAQs
檢視更多 >