3 * Per-process memory cache for storing items.
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2 of the License, or
8 * (at your option) any later version.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License along
16 * with this program; if not, write to the Free Software Foundation, Inc.,
17 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
18 * http://www.gnu.org/copyleft/gpl.html
25 * Simple store for keeping values in an associative array for the current process.
27 * Data will not persist and is not shared with other processes.
31 class HashBagOStuff
extends BagOStuff
{
34 /** @var int Max entries allowed */
35 protected $maxCacheKeys;
37 /** @var string CAS token prefix for this instance */
40 /** @var int CAS token counter */
41 private static $casCounter = 0;
48 * @param array $params Additional parameters include:
49 * - maxKeys : only allow this many keys (using oldest-first eviction)
51 function __construct( $params = [] ) {
52 $params['segmentationSize'] = $params['segmentationSize'] ?? INF
;
53 parent
::__construct( $params );
55 $this->token
= microtime( true ) . ':' . mt_rand();
56 $this->maxCacheKeys
= $params['maxKeys'] ?? INF
;
57 if ( $this->maxCacheKeys
<= 0 ) {
58 throw new InvalidArgumentException( '$maxKeys parameter must be above zero' );
62 protected function doGet( $key, $flags = 0, &$casToken = null ) {
65 if ( !$this->hasKey( $key ) ||
$this->expire( $key ) ) {
69 // Refresh key position for maxCacheKeys eviction
70 $temp = $this->bag
[$key];
71 unset( $this->bag
[$key] );
72 $this->bag
[$key] = $temp;
74 $casToken = $this->bag
[$key][self
::KEY_CAS
];
76 return $this->bag
[$key][self
::KEY_VAL
];
79 protected function doSet( $key, $value, $exptime = 0, $flags = 0 ) {
80 // Refresh key position for maxCacheKeys eviction
81 unset( $this->bag
[$key] );
83 self
::KEY_VAL
=> $value,
84 self
::KEY_EXP
=> $this->convertToExpiry( $exptime ),
85 self
::KEY_CAS
=> $this->token
. ':' . ++self
::$casCounter
88 if ( count( $this->bag
) > $this->maxCacheKeys
) {
90 $evictKey = key( $this->bag
);
91 unset( $this->bag
[$evictKey] );
97 public function add( $key, $value, $exptime = 0, $flags = 0 ) {
98 if ( $this->hasKey( $key ) && !$this->expire( $key ) ) {
99 return false; // key already set
102 return $this->doSet( $key, $value, $exptime, $flags );
105 protected function doDelete( $key, $flags = 0 ) {
106 unset( $this->bag
[$key] );
111 public function incr( $key, $value = 1 ) {
112 $n = $this->get( $key );
113 if ( $this->isInteger( $n ) ) {
114 $n = max( $n +
intval( $value ), 0 );
115 $this->bag
[$key][self
::KEY_VAL
] = $n;
124 * Clear all values in cache
126 public function clear() {
134 protected function expire( $key ) {
135 $et = $this->bag
[$key][self
::KEY_EXP
];
136 if ( $et == self
::TTL_INDEFINITE ||
$et > $this->getCurrentTime() ) {
140 $this->doDelete( $key );
146 * Does this bag have a non-null value for the given key?
152 protected function hasKey( $key ) {
153 return isset( $this->bag
[$key] );