3 +--------------------------------------------------------------------+
5 +--------------------------------------------------------------------+
6 | Copyright CiviCRM LLC (c) 2004-2018 |
7 +--------------------------------------------------------------------+
8 | This file is a part of CiviCRM. |
10 | CiviCRM is free software; you can copy, modify, and distribute it |
11 | under the terms of the GNU Affero General Public License |
12 | Version 3, 19 November 2007 and the CiviCRM Licensing Exception. |
14 | CiviCRM is distributed in the hope that it will be useful, but |
15 | WITHOUT ANY WARRANTY; without even the implied warranty of |
16 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. |
17 | See the GNU Affero General Public License for more details. |
19 | You should have received a copy of the GNU Affero General Public |
20 | License and the CiviCRM Licensing Exception along |
21 | with this program; if not, contact CiviCRM LLC |
22 | at info[AT]civicrm[DOT]org. If you have questions about the |
23 | GNU Affero General Public License or the licensing of CiviCRM, |
24 | see the CiviCRM license FAQ at http://civicrm.org/licensing |
25 +--------------------------------------------------------------------+
31 * @copyright CiviCRM LLC (c) 2004-2018
35 * This caching provider stores all cached items as a "group" in the
36 * "civicrm_cache" table. The entire 'group' may be prefetched when
37 * instantiating the cache provider.
39 class CRM_Utils_Cache_SqlGroup
implements CRM_Utils_Cache_Interface
{
41 use CRM_Utils_Cache_NaiveMultipleTrait
; // TODO Consider native implementation.
42 use CRM_Utils_Cache_NaiveHasTrait
; // TODO Native implementation
45 * The host name of the memcached server.
52 * @var int $componentID The optional component ID (so componenets can share the same name space)
54 protected $componentID;
57 * @var array in-memory cache to optimize redundant get()s
59 protected $frontCache;
64 * @param array $config
65 * An array of configuration params.
68 * - prefetch: bool, whether to preemptively read the entire cache group; default: TRUE
70 * @throws RuntimeException
71 * @return \CRM_Utils_Cache_SqlGroup
73 public function __construct($config) {
74 if (isset($config['group'])) {
75 $this->group
= $config['group'];
78 throw new RuntimeException("Cannot construct SqlGroup cache: missing group");
80 if (isset($config['componentID'])) {
81 $this->componentID
= $config['componentID'];
84 $this->componentID
= NULL;
86 $this->frontCache
= array();
87 if (CRM_Utils_Array
::value('prefetch', $config, TRUE)) {
95 * @param null|int|\DateInterval $ttl
98 public function set($key, $value, $ttl = NULL) {
100 throw new \
RuntimeException("FIXME: " . __CLASS__
. "::set() should support non-NULL TTL");
102 CRM_Core_BAO_Cache
::setItem($value, $this->group
, $key, $this->componentID
);
103 $this->frontCache
[$key] = $value;
109 * @param mixed $default
113 public function get($key, $default = NULL) {
114 if ($default !== NULL) {
115 throw new \
RuntimeException("FIXME: " . __CLASS__
. "::get() only supports NULL default");
117 if (!array_key_exists($key, $this->frontCache
)) {
118 $this->frontCache
[$key] = CRM_Core_BAO_Cache
::getItem($this->group
, $key, $this->componentID
);
120 return $this->frontCache
[$key];
125 * @param null $default
129 public function getFromFrontCache($key, $default = NULL) {
130 return CRM_Utils_Array
::value($key, $this->frontCache
, $default);
137 public function delete($key) {
138 CRM_Core_BAO_Cache
::deleteGroup($this->group
, $key, FALSE);
139 CRM_Core_BAO_Cache
::$_cache = NULL; // FIXME: remove multitier cache
140 CRM_Utils_Cache
::singleton()->flush(); // FIXME: remove multitier cache
141 unset($this->frontCache
[$key]);
145 public function flush() {
146 CRM_Core_BAO_Cache
::deleteGroup($this->group
, NULL, FALSE);
147 CRM_Core_BAO_Cache
::$_cache = NULL; // FIXME: remove multitier cache
148 CRM_Utils_Cache
::singleton()->flush(); // FIXME: remove multitier cache
149 $this->frontCache
= array();
153 public function clear() {
154 return $this->flush();
157 public function prefetch() {
158 $this->frontCache
= CRM_Core_BAO_Cache
::getItems($this->group
, $this->componentID
);