<?php
/**
 * File: ConfigState.php
 *
 * @package W3TC
 */

namespace W3TC;

/**
 * Class ConfigState
 *
 * Provides state information - state can be changed by plugin during lifetime,
 * while configuration is static
 *
 * master keys:
 *   common.install - time() of plugin installation
 *   common.support_us_invitations - number of invitations to support us shown
 *   common.next_support_us_invitation - time() of next support us invitation
 *   common.hide_note_wp_content_permissions
 *   common.hide_note_no_zlib
 *   common.hide_note_zlib_output_compression
 *   common.hide_note_nginx_restart_required
 *   common.nginx_rules_dismiss_fingerprint
 *   common.show_note.nginx_restart_required
 *   common.hide_note_php_version_56
 *   license.status
 *   license.jwt - license JWT for /v2/ service calls; not the license key
 *   license.next_check - time of next check
 *   license.terms - accepted/declined/''
 *   license.community_terms - accepted/declined/'' (master)
 *   license.paypal_billing_update_required - whether PayPal billing update is needed
 *   minify.error.file
 *   minify.error.last
 *   minify.error.notification.last
 *   minify.show_note_minify_error
 *   minify.hide_minify_help
 *   extension.cloudflare.next_ips_check
 *   extension.cloudflare.ips.ip4
 *   extension.cloudflare.ips.ip6
 *   extension.maxcache.hide_note_delivering
 *   extension.maxcache.hide_note_available
 *
 * blog-level keys:
 *   newrelic.hide_note_pageload_slow
 *   minify.show_note.need_flush
 *   minify.show_note.need_flush.timestamp - when the note was set
 *   cdn.hide_note_no_curl
 *   cdn.google_drive.access_token
 *   cdn.rackspace_cf.access_state
 *   cdn.rackspace_cdn.access_state
 *   cdn.show_note_theme_changed
 *   cdn.show_note_wp_upgraded
 *   cdn.show_note_cdn_upload
 *   cdn.show_note_cdn_reupload
 *   common.hide_note_no_permalink_rules
 *   common.show_note.plugins_updated
 *   common.show_note.plugins_updated.timestamp - when the note was set
 *   common.show_note.flush_statics_needed
 *   common.show_note.flush_statics_needed.timestamp
 *   common.show_note.flush_posts_needed
 *   common.show_note.flush_posts_needed.timestamp - when the note was set
 *   objectcache.show_note.flush_needed
 *   objectcache.show_note.flush_needed.timestamp - when the note was set
 *   extension.<extension_id>.hide_note_suggest_activation
 *   track.bunnycdn_signup
 *
 * phpcs:disable PSR2.Classes.PropertyDeclaration.Underscore
 * phpcs:disable WordPress.PHP.NoSilencedErrors.Discouraged
 */
class ConfigState {
	/**
	 * Data
	 *
	 * @var array
	 */
	private $_data;

	/**
	 * Is master flag
	 *
	 * @var bool
	 */
	private $_is_master;

	/**
	 * Whether stored option data has been loaded.
	 *
	 * @var bool
	 */
	private $_loaded;

	/**
	 * Encoded option payload from the last successful load or save.
	 *
	 * @since 2.10.7
	 *
	 * @var string|null
	 */
	private $_saved_encoded;

	/**
	 * Initializes the configuration state.
	 *
	 * @param bool $is_master Whether this is the master configuration state.
	 *
	 * @return void
	 */
	public function __construct( $is_master ) {
		$this->_is_master     = $is_master;
		$this->_data          = array();
		$this->_loaded        = false;
		$this->_saved_encoded = null;

		$this->load();
	}

	/**
	 * Retrieves a value from the configuration state by key.
	 *
	 * @param string $w3tc_key           The key to retrieve.
	 * @param mixed  $default_value The default value to return if the key is not set.
	 *
	 * @return mixed The value associated with the key, or the default value.
	 */
	public function get( $w3tc_key, $default_value ) {
		$this->load();

		if ( ! isset( $this->_data[ $w3tc_key ] ) ) {
			return $default_value;
		}

		return $this->_data[ $w3tc_key ];
	}

	/**
	 * Retrieves a string value from the configuration state.
	 *
	 * @param string $w3tc_key           The key to retrieve.
	 * @param string $default_value The default string to return if the key is not set. Default is an empty string.
	 * @param bool   $trim          Whether to trim the returned string. Default is true.
	 *
	 * @return string The string value associated with the key, or the default string.
	 */
	public function get_string( $w3tc_key, $default_value = '', $trim = true ) {
		$w3tc_value = (string) $this->get( $w3tc_key, $default_value );

		return $trim ? trim( $w3tc_value ) : $w3tc_value;
	}

	/**
	 * Retrieves an integer value from the configuration state.
	 *
	 * @param string $w3tc_key           The key to retrieve.
	 * @param int    $default_value The default integer to return if the key is not set. Default is 0.
	 *
	 * @return int The integer value associated with the key, or the default integer.
	 */
	public function get_integer( $w3tc_key, $default_value = 0 ) {
		return (int) $this->get( $w3tc_key, $default_value );
	}

	/**
	 * Retrieves a boolean value from the configuration state.
	 *
	 * @param string $w3tc_key           The key to retrieve.
	 * @param bool   $default_value The default boolean to return if the key is not set. Default is false.
	 *
	 * @return bool The boolean value associated with the key, or the default boolean.
	 */
	public function get_boolean( $w3tc_key, $default_value = false ) {
		$v = $this->get( $w3tc_key, $default_value );
		if ( 'false' === $v || empty( $v ) ) {
			$v = false;
		}

		return (bool) $v;
	}

	/**
	 * Retrieves an array value from the configuration state.
	 *
	 * @param string $w3tc_key           The key to retrieve.
	 * @param array  $default_value The default array to return if the key is not set. Default is an empty array.
	 *
	 * @return array The array value associated with the key, or the default array.
	 */
	public function get_array( $w3tc_key, $default_value = array() ) {
		return (array) $this->get( $w3tc_key, $default_value );
	}

	/**
	 * Sets a value in the configuration state.
	 *
	 * @param string $w3tc_key   The key to set.
	 * @param mixed  $w3tc_value The value to associate with the key.
	 *
	 * @return void
	 */
	public function set( $w3tc_key, $w3tc_value ) {
		$this->load();

		$this->_data[ $w3tc_key ] = $w3tc_value;
	}

	/**
	 * Resets the configuration state to its default values.
	 *
	 * @return void
	 */
	public function reset() {
		$this->_data          = array();
		$this->_loaded        = true;
		$this->_saved_encoded = null;
		$this->apply_defaults();
	}

	/**
	 * Saves the current configuration state.
	 *
	 * @return void
	 */
	public function save() {
		$this->load();

		if ( ! $this->_loaded ) {
			return;
		}

		$encoded = \wp_json_encode( $this->_data );
		if ( false === $encoded || $encoded === $this->_saved_encoded ) {
			return;
		}

		if ( $this->_is_master ) {
			if ( ! \function_exists( 'update_site_option' ) ) {
				return;
			}
			$saved = \update_site_option( 'w3tc_state', $encoded );
		} else {
			if ( ! \function_exists( 'update_option' ) ) {
				return;
			}
			$saved = \update_option( 'w3tc_state', $encoded );
		}

		if ( $saved ) {
			$this->_saved_encoded = $encoded;
		}
	}

	/**
	 * Loads stored option data when the Options API is available.
	 *
	 * @since 2.10.7
	 *
	 * @return void
	 */
	private function load() {
		if ( $this->_loaded ) {
			return;
		}

		if ( $this->_is_master ) {
			if ( ! \function_exists( 'get_site_option' ) ) {
				return;
			}
			$data_raw = \get_site_option( 'w3tc_state' );
		} else {
			if ( ! \function_exists( 'get_option' ) ) {
				return;
			}
			$data_raw = \get_option( 'w3tc_state' );
		}

		$this->_loaded = true;
		$this->_data   = @json_decode( $data_raw, true );
		if ( ! is_array( $this->_data ) ) {
			$this->_data = array();
			$this->apply_defaults();
			$this->save();
			return;
		}

		$this->_saved_encoded = \wp_json_encode( $this->_data );
	}

	/**
	 * Applies default values to the configuration state.
	 *
	 * @return void
	 */
	private function apply_defaults() {
		$this->set( 'common.install', time() );
		$this->set( 'common.install_version', W3TC_VERSION );
	}
}