<h2>File Contents: /home/planet5/www/wp-content/plugins/wordpress-seo/inc/sitemaps/class-sitemap-cache-data.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/www/wp-content/plugins/wordpress-seo/inc/sitemaps/class-sitemap-cache-data.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php
/**
 * WPSEO plugin file.
 *
 * @package WPSEO\XML_Sitemaps
 */

/**
 * Sitemap Cache Data object, manages sitemap data stored in cache.
 */
class WPSEO_Sitemap_Cache_Data implements Serializable, WPSEO_Sitemap_Cache_Data_Interface {

	/**
	 * Sitemap XML data.
	 *
	 * @var string
	 */
	private $sitemap = &#039;&#039;;

	/**
	 * Status of the sitemap, usable or not.
	 *
	 * @var string
	 */
	private $status = self::UNKNOWN;

	/**
	 * Set the sitemap XML data
	 *
	 * @param string $sitemap XML Content of the sitemap.
	 *
	 * @return void
	 */
	public function set_sitemap( $sitemap ) {

		if ( ! is_string( $sitemap ) ) {
			$sitemap = &#039;&#039;;
		}

		$this-&gt;sitemap = $sitemap;

		/*
		 * Empty sitemap is not usable.
		 */
		if ( ! empty( $sitemap ) ) {
			$this-&gt;set_status( self::OK );
		}
		else {
			$this-&gt;set_status( self::ERROR );
		}
	}

	/**
	 * Set the status of the sitemap, is it usable.
	 *
	 * @param bool|string $usable Is the sitemap usable or not.
	 *
	 * @return void
	 */
	public function set_status( $usable ) {

		if ( $usable === self::OK ) {
			$this-&gt;status = self::OK;

			return;
		}

		if ( $usable === self::ERROR ) {
			$this-&gt;status  = self::ERROR;
			$this-&gt;sitemap = &#039;&#039;;

			return;
		}

		$this-&gt;status = self::UNKNOWN;
	}

	/**
	 * Is the sitemap usable.
	 *
	 * @return bool True if usable, False if bad or unknown.
	 */
	public function is_usable() {

		return $this-&gt;status === self::OK;
	}

	/**
	 * Get the XML content of the sitemap.
	 *
	 * @return string The content of the sitemap.
	 */
	public function get_sitemap() {

		return $this-&gt;sitemap;
	}

	/**
	 * Get the status of the sitemap.
	 *
	 * @return string Status of the sitemap, &#039;ok&#039;/&#039;error&#039;/&#039;unknown&#039;.
	 */
	public function get_status() {

		return $this-&gt;status;
	}

	/**
	 * String representation of object.
	 *
	 * {@internal This magic method is only &quot;magic&quot; as of PHP 7.4 in which the magic method was introduced.}
	 *
	 * @link https://www.php.net/language.oop5.magic#object.serialize
	 * @link https://wiki.php.net/rfc/custom_object_serialization
	 *
	 * @since 17.8.0
	 *
	 * @return array The data to be serialized.
	 */
	public function __serialize() { // phpcs:ignore PHPCompatibility.FunctionNameRestrictions.NewMagicMethods.__serializeFound

		$data = [
			&#039;status&#039; =&gt; $this-&gt;status,
			&#039;xml&#039;    =&gt; $this-&gt;sitemap,
		];

		return $data;
	}

	/**
	 * Constructs the object.
	 *
	 * {@internal This magic method is only &quot;magic&quot; as of PHP 7.4 in which the magic method was introduced.}
	 *
	 * @link https://www.php.net/language.oop5.magic#object.serialize
	 * @link https://wiki.php.net/rfc/custom_object_serialization
	 *
	 * @since 17.8.0
	 *
	 * @param array $data The unserialized data to use to (re)construct the object.
	 *
	 * @return void
	 */
	public function __unserialize( $data ) { // phpcs:ignore PHPCompatibility.FunctionNameRestrictions.NewMagicMethods.__unserializeFound

		$this-&gt;set_sitemap( $data[&#039;xml&#039;] );
		$this-&gt;set_status( $data[&#039;status&#039;] );
	}

	/**
	 * String representation of object.
	 *
	 * {@internal The magic methods take precedence over the Serializable interface.
	 * This means that in practice, this method will now only be called on PHP &lt; 7.4.
	 * For PHP 7.4 and higher, the magic methods will be used instead.}
	 *
	 * {@internal The Serializable interface is being phased out, in favour of the magic methods.
	 * This method should be deprecated and removed and the class should no longer
	 * implement the `Serializable` interface.
	 * This change, however, can&#039;t be made until the minimum PHP version goes up to PHP 7.4 or higher.}
	 *
	 * @link http://php.net/manual/en/serializable.serialize.php
	 * @link https://wiki.php.net/rfc/phase_out_serializable
	 *
	 * @since 5.1.0
	 *
	 * @return string The string representation of the object or null in C-format.
	 */
	public function serialize() {

		return serialize( $this-&gt;__serialize() );
	}

	/**
	 * Constructs the object.
	 *
	 * {@internal Unlike `serialize()` above, this method is NOT superseded by its magic counterpart
	 * on PHP 7.4 and higher, so it is live code on every supported PHP version. PHP selects the
	 * handler based on the *format* of the payload being read, not on the PHP version: `O:`-format
	 * payloads are routed to `__unserialize()`, whereas `C:`-format payloads are dispatched here,
	 * because this class implements `Serializable`. Verified on PHP 7.4 through 8.3.
	 * There is no call to this method anywhere in the codebase; the engine invokes it.}
	 *
	 * {@internal `$data` must be treated as untrusted. `C:`-format payloads survive WordPress
	 * unaltered on the way into the database, because `is_serialized()` has no case for `C` and
	 * `maybe_serialize()` therefore stores such a string verbatim rather than escaping it. Any code
	 * path that unserializes third-party data can consequently reach this method with a crafted
	 * payload.
	 * The nested call is restricted with `allowed_classes =&gt; false` for that reason: a legitimate
	 * payload only ever contains the two strings produced by `__serialize()`, so instantiating a
	 * class here is never valid, and permitting it turns this method into an object-injection sink
	 * that ends in an arbitrary `__destruct()`. Do not relax that restriction.}
	 *
	 * {@internal The Serializable interface is being phased out, in favour of the magic methods.
	 * This method should be deprecated and removed and the class should no longer implement the
	 * `Serializable` interface. The minimum supported PHP version has since risen to 7.4, so that is
	 * now possible, but it is deliberately left as a separate change: dropping the interface alters
	 * how sitemap caches originally written on PHP &lt; 7.4 are handled, as PHP then returns an empty
	 * instance for those payloads instead of a populated one.}
	 *
	 * @link http://php.net/manual/en/serializable.unserialize.php
	 * @link https://wiki.php.net/rfc/phase_out_serializable
	 *
	 * @since 5.1.0
	 *
	 * @param string $data Untrusted serialized representation of the data array, as carried in the
	 *                     body of a `C:`-format payload naming this class.
	 *
	 * @return void
	 */
	public function unserialize( $data ) {

		$data = unserialize( $data, [ &#039;allowed_classes&#039; =&gt; false ] );
		$this-&gt;__unserialize( $data );
	}
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fwww%2Fwp-content%2Fplugins%2Fwordpress-seo%2Finc%2Fsitemaps'>⬅ Back to Directory</a>