Changeset 59899 for trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-terms-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-terms-controller.php (modified) (3 diffs)

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

@@ -313 +313 @@
         }
 
+        $is_head_request = $request->is_method( 'HEAD' );
+        if ( $is_head_request ) {
+            // Force the 'fields' argument. For HEAD requests, only term IDs are required.
+            $prepared_args['fields'] = 'ids';
+            // Disable priming term meta for HEAD requests to improve performance.
+            $prepared_args['update_term_meta_cache'] = false;
+        }
+
         /**
          * Filters get_terms() arguments when querying terms via the REST API.
@@ -355 +363 @@
         }
 
-        $response = array();
-
-        foreach ( $query_result as $term ) {
-            $data       = $this->prepare_item_for_response( $term, $request );
-            $response[] = $this->prepare_response_for_collection( $data );
-        }
-
-        $response = rest_ensure_response( $response );
+        if ( ! $is_head_request ) {
+            $response = array();
+            foreach ( $query_result as $term ) {
+                $data       = $this->prepare_item_for_response( $term, $request );
+                $response[] = $this->prepare_response_for_collection( $data );
+            }
+        }
+
+        $response = $is_head_request ? new WP_REST_Response() : rest_ensure_response( $response );
 
         // Store pagination values for headers.
@@ -887 +896 @@
      */
     public function prepare_item_for_response( $item, $request ) {
+
+        // 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-terms-controller.php */
+            return apply_filters( "rest_prepare_{$this->taxonomy}", new WP_REST_Response(), $item, $request );
+        }
 
         $fields = $this->get_fields_for_response( $request );