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 MediumSpecificBagOStuff
{
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)
50 * @codingStandardsIgnoreStart
51 * @phan-param array{logger?:Psr\Log\LoggerInterface,asyncHandler?:callable,keyspace?:string,reportDupes?:bool,syncTimeout?:int,segmentationSize?:int,segmentedValueMaxSize?:int,maxKeys?:int} $params
52 * @codingStandardsIgnoreEnd
54 function __construct( $params = [] ) {
55 $params['segmentationSize'] = $params['segmentationSize'] ?? INF
;
56 parent
::__construct( $params );
58 $this->token
= microtime( true ) . ':' . mt_rand();
59 $this->maxCacheKeys
= $params['maxKeys'] ?? INF
;
60 if ( $this->maxCacheKeys
<= 0 ) {
61 throw new InvalidArgumentException( '$maxKeys parameter must be above zero' );
65 protected function doGet( $key, $flags = 0, &$casToken = null ) {
68 if ( !$this->hasKey( $key ) ||
$this->expire( $key ) ) {
72 // Refresh key position for maxCacheKeys eviction
73 $temp = $this->bag
[$key];
74 unset( $this->bag
[$key] );
75 $this->bag
[$key] = $temp;
77 $casToken = $this->bag
[$key][self
::KEY_CAS
];
79 return $this->bag
[$key][self
::KEY_VAL
];
82 protected function doSet( $key, $value, $exptime = 0, $flags = 0 ) {
83 // Refresh key position for maxCacheKeys eviction
84 unset( $this->bag
[$key] );
86 self
::KEY_VAL
=> $value,
87 self
::KEY_EXP
=> $this->getExpirationAsTimestamp( $exptime ),
88 self
::KEY_CAS
=> $this->token
. ':' . ++self
::$casCounter
91 if ( count( $this->bag
) > $this->maxCacheKeys
) {
93 $evictKey = key( $this->bag
);
94 unset( $this->bag
[$evictKey] );
100 protected function doAdd( $key, $value, $exptime = 0, $flags = 0 ) {
101 if ( $this->hasKey( $key ) && !$this->expire( $key ) ) {
102 return false; // key already set
105 return $this->doSet( $key, $value, $exptime, $flags );
108 protected function doDelete( $key, $flags = 0 ) {
109 unset( $this->bag
[$key] );
114 public function incr( $key, $value = 1, $flags = 0 ) {
115 $n = $this->get( $key );
116 if ( $this->isInteger( $n ) ) {
117 $n = max( $n +
(int)$value, 0 );
118 $this->bag
[$key][self
::KEY_VAL
] = $n;
126 public function decr( $key, $value = 1, $flags = 0 ) {
127 return $this->incr( $key, -$value, $flags );
131 * Clear all values in cache
133 public function clear() {
141 protected function expire( $key ) {
142 $et = $this->bag
[$key][self
::KEY_EXP
];
143 if ( $et == self
::TTL_INDEFINITE ||
$et > $this->getCurrentTime() ) {
147 $this->doDelete( $key );
153 * Does this bag have a non-null value for the given key?
159 public function hasKey( $key ) {
160 return isset( $this->bag
[$key] );