File "Options.php"

Full Path: /home/rattkxnv/byattorney.com/wp-content/plugins/google-site-kit/includes/Core/Storage/Options.php
File size: 2.87 KB
MIME-type: text/x-php
Charset: utf-8

<?php
/**
 * Class Google\Site_Kit\Core\Storage\Options
 *
 * @package   Google\Site_Kit
 * @copyright 2021 Google LLC
 * @license   https://www.apache.org/licenses/LICENSE-2.0 Apache License 2.0
 * @link      https://sitekit.withgoogle.com
 */

namespace Google\Site_Kit\Core\Storage;

use Google\Site_Kit\Context;

/**
 * Class providing access to options.
 *
 * It uses regular options or network options, depending on in which mode the plugin is running.
 *
 * @since 1.0.0
 * @access private
 * @ignore
 */
final class Options implements Options_Interface {

	/**
	 * Plugin context.
	 *
	 * @since 1.0.0
	 * @var Context
	 */
	private $context;

	/**
	 * Constructor.
	 *
	 * @since 1.0.0
	 *
	 * @param Context $context Plugin context.
	 */
	public function __construct( Context $context ) {
		$this->context = $context;
	}

	/**
	 * Checks whether or not a value is set for the given option.
	 *
	 * @since 1.3.0
	 *
	 * @param string $option Option name.
	 * @return bool True if value set, false otherwise.
	 */
	public function has( $option ) {
		// Call for option to ensure 'notoptions' cache is fresh for the option.
		$value = $this->get( $option );

		if ( $this->context->is_network_mode() ) {
			$network_id = get_current_network_id();
			$notoptions = wp_cache_get( "$network_id:notoptions", 'site-options' );
		} else {
			$notoptions = wp_cache_get( 'notoptions', 'options' );
		}

		// Check for `notoptions` cache. If unavailable, query the database.
		// This is particularly happening when `WP_INSTALLING` is true,
		// which includes `wp-activate.php` in multisite setups and certain
		// other multisite-related functions.
		// See: https://github.com/google/site-kit-wp/issues/7653.
		if ( false === $notoptions ) {
			return (bool) $value;
		}

		return ! isset( $notoptions[ $option ] );
	}

	/**
	 * Gets the value of the given option.
	 *
	 * @since 1.0.0
	 *
	 * @param string $option Option name.
	 * @return mixed Value set for the option, or false if not set.
	 */
	public function get( $option ) {
		if ( $this->context->is_network_mode() ) {
			return get_network_option( null, $option );
		}

		return get_option( $option );
	}

	/**
	 * Sets the value for a option.
	 *
	 * @since 1.0.0
	 *
	 * @param string $option    Option name.
	 * @param mixed  $value     Option value. Must be serializable if non-scalar.
	 * @return bool True on success, false on failure.
	 */
	public function set( $option, $value ) {
		if ( $this->context->is_network_mode() ) {
			return update_network_option( null, $option, $value );
		}

		return update_option( $option, $value );
	}

	/**
	 * Deletes the given option.
	 *
	 * @since 1.0.0
	 *
	 * @param string $option Option name.
	 * @return bool True on success, false on failure.
	 */
	public function delete( $option ) {
		if ( $this->context->is_network_mode() ) {
			return delete_network_option( null, $option );
		}

		return delete_option( $option );
	}
}