enmi-conf.org: wp/wp-includes/class-wp-feed-cache-transient.php@8c2e4d02f4ef (annotated)

7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	1	<?php
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	2	/**
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	3	* Feed API: WP_Feed_Cache_Transient class
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	4	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	5	* @package WordPress
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	6	* @subpackage Feed
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	7	* @since 4.7.0
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	8	*/
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	9
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	10	/**
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	11	* Core class used to implement feed cache transients.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	12	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	13	* @since 2.8.0
22 8c2e4d02f4ef Update WordPress to latest version (6.7) ymh <ymh.work@gmail.com> parents: 21 diff changeset	14	* @since 6.7.0 Now properly implements the SimplePie\Cache\Base interface.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	15	*/
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 9 diff changeset	16	#[AllowDynamicProperties]
22 8c2e4d02f4ef Update WordPress to latest version (6.7) ymh <ymh.work@gmail.com> parents: 21 diff changeset	17	class WP_Feed_Cache_Transient implements SimplePie\Cache\Base {
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	18
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	19	/**
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	20	* Holds the transient name.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	21	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	22	* @since 2.8.0
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	23	* @var string
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	24	*/
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	25	public $name;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	26
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	27	/**
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	28	* Holds the transient mod name.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	29	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	30	* @since 2.8.0
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	31	* @var string
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	32	*/
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	33	public $mod_name;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	34
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	35	/**
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	36	* Holds the cache duration in seconds.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	37	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	38	* Defaults to 43200 seconds (12 hours).
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	39	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	40	* @since 2.8.0
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	41	* @var int
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	42	*/
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	43	public $lifetime = 43200;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	44
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	45	/**
22 8c2e4d02f4ef Update WordPress to latest version (6.7) ymh <ymh.work@gmail.com> parents: 21 diff changeset	46	* Creates a new (transient) cache object.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	47	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	48	* @since 2.8.0
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	49	* @since 3.2.0 Updated to use a PHP5 constructor.
22 8c2e4d02f4ef Update WordPress to latest version (6.7) ymh <ymh.work@gmail.com> parents: 21 diff changeset	50	* @since 6.7.0 Parameter names have been updated to be in line with the `SimplePie\Cache\Base` interface.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	51	*
22 8c2e4d02f4ef Update WordPress to latest version (6.7) ymh <ymh.work@gmail.com> parents: 21 diff changeset	52	* @param string $location URL location (scheme is used to determine handler).
8c2e4d02f4ef Update WordPress to latest version (6.7) ymh <ymh.work@gmail.com> parents: 21 diff changeset	53	* @param string $name Unique identifier for cache object.
8c2e4d02f4ef Update WordPress to latest version (6.7) ymh <ymh.work@gmail.com> parents: 21 diff changeset	54	* @param Base::TYPE_FEED\|Base::TYPE_IMAGE $type Either `TYPE_FEED` ('spc') for SimplePie data,
8c2e4d02f4ef Update WordPress to latest version (6.7) ymh <ymh.work@gmail.com> parents: 21 diff changeset	55	* or `TYPE_IMAGE` ('spi') for image data.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	56	*/
22 8c2e4d02f4ef Update WordPress to latest version (6.7) ymh <ymh.work@gmail.com> parents: 21 diff changeset	57	public function __construct( $location, $name, $type ) {
8c2e4d02f4ef Update WordPress to latest version (6.7) ymh <ymh.work@gmail.com> parents: 21 diff changeset	58	$this->name = 'feed_' . $name;
8c2e4d02f4ef Update WordPress to latest version (6.7) ymh <ymh.work@gmail.com> parents: 21 diff changeset	59	$this->mod_name = 'feed_mod_' . $name;
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	60
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	61	$lifetime = $this->lifetime;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	62	/**
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	63	* Filters the transient lifetime of the feed cache.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	64	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	65	* @since 2.8.0
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	66	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	67	* @param int $lifetime Cache duration in seconds. Default is 43200 seconds (12 hours).
22 8c2e4d02f4ef Update WordPress to latest version (6.7) ymh <ymh.work@gmail.com> parents: 21 diff changeset	68	* @param string $name Unique identifier for the cache object.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	69	*/
22 8c2e4d02f4ef Update WordPress to latest version (6.7) ymh <ymh.work@gmail.com> parents: 21 diff changeset	70	$this->lifetime = apply_filters( 'wp_feed_cache_transient_lifetime', $lifetime, $name );
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	71	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	72
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	73	/**
22 8c2e4d02f4ef Update WordPress to latest version (6.7) ymh <ymh.work@gmail.com> parents: 21 diff changeset	74	* Saves data to the transient.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	75	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	76	* @since 2.8.0
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	77	*
22 8c2e4d02f4ef Update WordPress to latest version (6.7) ymh <ymh.work@gmail.com> parents: 21 diff changeset	78	* @param array\|SimplePie\SimplePie $data Data to save. If passed a SimplePie object,
8c2e4d02f4ef Update WordPress to latest version (6.7) ymh <ymh.work@gmail.com> parents: 21 diff changeset	79	* only cache the `$data` property.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	80	* @return true Always true.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	81	*/
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	82	public function save( $data ) {
22 8c2e4d02f4ef Update WordPress to latest version (6.7) ymh <ymh.work@gmail.com> parents: 21 diff changeset	83	if ( $data instanceof SimplePie\SimplePie ) {
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	84	$data = $data->data;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	85	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	86
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	87	set_transient( $this->name, $data, $this->lifetime );
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	88	set_transient( $this->mod_name, time(), $this->lifetime );
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	89	return true;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	90	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	91
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	92	/**
22 8c2e4d02f4ef Update WordPress to latest version (6.7) ymh <ymh.work@gmail.com> parents: 21 diff changeset	93	* Retrieves the data saved in the transient.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	94	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	95	* @since 2.8.0
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	96	*
22 8c2e4d02f4ef Update WordPress to latest version (6.7) ymh <ymh.work@gmail.com> parents: 21 diff changeset	97	* @return array Data for `SimplePie::$data`.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	98	*/
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	99	public function load() {
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	100	return get_transient( $this->name );
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	101	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	102
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	103	/**
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	104	* Gets mod transient.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	105	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	106	* @since 2.8.0
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	107	*
22 8c2e4d02f4ef Update WordPress to latest version (6.7) ymh <ymh.work@gmail.com> parents: 21 diff changeset	108	* @return int Timestamp.
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	109	*/
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	110	public function mtime() {
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	111	return get_transient( $this->mod_name );
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	112	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	113
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	114	/**
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	115	* Sets mod transient.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	116	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	117	* @since 2.8.0
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	118	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	119	* @return bool False if value was not set and true if value was set.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	120	*/
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	121	public function touch() {
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	122	return set_transient( $this->mod_name, time(), $this->lifetime );
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	123	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	124
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	125	/**
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	126	* Deletes transients.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	127	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	128	* @since 2.8.0
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	129	*
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	130	* @return true Always true.
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	131	*/
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	132	public function unlink() {
9 177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	133	delete_transient( $this->name );
177826044cd9 upgrade wordpress to 5.2.3 ymh <ymh.work@gmail.com> parents: 7 diff changeset	134	delete_transient( $this->mod_name );
7 cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	135	return true;
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	136	}
cf61fcea0001 resynchronize code repo with production ymh <ymh.work@gmail.com> parents: diff changeset	137	}

author	ymh <ymh.work@gmail.com>
	Fri, 05 Sep 2025 18:52:52 +0200
changeset 22	8c2e4d02f4ef
parent 21	48c4eec2b7e6
permissions	-rw-r--r--