* @return void
*/
public function set( $key, $value ) {
- if ( array_key_exists( $key, $this->cache ) ) {
+ if ( $this->has( $key ) ) {
$this->ping( $key );
} elseif ( count( $this->cache ) >= $this->maxCacheKeys ) {
reset( $this->cache );
* @return bool
*/
public function has( $key ) {
+ if ( !is_int( $key ) && !is_string( $key ) ) {
+ throw new MWException( __METHOD__ . ' called with invalid key. Must be string or integer.' );
+ }
return array_key_exists( $key, $this->cache );
}
* If the item is already set, it will be pushed to the top of the cache.
*
* @param string $key
- * @return mixed
+ * @return mixed Returns null if the key was not found
*/
public function get( $key ) {
- if ( !array_key_exists( $key, $this->cache ) ) {
+ if ( !$this->has( $key ) ) {
return null;
}
+
$this->ping( $key );
+
return $this->cache[$key];
}
return array_keys( $this->cache );
}
+ /**
+ * Get an item with the given key, producing and setting it if not found.
+ *
+ * If the callback returns false, then nothing is stored.
+ *
+ * @since 1.28
+ * @param string $key
+ * @param callable $callback Callback that will produce the value
+ * @return mixed The cached value if found or the result of $callback otherwise
+ */
+ public function getWithSetCallback( $key, callable $callback ) {
+ if ( $this->has( $key ) ) {
+ $value = $this->get( $key );
+ } else {
+ $value = call_user_func( $callback );
+ if ( $value !== false ) {
+ $this->set( $key, $value );
+ }
+ }
+
+ return $value;
+ }
+
/**
* Clear one or several cache entries, or all cache entries
*