JezK

Edit File: core.cls.php

<?php
/**
 * The core plugin class.
 *
 * This is the main class for the LiteSpeed Cache plugin, responsible for initializing
 * the plugin's core functionality, registering hooks, and handling cache-related operations.
 *
 * Note: Core doesn't allow $this->cls( 'Core' )
 *
 * @since 1.0.0
 * @package LiteSpeed
 */

namespace LiteSpeed;

defined( 'WPINC' ) || exit();

/**
 * Class Core
 *
 * @since 1.0.0
 */
class Core extends Root {

const NAME        = 'LiteSpeed Cache';
	const PLUGIN_NAME = 'litespeed-cache';
	const PLUGIN_FILE = 'litespeed-cache/litespeed-cache.php';
	const VER         = LSCWP_V;

const ACTION_DISMISS             = 'dismiss';
	const ACTION_PURGE_BY            = 'PURGE_BY';
	const ACTION_PURGE_EMPTYCACHE    = 'PURGE_EMPTYCACHE';
	const ACTION_QS_PURGE            = 'PURGE';
	const ACTION_QS_PURGE_SINGLE     = 'PURGESINGLE'; // This will be same as `ACTION_QS_PURGE` (purge single URL only)
	const ACTION_QS_SHOW_HEADERS     = 'SHOWHEADERS';
	const ACTION_QS_PURGE_ALL        = 'purge_all';
	const ACTION_QS_PURGE_EMPTYCACHE = 'empty_all';
	const ACTION_QS_NOCACHE          = 'NOCACHE';

const HEADER_DEBUG = 'X-LiteSpeed-Debug';

/**
	 * Whether to show debug headers.
	 *
	 * @var bool
	 * @since 1.0.0
	 */
	protected static $debug_show_header = false;

/**
	 * Footer comment buffer.
	 *
	 * @var string
	 * @since 1.0.0
	 */
	private $footer_comment = '';

/**
	 * Whether the registry has been loaded and its integrations detected in this request.
	 *
	 * @var bool
	 */
	private static $_thirdparty_loaded = false;

/**
	 * Define the core functionality of the plugin.
	 *
	 * Set the plugin name and the plugin version that can be used throughout the plugin.
	 * Load the dependencies, define the locale, and set the hooks for the admin area and
	 * the public-facing side of the site.
	 *
	 * @since 1.0.0
	 */
	public function __construct() {
		! defined( 'LSCWP_TS_0' ) && define( 'LSCWP_TS_0', microtime( true ) );
		$this->cls( 'Conf' )->init();

/**
		 * Load API hooks
		 *
		 * @since 3.0
		 */
		$this->cls( 'API' )->init();

if ( defined( 'LITESPEED_ON' ) ) {
			// Load third party detection if lscache enabled.
			include_once LSCWP_DIR . 'thirdparty/entry.inc.php';
		}

if ( $this->conf( Base::O_DEBUG_DISABLE_ALL ) || Debug2::is_tmp_disable() ) {
			! defined( 'LITESPEED_DISABLE_ALL' ) && define( 'LITESPEED_DISABLE_ALL', true );
		}

/**
		 * Register plugin activate/deactivate/uninstall hooks
		 * NOTE: this can't be moved under after_setup_theme, otherwise activation will be bypassed
		 *
		 * @since 2.7.1 Disabled admin&CLI check to make frontend able to enable cache too
		 */
		$plugin_file = LSCWP_DIR . 'litespeed-cache.php';
		register_activation_hook( $plugin_file, [ __NAMESPACE__ . '\Activation', 'register_activation' ] );
		register_deactivation_hook( $plugin_file, [ __NAMESPACE__ . '\Activation', 'register_deactivation' ] );
		register_uninstall_hook( $plugin_file, __NAMESPACE__ . '\Activation::uninstall_litespeed_cache' );

if ( defined( 'LITESPEED_ON' ) ) {
			// Register purge_all actions
			$purge_all_events = $this->conf( Base::O_PURGE_HOOK_ALL );

// Purge all on upgrade
			if ( $this->conf( Base::O_PURGE_ON_UPGRADE ) ) {
				$purge_all_events[] = 'automatic_updates_complete';
				$purge_all_events[] = 'upgrader_process_complete';
				$purge_all_events[] = 'admin_action_do-plugin-upgrade';
			}
			foreach ( $purge_all_events as $event ) {
				// Don't allow hook to update_option because purge_all will cause infinite loop of update_option
				if ( in_array( $event, [ 'update_option' ], true ) ) {
					continue;
				}
				add_action( $event, __NAMESPACE__ . '\Purge::purge_all' );
			}

// Add headers to site health check for full page cache
			// @since 5.4
			add_filter( 'site_status_page_cache_supported_cache_headers', function ( $cache_headers ) {
				$is_cache_hit                       = function ( $header_value ) {
					return false !== strpos( strtolower( $header_value ), 'hit' );
				};
				$cache_headers['x-litespeed-cache'] = $is_cache_hit;
				$cache_headers['x-lsadc-cache']     = $is_cache_hit;
				$cache_headers['x-qc-cache']        = $is_cache_hit;
				return $cache_headers;
			} );
		}

add_action( 'after_setup_theme', [ $this, 'init' ] );

// Check if there is a purge request in queue
		if ( ! defined( 'LITESPEED_CLI' ) ) {
			$purge_queue = Purge::get_option( Purge::DB_QUEUE );
			if ( $purge_queue && '-1' !== $purge_queue ) {
				$this->http_header( $purge_queue );
				Debug2::debug( '[Core] Purge Queue found&sent: ' . $purge_queue );
			}
			if ( '-1' !== $purge_queue ) {
				Purge::update_option( Purge::DB_QUEUE, '-1' ); // Use -1 to bypass purge while still enable db update as WP's update_option will check value===false to bypass update
			}

$purge_queue = Purge::get_option( Purge::DB_QUEUE2 );
			if ( $purge_queue && '-1' !== $purge_queue ) {
				$this->http_header( $purge_queue );
				Debug2::debug( '[Core] Purge2 Queue found&sent: ' . $purge_queue );
			}
			// When Conf::init() upgrades synchronously (Core built after wp_loaded, e.g. activation), keep the queued row for a later request.
			if ( '-1' !== $purge_queue && ! ( defined( 'LSCWP_UPGRADE_PURGE_QUEUED' ) && Purge::UPGRADE_PURGE_HEADER === $purge_queue ) ) {
				Purge::update_option( Purge::DB_QUEUE2, '-1' );
			}
		}

/**
		 * Hook internal REST
		 *
		 * @since 2.9.4
		 */
		$this->cls( 'REST' );

/**
		 * Hook wpnonce function
		 *
		 * Note: ESI nonce won't be available until hook after_setup_theme ESI init due to Guest Mode concern
		 *
		 * @since 4.1
		 */
		if ( $this->cls( 'Router' )->esi_enabled() && ! function_exists( 'wp_create_nonce' ) ) {
			Debug2::debug( '[ESI] Overwrite wp_create_nonce()' );
			litespeed_define_nonce_func();
		}
	}

/**
	 * The plugin initializer.
	 *
	 * This function checks if the cache is enabled and ready to use, then determines what actions need to be set up based on the type of user and page accessed. Output is buffered if the cache is enabled.
	 *
	 * NOTE: WP user doesn't init yet
	 *
	 * @since 1.0.0
	 */
	public function init() {
		/**
		 * Added hook before init
		 * 3rd party preload hooks will be fired here too (e.g. Divi disable all in edit mode)
		 *
		 * @since 1.6.6
		 * @since 2.6 Added filter to all config values in Conf
		 */
		do_action( 'litespeed_init' );
		add_action( 'wp_ajax_async_litespeed', 'LiteSpeed\Task::async_litespeed_handler' );
		add_action( 'wp_ajax_nopriv_async_litespeed', 'LiteSpeed\Task::async_litespeed_handler' );

// In `after_setup_theme`, before `init` hook
		$this->cls( 'Activation' )->auto_update();

if ( is_admin() && ! wp_doing_ajax() ) {
			$this->cls( 'Admin' );
		}

if ( defined( 'LITESPEED_DISABLE_ALL' ) && LITESPEED_DISABLE_ALL ) {
			Debug2::debug( '[Core] Bypassed due to debug disable all setting' );
			return;
		}

do_action( 'litespeed_initing' );

ob_start( [ $this, 'send_headers_force' ] );
		add_filter( 'litespeed_buffer_after', [ $this, 'drop_query_strings' ], 99 );
		add_action( 'shutdown', [ $this, 'send_headers' ], 0 );
		add_action( 'wp_footer', [ $this, 'footer_hook' ] );

/**
		 * Check if is non-optimization simulator
		 *
		 * @since 2.9
		 */
		// phpcs:ignore WordPress.Security.NonceVerification.Recommended
		if ( ! empty( $_GET[ Router::ACTION ] ) && 'before_optm' === $_GET[ Router::ACTION ] && ! apply_filters( 'litespeed_qs_forbidden', false ) ) {
			Debug2::debug( '[Core] ⛑️ bypass_optm due to QS CTRL' );
			! defined( 'LITESPEED_NO_OPTM' ) && define( 'LITESPEED_NO_OPTM', true );
		}

/**
		 * Register vary filter
		 *
		 * @since 1.6.2
		 */
		$this->cls( 'Control' )->init();

// Init Purge hooks
		$this->cls( 'Purge' )->init();

$this->cls( 'Tag' )->init();

// Load hooks that may be related to users
		add_action( 'init', [ $this, 'after_user_init' ], 5 );

// Load 3rd party hooks
		if ( defined( 'LITESPEED_ON' ) ) {
			add_action( 'wp_loaded', [ $this, 'load_thirdparty' ], 2 );
		}
	}

/**
	 * Run hooks after user init
	 *
	 * @since 2.9.8
	 */
	public function after_user_init() {
		$this->cls( 'Router' )->is_role_simulation();
		// Excluded roles bypass Optimize::init(), but still need a separate page-cache identity.
		add_filter( 'litespeed_vary', [ $this, 'vary_add_role_exclude' ] );

// Detect if is Guest mode or not
		$this->cls( 'Vary' )->after_user_init();

// Register attachment delete hook
		$this->cls( 'Media' )->after_user_init();

/**
		 * Preload ESI functionality for ESI request URI recovery
		 *
		 * @since 1.8.1
		 * @since 4.0 ESI init needs to be after Guest mode detection to bypass ESI if is under Guest mode
		 */
		$this->cls( 'ESI' )->init();

if ( ! is_admin() && ! defined( 'LITESPEED_GUEST_OPTM' ) ) {
			$result = $this->cls( 'Conf' )->in_optm_exc_roles();
			if ( $result ) {
				Debug2::debug( '[Core] ⛑️ bypass_optm: hit Role Excludes setting: ' . $result );
				! defined( 'LITESPEED_NO_OPTM' ) && define( 'LITESPEED_NO_OPTM', true );
			}
		}

// Heartbeat control
		$this->cls( 'Tool' )->heartbeat();

if ( ! defined( 'LITESPEED_NO_OPTM' ) || ! LITESPEED_NO_OPTM ) {
			// Check missing static files
			$this->cls( 'Router' )->serve_static();

$this->cls( 'Media' )->init();

$this->cls( 'Placeholder' )->init();

$this->cls( 'Router' )->can_optm() && $this->cls( 'Optimize' )->init();

$this->cls( 'Localization' )->init();

// Hook CDN for attachments
			$this->cls( 'CDN' )->init();

// Load cron tasks
			$this->cls( 'Task' )->init();
		}

// Load litespeed actions
		$action = Router::get_action();
		if ( $action ) {
			$this->proceed_action( $action );
		}

// Load frontend GUI
		if ( ! is_admin() ) {
			$this->cls( 'GUI' )->init();
		}
	}

/**
	 * Partition optimized and role-excluded page responses even when optimization is bypassed.
	 *
	 * @param array $vary Current vary components.
	 * @return array
	 */
	public function vary_add_role_exclude( $vary ) {
		if ( $this->cls( 'Conf' )->in_optm_exc_roles() ) {
			$vary['role_exclude_optm'] = 1;
		}
		return $vary;
	}

/**
	 * Run frontend actions
	 *
	 * @since 1.1.0
	 * @param string $action The action to proceed.
	 */
	public function proceed_action( $action ) {
		$msg = false;
		// Handle actions
		switch ( $action ) {
			case self::ACTION_QS_SHOW_HEADERS:
				self::$debug_show_header = true;
				break;

case self::ACTION_QS_PURGE:
			case self::ACTION_QS_PURGE_SINGLE:
				Purge::set_purge_single();
				break;

case self::ACTION_QS_PURGE_ALL:
				Purge::purge_all();
				break;

case self::ACTION_PURGE_EMPTYCACHE:
			case self::ACTION_QS_PURGE_EMPTYCACHE:
				define( 'LSWCP_EMPTYCACHE', true ); // Clear all sites caches
				Purge::purge_all();
				$msg = __( 'Notified LiteSpeed Web Server to purge everything.', 'litespeed-cache' );
				break;

case self::ACTION_PURGE_BY:
				$this->cls( 'Purge' )->purge_list();
				$msg = __( 'Notified LiteSpeed Web Server to purge the list.', 'litespeed-cache' );
				break;

case self::ACTION_DISMISS:
				GUI::dismiss();
				break;

default:
				$msg = $this->cls( 'Router' )->handler( $action );
				break;
		}
		if ( $msg && ! Router::is_ajax() && ! defined( 'LITESPEED_CLI' ) ) {
			Admin_Display::add_notice( Admin_Display::NOTICE_GREEN, $msg );
			Admin::redirect();
			return;
		}

if ( Router::is_ajax() ) {
			exit();
		}
	}

/**
	 * Callback used to call the detect third party action.
	 *
	 * The detect action is used by third party plugin integration classes to determine if they should add the rest of their hooks.
	 *
	 * @since 1.0.5
	 */
	public static function load_thirdparty() {
		if ( self::$_thirdparty_loaded ) {
			return;
		}
		// Activation or OFF-to-ON saves can run after wp_loaded without the normal cache-enabled bootstrap.
		include_once LSCWP_DIR . 'thirdparty/entry.inc.php';
		do_action( 'litespeed_load_thirdparty' );
		self::$_thirdparty_loaded = true;
	}

/**
	 * Mark wp_footer called
	 *
	 * @since 1.3
	 */
	public function footer_hook() {
		Debug2::debug( '[Core] Footer hook called' );
		if ( ! defined( 'LITESPEED_FOOTER_CALLED' ) ) {
			define( 'LITESPEED_FOOTER_CALLED', true );
		}
	}

/**
	 * Trigger comment info display hook
	 *
	 * @since 1.3
	 * @param string|null $buffer The buffer to check.
	 * @return void
	 */
	private function check_is_html( $buffer = null ) {
		if ( ! defined( 'LITESPEED_FOOTER_CALLED' ) ) {
			Debug2::debug2( '[Core] CHK html bypass: miss footer const' );
			return;
		}

if ( wp_doing_ajax() ) {
			Debug2::debug2( '[Core] CHK html bypass: doing ajax' );
			return;
		}

if ( wp_doing_cron() ) {
			Debug2::debug2( '[Core] CHK html bypass: doing cron' );
			return;
		}

if ( empty( $_SERVER['REQUEST_METHOD'] ) || 'GET' !== $_SERVER['REQUEST_METHOD'] ) {
			// phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized
			Debug2::debug2( '[Core] CHK html bypass: not get method ' . wp_unslash( $_SERVER['REQUEST_METHOD'] ) );
			return;
		}

if ( null === $buffer ) {
			$buffer = ob_get_contents();
		}

// Double check to make sure it is an HTML file
		if ( strlen( $buffer ) > 300 ) {
			$buffer = substr( $buffer, 0, 300 );
		}
		if ( false !== strstr( $buffer, '/s', '', $buffer );
		}
		$buffer = trim( $buffer );

$buffer = File::remove_zero_space( $buffer );
		// Ignore only document-leading format characters; preserve them in CSS, JS and body content.
		$buffer = preg_replace( '/\A(?:\s|\xE2\x80[\x8B-\x8D])+/', '', $buffer );

$is_html = 0 === stripos( $buffer, '<html' ) || 0 === stripos( $buffer, '<!DOCTYPE' );

if ( ! $is_html ) {
			Debug2::debug( '[Core] Footer check failed: ' . ob_get_level() . '-' . substr( $buffer, 0, 100 ) );
			return;
		}

Debug2::debug( '[Core] Footer check passed' );

if ( ! defined( 'LITESPEED_IS_HTML' ) ) {
			define( 'LITESPEED_IS_HTML', true );
		}
	}

/**
	 * For compatibility with plugins that have 'Bad' logic that forced all buffer output even if it is NOT their buffer.
	 *
	 * Usually this is called after send_headers() if following original WP process
	 *
	 * @since 1.1.5
	 * @param string $buffer The buffer to process.
	 * @return string The processed buffer.
	 */
	public function send_headers_force( $buffer ) {
		$this->check_is_html( $buffer );

// Hook to modify buffer before
		$buffer = apply_filters( 'litespeed_buffer_before', $buffer );

/**
		 * ESI: clean wrappers MUST run before any optimizer hook (HTML minifier strips HTML comments and would erase the wrapper markers themselves). Runs unconditionally so NO_OPTM requests with ESI blocks still produce a clean buffer.
		 */
		$buffer = $this->cls( 'ESI' )->finalize_clean_wrapper( $buffer );

/**
		 * Media: Image lazyload && WebP
		 * Optimize
		 * CDN
		 */
		if ( ! defined( 'LITESPEED_NO_OPTM' ) || ! LITESPEED_NO_OPTM ) {
			// Optimax: first priority check — skip all hooks if ox HTML is cached. Checked here: building Optimax reads its summary option.
			$ox_html = $this->conf( Base::O_OPTIMAX ) ? $this->cls( 'Optimax' )->serve() : false;
			if ( false !== $ox_html ) {
				Debug2::debug( '[Core] Optimax served, skip litespeed_buffer_finalize' );
				define( 'LITESPEED_OX_SERVED', true );
				$buffer = $ox_html;
			} else {
				Debug2::debug( '[Core] run hook litespeed_buffer_finalize' );
				$buffer = apply_filters( 'litespeed_buffer_finalize', $buffer );
			}
		}

/**
		 * Replace ESI preserved list
		 *
		 * @since 3.3 Replace this in the end to avoid `Inline JS Defer` or other Page Optm features encoded ESI tags wrongly, which caused LSWS can't recognize ESI
		 */
		$buffer = $this->cls( 'ESI' )->finalize( $buffer );

$this->send_headers( true );

// Log ESI nonce buffer empty issue
		if ( defined( 'LSCACHE_IS_ESI' ) && 0 === strlen( $buffer ) && ! empty( $_SERVER['REQUEST_URI'] ) ) {
			// Log ref for debug purpose
			// phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized, WordPress.PHP.DevelopmentFunctions.error_log_error_log
			error_log( 'ESI buffer empty ' . wp_unslash( $_SERVER['REQUEST_URI'] ) );
		}

// Init comment info
		$running_info_showing = defined( 'LITESPEED_IS_HTML' ) || defined( 'LSCACHE_IS_ESI' );
		if ( defined( 'LSCACHE_ESI_SILENCE' ) ) {
			$running_info_showing = false;
			Debug2::debug( '[Core] ESI silence' );
		}
		/**
		 * Silence comment for JSON request
		 *
		 * @since 2.9.3
		 */
		if ( REST::cls()->is_rest() || Router::is_ajax() ) {
			$running_info_showing = false;
			Debug2::debug( '[Core] Silence Comment due to REST/AJAX' );
		}
		$running_info_showing = apply_filters( 'litespeed_comment', $running_info_showing );
		if ( $running_info_showing && $this->footer_comment ) {
			$buffer .= $this->footer_comment;
		}

/**
		 * If ESI request is JSON, give the content JSON format
		 *
		 * @since 2.9.3
		 * @since 2.9.4 ESI request could be from internal REST call, so moved json_encode out of this condition
		 */
		if ( defined( 'LSCACHE_IS_ESI' ) ) {
			Debug2::debug( '[Core] ESI Start 👇' );
			if ( strlen( $buffer ) > 500 ) {
				Debug2::debug( trim( substr( $buffer, 0, 500 ) ) . '.....' );
			} else {
				Debug2::debug( $buffer );
			}
			Debug2::debug( '[Core] ESI End 👆' );
		}

if ( apply_filters( 'litespeed_is_json', false ) ) {
			if ( null === \json_decode( $buffer, true ) ) {
				Debug2::debug( '[Core] Buffer converting to JSON' );
				$buffer = wp_json_encode( $buffer );
				$buffer = trim( $buffer, '"' );
			} else {
				Debug2::debug( '[Core] JSON Buffer' );
			}
		}

// Hook to modify buffer after
		$buffer = apply_filters( 'litespeed_buffer_after', $buffer );

Debug2::ended();

return $buffer;
	}

/**
	 * Remove ignored query arguments from quoted current-page URLs in cacheable output.
	 * Request input and other URLs are preserved.
	 *
	 * @since 7.9.2
	 * @param string $buffer Final response body.
	 * @return string
	 */
	public function drop_query_strings( $buffer ) {
		if ( ! defined( 'LITESPEED_ON' ) || ! Control::is_cacheable() || empty( $_SERVER['REQUEST_URI'] ) ||
			// phpcs:ignore WordPress.NamingConventions.ValidHookName.NotLowercase -- Existing public hook.
			( defined( 'DONOTCACHEPAGE' ) && apply_filters( 'litespeed_const_DONOTCACHEPAGE', DONOTCACHEPAGE ) ) ) {
			return $buffer;
		}
		// phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- Raw URL comparison; only removes arguments.
		$request_uri = wp_unslash( $_SERVER['REQUEST_URI'] );
		$uri         = explode( '?', $request_uri, 2 );
		if ( ! isset( $uri[1] ) || '' === $uri[1] ) {
			return $buffer;
		}
		// Use the same option values as the cache-key rules.
		$options  = $this->get_options();
		$patterns = [];
		foreach ( (array) $options[ Base::O_CACHE_DROP_QS ] as $rule ) {
			if ( ! is_string( $rule ) ) {
				continue;
			}
			$rule = trim( $rule );
			if ( '' === $rule ) {
				continue;
			}
			// CacheKeyModify uses case-sensitive names and a trailing '*' prefix.
			$prefix     = '*' === substr( $rule, -1 );
			$patterns[] = preg_quote( $prefix ? substr( $rule, 0, -1 ) : $rule, '/' ) . ( $prefix ? '' : '(?:=|&|\z)' );
		}
		if ( ! $patterns ) {
			return $buffer;
		}
		$pattern = '/\A(?:' . implode( '|', $patterns ) . ')/';
		$parts   = preg_split( '/(?<=&)/', $uri[1], -1, PREG_SPLIT_NO_EMPTY );
		$kept    = [];
		foreach ( $parts as $part ) {
			if ( ! preg_match( $pattern, $part ) ) {
				$kept[] = $part;
			}
		}
		$query = implode( '', $kept );
		if ( $query === $uri[1] ) {
			return $buffer;
		}
		$query = '&' === substr( $query, -1 ) ? substr( $query, 0, -1 ) : $query;
		$map   = [];
		foreach ( [ get_self_link(), $request_uri ] as $source ) {
			$target = explode( '?', $source, 2 )[0] . ( '' !== $query ? '?' . $query : '' );
			foreach ( [ [ $source, $target ], [ esc_url( $source ), esc_url( $target ) ], [ esc_attr( $source ), esc_attr( $target ) ] ] as $urls ) {
				foreach ( [ '"', "'" ] as $quote ) {
					$map[ $quote . $urls[0] . $quote ] = $quote . $urls[1] . $quote;
				}
			}
		}
		return strtr( $buffer, $map );
	}

/**
	 * Sends the headers out at the end of processing the request.
	 *
	 * This will send out all LiteSpeed Cache related response headers needed for the post.
	 *
	 * @since 1.0.5
	 * @param bool $is_forced If the header is sent following our normal finalizing logic.
	 */
	public function send_headers( $is_forced = false ) {
		// Make sure header output only runs once
		if ( defined( 'LITESPEED_DID_' . __FUNCTION__ ) ) {
			return;
		}
		define( 'LITESPEED_DID_' . __FUNCTION__, true );

// Avoid PHP warning for headers sent out already
		if ( headers_sent() ) {
			self::debug( '❌ !!! Err: Header sent out already' );
			return;
		}

$this->check_is_html();

// Cache control output needs to be done first, as some varies are added in 3rd party hook `litespeed_api_control`.
		$this->cls( 'Control' )->finalize();

$vary_header = $this->cls( 'Vary' )->finalize();

// If not cacheable but Admin QS is `purge` or `purgesingle`, `tag` still needs to be generated
		$tag_header = $this->cls( 'Tag' )->output();
		if ( ! $tag_header && Control::is_cacheable() ) {
			Control::set_nocache( 'empty tag header' );
		}

// `Purge` output needs to be after `tag` output as Admin QS may need to send `tag` header
		$purge_header = Purge::output();

// Generate `control` header in the end in case control status is changed by other headers
		$control_header = $this->cls( 'Control' )->output();

// Give one more break to avoid Firefox crash
		if ( ! defined( 'LSCACHE_IS_ESI' ) ) {
			$this->footer_comment .= "\n";
		}

$cache_support = 'supported';
		if ( defined( 'LITESPEED_ON' ) ) {
			$cache_support = Control::is_cacheable() ? 'cached' : 'uncached';
		}

$this->comment(
			sprintf(
				'%1$s %2$s by LiteSpeed Cache %4$s on %3$s',
				defined( 'LSCACHE_IS_ESI' ) ? 'Block' : 'Page',
				$cache_support,
				gmdate( 'Y-m-d H:i:s', time() + LITESPEED_TIME_OFFSET ),
				self::VER
			)
		);

// Send Control header
		if ( defined( 'LITESPEED_ON' ) && $control_header ) {
			$this->http_header( $control_header );
			if ( ! Control::is_cacheable() && ! is_admin() && ! preg_grep( '/^Cache-Control:/i', headers_list() ) ) {
				$ori_wp_header = wp_get_nocache_headers();
				if ( isset( $ori_wp_header['Cache-Control'] ) ) {
					$this->http_header( 'Cache-Control: ' . $ori_wp_header['Cache-Control'] ); // @ref: https://github.com/litespeedtech/lscache_wp/issues/889
				}
			}
			if ( defined( 'LSCWP_LOG' ) ) {
				$this->comment( $control_header );
			}
		}

// Send PURGE header (Always send regardless of cache setting disabled/enabled)
		if ( defined( 'LITESPEED_ON' ) && $purge_header ) {
			$this->http_header( $purge_header );
			Debug2::log_purge( $purge_header );

if ( defined( 'LSCWP_LOG' ) ) {
				$this->comment( $purge_header );
			}
		}

// Send Vary header
		if ( defined( 'LITESPEED_ON' ) && $vary_header ) {
			$this->http_header( $vary_header );
			if ( defined( 'LSCWP_LOG' ) ) {
				$this->comment( $vary_header );
			}
		}

if ( defined( 'LITESPEED_ON' ) && defined( 'LSCWP_LOG' ) ) {
			$vary = $this->cls( 'Vary' )->finalize_full_varies();
			if ( $vary ) {
				$this->comment( 'Full varies: ' . $vary );
			}
		}

// Admin QS show header action
		if ( self::$debug_show_header ) {
			$debug_header = self::HEADER_DEBUG . ': ';
			if ( $control_header ) {
				$debug_header .= $control_header . '; ';
			}
			if ( $purge_header ) {
				$debug_header .= $purge_header . '; ';
			}
			if ( $tag_header ) {
				$debug_header .= $tag_header . '; ';
			}
			if ( $vary_header ) {
				$debug_header .= $vary_header . '; ';
			}
			$this->http_header( $debug_header );
		} elseif ( defined( 'LITESPEED_ON' ) && Control::is_cacheable() && $tag_header ) {
			$this->http_header( $tag_header );
			if ( defined( 'LSCWP_LOG' ) ) {
				$this->comment( $tag_header );
			}
		}

// Object cache comment
		if ( defined( 'LSCWP_LOG' ) && defined( 'LSCWP_OBJECT_CACHE' ) && method_exists( 'WP_Object_Cache', 'debug' ) ) {
			$this->comment( 'Object Cache ' . \WP_Object_Cache::get_instance()->debug() );
		}

if ( defined( 'LITESPEED_GUEST' ) && LITESPEED_GUEST ) {
			$this->comment( 'Guest Mode' );
		}

if ( ! empty( $this->footer_comment ) ) {
			self::debug( "[footer comment]\n" . trim( $this->footer_comment ) );
		}

if ( $is_forced ) {
			Debug2::debug( '--forced--' );
		}

// If CLI and contains Purge Header, issue an HTTP request to Purge
		if ( defined( 'LITESPEED_CLI' ) ) {
			self::kick_purge_queue();
		}
	}

/**
	 * Trigger the current blog's stored purge headers before a CLI caller leaves that blog.
	 *
	 * @return bool Whether the HTTP kick succeeded or there was no pending queue.
	 */
	public static function kick_purge_queue() {
		$purge_queue = Purge::get_option( Purge::DB_QUEUE );
		if ( ! $purge_queue || '-1' === $purge_queue ) {
			$purge_queue = Purge::get_option( Purge::DB_QUEUE2 );
		}
		if ( ! $purge_queue || '-1' === $purge_queue ) {
			return true;
		}
		// A WP_Error yields code 0.
		$code = (int) wp_remote_retrieve_response_code( wp_safe_remote_get( admin_url( 'admin-ajax.php' ) ) );
		if ( ! $code || $code >= 500 ) {
			self::debug( 'Failed to kick the current blog purge queue.' );
			return false;
		}
		return true;
	}

/**
	 * Append one HTML comment
	 *
	 * @since 5.5
	 * @param string $data The comment data.
	 */
	public static function comment( $data ) {
		self::cls()->append_comment( $data );
	}

/**
	 * Append one HTML comment
	 *
	 * @since 5.5
	 * @param string $data The comment data.
	 */
	private function append_comment( $data ) {
		$this->footer_comment .= "\n';
	}

/**
	 * Send HTTP header
	 *
	 * @since 5.3
	 * @param string $header The header to send.
	 */
	private function http_header( $header ) {
		if ( defined( 'LITESPEED_CLI' ) ) {
			return;
		}

if ( ! headers_sent() ) {
			header( $header );
		}

if ( ! defined( 'LSCWP_LOG' ) ) {
			return;
		}
		Debug2::debug( '💰 ' . $header );
	}
}