Status: add new class used to classify requests on a site. (#43843)

jeherve · matticbot · commit 8551ad83d2c4 · 2025-06-10T10:02:00.000Z
* Status: bring over jetpack_is_frontend This function currently lives in the Jetpack plugin only, but would be needed outside of the Jetpack plugin (for example for #43413). * Move file to correct location and switch to using Constants * Add extra tests * Update docblock Co-authored-by: Brad Jorsch <anomiex@users.noreply.github.com> * Update version reference See Automattic/jetpack#43843 (comment) Co-authored-by: Brad Jorsch <anomiex@users.noreply.github.com> * Simplify test output see Automattic/jetpack#43843 (comment) --------- Co-authored-by: Brad Jorsch <anomiex@users.noreply.github.com> Committed via a GitHub action: https://github.com/Automattic/jetpack/actions/runs/15556168880 Upstream-Ref: Automattic/jetpack@aa5f7e8
diff --git a/composer.json b/composer.json
@@ -11,7 +11,7 @@
 		"automattic/jetpack-my-jetpack": "^5.16.1",
 		"automattic/jetpack-search": "^0.52.0",
 		"automattic/jetpack-stats": "^0.16.2",
-		"automattic/jetpack-status": "^5.1.4",
+		"automattic/jetpack-status": "^5.2.0-alpha",
 		"automattic/jetpack-sync": "^4.14.1"
 	},
 	"require-dev": {
diff --git a/jetpack_vendor/automattic/jetpack-assets/composer.json b/jetpack_vendor/automattic/jetpack-assets/composer.json
@@ -6,7 +6,7 @@
 	"require": {
 		"php": ">=7.2",
 		"automattic/jetpack-constants": "^3.0.8",
-		"automattic/jetpack-status": "^5.1.4"
+		"automattic/jetpack-status": "^5.2.0-alpha"
 	},
 	"require-dev": {
 		"brain/monkey": "^2.6.2",
diff --git a/jetpack_vendor/automattic/jetpack-connection/composer.json b/jetpack_vendor/automattic/jetpack-connection/composer.json
@@ -10,7 +10,7 @@
 		"automattic/jetpack-assets": "^4.0.25",
 		"automattic/jetpack-constants": "^3.0.8",
 		"automattic/jetpack-roles": "^3.0.8",
-		"automattic/jetpack-status": "^5.1.4",
+		"automattic/jetpack-status": "^5.2.0-alpha",
 		"automattic/jetpack-redirect": "^3.0.7"
 	},
 	"require-dev": {
diff --git a/jetpack_vendor/automattic/jetpack-jitm/composer.json b/jetpack_vendor/automattic/jetpack-jitm/composer.json
@@ -11,7 +11,7 @@
 		"automattic/jetpack-device-detection": "^3.0.8",
 		"automattic/jetpack-logo": "^3.0.5",
 		"automattic/jetpack-redirect": "^3.0.7",
-		"automattic/jetpack-status": "^5.1.4"
+		"automattic/jetpack-status": "^5.2.0-alpha"
 	},
 	"require-dev": {
 		"brain/monkey": "^2.6.2",
diff --git a/jetpack_vendor/automattic/jetpack-my-jetpack/composer.json b/jetpack_vendor/automattic/jetpack-my-jetpack/composer.json
@@ -16,7 +16,7 @@
 		"automattic/jetpack-redirect": "^3.0.7",
 		"automattic/jetpack-constants": "^3.0.8",
 		"automattic/jetpack-plans": "^0.8.0",
-		"automattic/jetpack-status": "^5.1.4",
+		"automattic/jetpack-status": "^5.2.0-alpha",
 		"automattic/jetpack-sync": "^4.14.1",
 		"automattic/jetpack-protect-status": "^0.6.0"
 	},
diff --git a/jetpack_vendor/automattic/jetpack-plugins-installer/composer.json b/jetpack_vendor/automattic/jetpack-plugins-installer/composer.json
@@ -6,7 +6,7 @@
 	"require": {
 		"php": ">=7.2",
 		"automattic/jetpack-a8c-mc-stats": "^3.0.5",
-		"automattic/jetpack-status": "^5.1.4"
+		"automattic/jetpack-status": "^5.2.0-alpha"
 	},
 	"require-dev": {
 		"yoast/phpunit-polyfills": "^4.0.0",
diff --git a/jetpack_vendor/automattic/jetpack-redirect/composer.json b/jetpack_vendor/automattic/jetpack-redirect/composer.json
@@ -5,7 +5,7 @@
 	"license": "GPL-2.0-or-later",
 	"require": {
 		"php": ">=7.2",
-		"automattic/jetpack-status": "^5.1.4"
+		"automattic/jetpack-status": "^5.2.0-alpha"
 	},
 	"require-dev": {
 		"brain/monkey": "^2.6.2",
diff --git a/jetpack_vendor/automattic/jetpack-search/composer.json b/jetpack_vendor/automattic/jetpack-search/composer.json
@@ -8,7 +8,7 @@
 		"automattic/jetpack-connection": "^6.13.2",
 		"automattic/jetpack-assets": "^4.0.25",
 		"automattic/jetpack-constants": "^3.0.8",
-		"automattic/jetpack-status": "^5.1.4",
+		"automattic/jetpack-status": "^5.2.0-alpha",
 		"automattic/jetpack-config": "^3.1.0",
 		"automattic/jetpack-my-jetpack": "^5.16.1",
 		"automattic/jetpack-sync": "^4.14.1"
diff --git a/jetpack_vendor/automattic/jetpack-stats/composer.json b/jetpack_vendor/automattic/jetpack-stats/composer.json
@@ -7,7 +7,7 @@
 		"php": ">=7.2",
 		"automattic/jetpack-connection": "^6.13.2",
 		"automattic/jetpack-constants": "^3.0.8",
-		"automattic/jetpack-status": "^5.1.4"
+		"automattic/jetpack-status": "^5.2.0-alpha"
 	},
 	"require-dev": {
 		"yoast/phpunit-polyfills": "^4.0.0",
diff --git a/jetpack_vendor/automattic/jetpack-status/CHANGELOG.md b/jetpack_vendor/automattic/jetpack-status/CHANGELOG.md
@@ -5,6 +5,13 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [5.2.0-alpha] - unreleased
+
+This is an alpha version! The changes listed here are not final.
+
+### Added
+- Request: add new class used to classify requests on a site.
+
 ## [5.1.4] - 2025-04-28
 ### Changed
 - Internal updates.
@@ -469,6 +476,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Packages: Introduce a status package
 
+[5.2.0-alpha]: https://github.com/Automattic/jetpack-status/compare/v5.1.4...v5.2.0-alpha
 [5.1.4]: https://github.com/Automattic/jetpack-status/compare/v5.1.3...v5.1.4
 [5.1.3]: https://github.com/Automattic/jetpack-status/compare/v5.1.2...v5.1.3
 [5.1.2]: https://github.com/Automattic/jetpack-status/compare/v5.1.1...v5.1.2
diff --git a/jetpack_vendor/automattic/jetpack-status/composer.json b/jetpack_vendor/automattic/jetpack-status/composer.json
@@ -44,7 +44,7 @@
 			"link-template": "https://github.com/Automattic/jetpack-status/compare/v${old}...v${new}"
 		},
 		"branch-alias": {
-			"dev-trunk": "5.1.x-dev"
+			"dev-trunk": "5.2.x-dev"
 		},
 		"dependencies": {
 			"test-only": [
diff --git a/jetpack_vendor/automattic/jetpack-status/src/class-request.php b/jetpack_vendor/automattic/jetpack-status/src/class-request.php
@@ -0,0 +1,105 @@
+<?php
+/**
+ * Get information about the current request.
+ *
+ * @package automattic/jetpack-status
+ */
+
+namespace Automattic\Jetpack\Status;
+
+use Automattic\Jetpack\Constants;
+
+/**
+ * Get information about the current request.
+ */
+class Request {
+	/**
+	 * Determine whether the current request is for accessing the frontend.
+	 * Also update Vary headers to indicate that the response may vary by Accept header.
+	 *
+	 * @return bool True if it's a frontend request, false otherwise.
+	 */
+	public static function is_frontend() {
+		$is_frontend        = true;
+		$is_varying_request = true;
+
+		if (
+			is_admin()
+			|| wp_doing_ajax()
+			|| wp_is_jsonp_request()
+			|| is_feed()
+			|| Constants::is_true( 'REST_REQUEST' )
+			|| Constants::is_true( 'REST_API_REQUEST' )
+			|| Constants::is_true( 'WP_CLI' )
+		) {
+			$is_frontend        = false;
+			$is_varying_request = false;
+		} elseif (
+			wp_is_json_request()
+			|| wp_is_xml_request()
+		) {
+			$is_frontend = false;
+		}
+
+		/*
+		* Check existing headers for the request.
+		* If there is no existing Vary Accept header, add one.
+		*/
+		if ( $is_varying_request && ! headers_sent() ) {
+			$headers           = headers_list();
+			$vary_header_parts = self::get_vary_headers( $headers );
+
+			header( 'Vary: ' . implode( ', ', $vary_header_parts ) );
+		}
+
+		/**
+		 * Filter whether the current request is for accessing the frontend.
+		 *
+		 * @since jetpack-9.0.0
+		 *
+		 * @param bool $is_frontend Whether the current request is for accessing the frontend.
+		 */
+		return (bool) apply_filters( 'jetpack_is_frontend', $is_frontend );
+	}
+
+	/**
+	 * Go through headers and get a list of Vary headers to add,
+	 * including Vary on Accept and Content-Type if necessary.
+	 *
+	 * @since jetpack-12.2
+	 *
+	 * @param array $headers The headers to be sent.
+	 *
+	 * @return array $vary_header_parts Vary Headers to be sent.
+	 */
+	public static function get_vary_headers( $headers = array() ) {
+		$vary_header_parts = array( 'accept', 'content-type' );
+
+		foreach ( $headers as $header ) {
+			// Check for a Vary header.
+			if ( ! str_starts_with( strtolower( $header ), 'vary:' ) ) {
+				continue;
+			}
+
+			// If the header is a wildcard, we'll return that.
+			if ( str_contains( $header, '*' ) ) {
+				$vary_header_parts = array( '*' );
+				break;
+			}
+
+			// Remove the Vary: part of the header.
+			$header = preg_replace( '/^vary\:\s?/i', '', $header );
+
+			// Remove spaces from the header.
+			$header = str_replace( ' ', '', $header );
+
+			// Break the header into parts.
+			$header_parts = explode( ',', strtolower( $header ) );
+
+			// Build an array with the Accept header and what was already there.
+			$vary_header_parts = array_values( array_unique( array_merge( $vary_header_parts, $header_parts ) ) );
+		}
+
+		return $vary_header_parts;
+	}
+}
diff --git a/jetpack_vendor/automattic/jetpack-sync/composer.json b/jetpack_vendor/automattic/jetpack-sync/composer.json
@@ -10,7 +10,7 @@
 		"automattic/jetpack-password-checker": "^0.4.8",
 		"automattic/jetpack-ip": "^0.4.9",
 		"automattic/jetpack-roles": "^3.0.8",
-		"automattic/jetpack-status": "^5.1.4"
+		"automattic/jetpack-status": "^5.2.0-alpha"
 	},
 	"require-dev": {
 		"automattic/jetpack-changelogger": "^6.0.5",
diff --git a/vendor/automattic/jetpack-plans/composer.json b/vendor/automattic/jetpack-plans/composer.json
@@ -10,7 +10,7 @@
 	"require-dev": {
 		"yoast/phpunit-polyfills": "^4.0.0",
 		"automattic/jetpack-changelogger": "^6.0.5",
-		"automattic/jetpack-status": "^5.1.4",
+		"automattic/jetpack-status": "^5.2.0-alpha",
 		"automattic/jetpack-test-environment": "@dev",
 		"automattic/phpunit-select-config": "^1.0.3"
 	},
diff --git a/vendor/composer/autoload_classmap.php b/vendor/composer/autoload_classmap.php
@@ -180,6 +180,7 @@
     'Automattic\\Jetpack\\Status' => $baseDir . '/jetpack_vendor/automattic/jetpack-status/src/class-status.php',
     'Automattic\\Jetpack\\Status\\Cache' => $baseDir . '/jetpack_vendor/automattic/jetpack-status/src/class-cache.php',
     'Automattic\\Jetpack\\Status\\Host' => $baseDir . '/jetpack_vendor/automattic/jetpack-status/src/class-host.php',
+    'Automattic\\Jetpack\\Status\\Request' => $baseDir . '/jetpack_vendor/automattic/jetpack-status/src/class-request.php',
     'Automattic\\Jetpack\\Status\\Visitor' => $baseDir . '/jetpack_vendor/automattic/jetpack-status/src/class-visitor.php',
     'Automattic\\Jetpack\\Sync\\Actions' => $baseDir . '/jetpack_vendor/automattic/jetpack-sync/src/class-actions.php',
     'Automattic\\Jetpack\\Sync\\Codec_Interface' => $baseDir . '/jetpack_vendor/automattic/jetpack-sync/src/interface-codec.php',
diff --git a/vendor/composer/autoload_static.php b/vendor/composer/autoload_static.php
@@ -200,6 +200,7 @@ class ComposerStaticInitb462338fb66be23595d68a93345c9e3d_jetpack_searchⓥ5_0_0_
         'Automattic\\Jetpack\\Status' => __DIR__ . '/../..' . '/jetpack_vendor/automattic/jetpack-status/src/class-status.php',
         'Automattic\\Jetpack\\Status\\Cache' => __DIR__ . '/../..' . '/jetpack_vendor/automattic/jetpack-status/src/class-cache.php',
         'Automattic\\Jetpack\\Status\\Host' => __DIR__ . '/../..' . '/jetpack_vendor/automattic/jetpack-status/src/class-host.php',
+        'Automattic\\Jetpack\\Status\\Request' => __DIR__ . '/../..' . '/jetpack_vendor/automattic/jetpack-status/src/class-request.php',
         'Automattic\\Jetpack\\Status\\Visitor' => __DIR__ . '/../..' . '/jetpack_vendor/automattic/jetpack-status/src/class-visitor.php',
         'Automattic\\Jetpack\\Sync\\Actions' => __DIR__ . '/../..' . '/jetpack_vendor/automattic/jetpack-sync/src/class-actions.php',
         'Automattic\\Jetpack\\Sync\\Codec_Interface' => __DIR__ . '/../..' . '/jetpack_vendor/automattic/jetpack-sync/src/interface-codec.php',
diff --git a/vendor/composer/installed.json b/vendor/composer/installed.json
diff --git a/vendor/composer/installed.php b/vendor/composer/installed.php
diff --git a/vendor/composer/jetpack_autoload_classmap.php b/vendor/composer/jetpack_autoload_classmap.php
