Changeset 59899 for trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php

Timestamp:

03/02/2025 10:05:08 PM (3 months ago)

Author:

TimothyBlynJacobs

Message:

REST API: Improve performance for HEAD requests.

By default, the REST API responds to HEAD rqeuests by calling the GET handler and omitting the body from the response. While convenient, this ends up performing needless work that slows down the API response time.

This commit adjusts the Core controllers to specifically handle HEAD requests by not preparing the response body.

Fixes #56481.
Props antonvlasenko, janusdev, ironprogrammer, swissspidy, spacedmonkey, mukesh27, mamaduka, timothyblynjacobs.

File:

• trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php (modified) (4 diffs)

trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php

@@ -412 +412 @@
         $args['post_type'] = $this->post_type;
 
+        $is_head_request = $request->is_method( 'HEAD' );
+        if ( $is_head_request ) {
+            // Force the 'fields' argument. For HEAD requests, only post IDs are required to calculate pagination.
+            $args['fields'] = 'ids';
+            // Disable priming post meta for HEAD requests to improve performance.
+            $args['update_post_term_cache'] = false;
+            $args['update_post_meta_cache'] = false;
+        }
+
         /**
          * Filters WP_Query arguments when querying posts via the REST API.
@@ -444 +453 @@
         }
 
-        $posts = array();
-
-        update_post_author_caches( $query_result );
-        update_post_parent_caches( $query_result );
-
-        if ( post_type_supports( $this->post_type, 'thumbnail' ) ) {
-            update_post_thumbnail_cache( $posts_query );
-        }
-
-        foreach ( $query_result as $post ) {
-            if ( ! $this->check_read_permission( $post ) ) {
-                continue;
-            }
-
-            $data    = $this->prepare_item_for_response( $post, $request );
-            $posts[] = $this->prepare_response_for_collection( $data );
+        if ( ! $is_head_request ) {
+            $posts = array();
+
+            update_post_author_caches( $query_result );
+            update_post_parent_caches( $query_result );
+
+            if ( post_type_supports( $this->post_type, 'thumbnail' ) ) {
+                update_post_thumbnail_cache( $posts_query );
+            }
+
+            foreach ( $query_result as $post ) {
+                if ( ! $this->check_read_permission( $post ) ) {
+                    continue;
+                }
+
+                $data    = $this->prepare_item_for_response( $post, $request );
+                $posts[] = $this->prepare_response_for_collection( $data );
+            }
         }
 
@@ -489 +500 @@
         }
 
-        $response = rest_ensure_response( $posts );
+        $response = $is_head_request ? new WP_REST_Response() : rest_ensure_response( $posts );
 
         $response->header( 'X-WP-Total', (int) $total_posts );
@@ -1833 +1844 @@
 
         setup_postdata( $post );
+
+        // Don't prepare the response body for HEAD requests.
+        if ( $request->is_method( 'HEAD' ) ) {
+            /** This filter is documented in wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php */
+            return apply_filters( "rest_prepare_{$this->post_type}", new WP_REST_Response(), $post, $request );
+        }
 
         $fields = $this->get_fields_for_response( $request );