3 +--------------------------------------------------------------------+
4 | CiviCRM version 4.7 |
5 +--------------------------------------------------------------------+
6 | Copyright CiviCRM LLC (c) 2004-2016 |
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-2016
33 class CRM_Utils_Cache_Memcached
implements CRM_Utils_Cache_Interface
{
34 const DEFAULT_HOST
= 'localhost';
35 const DEFAULT_PORT
= 11211;
36 const DEFAULT_TIMEOUT
= 3600;
37 const DEFAULT_PREFIX
= '';
38 const MAX_KEY_LEN
= 62;
41 * The host name of the memcached server
45 protected $_host = self
::DEFAULT_HOST
;
48 * The port on which to connect on
52 protected $_port = self
::DEFAULT_PORT
;
55 * The default timeout to use
59 protected $_timeout = self
::DEFAULT_TIMEOUT
;
62 * The prefix prepended to cache keys.
64 * If we are using the same memcache instance for multiple CiviCRM
65 * installs, we must have a unique prefix for each install to prevent
66 * the keys from clobbering each other.
70 protected $_prefix = self
::DEFAULT_PREFIX
;
73 * The actual memcache object.
82 * @param array $config
83 * An array of configuration params.
85 * @return \CRM_Utils_Cache_Memcached
87 public function __construct($config) {
88 if (isset($config['host'])) {
89 $this->_host
= $config['host'];
91 if (isset($config['port'])) {
92 $this->_port
= $config['port'];
94 if (isset($config['timeout'])) {
95 $this->_timeout
= $config['timeout'];
97 if (isset($config['prefix'])) {
98 $this->_prefix
= $config['prefix'];
101 $this->_cache
= new Memcached();
103 if (!$this->_cache
->addServer($this->_host
, $this->_port
)) {
104 // dont use fatal here since we can go in an infinite loop
105 echo 'Could not connect to Memcached server';
106 CRM_Utils_System
::civiExit();
117 public function set($key, &$value) {
118 $key = $this->cleanKey($key);
119 if (!$this->_cache
->set($key, $value, $this->_timeout
)) {
120 CRM_Core_Error
::debug('Result Code: ', $this->_cache
->getResultMessage());
121 CRM_Core_Error
::fatal("memcached set failed, wondering why?, $key", $value);
132 public function &get($key) {
133 $key = $this->cleanKey($key);
134 $result = $this->_cache
->get($key);
143 public function delete($key) {
144 $key = $this->cleanKey($key);
145 return $this->_cache
->delete($key);
151 * @return mixed|string
153 public function cleanKey($key) {
154 $key = preg_replace('/\s+|\W+/', '_', $this->_prefix
. $key);
155 if (strlen($key) > self
::MAX_KEY_LEN
) {
156 $md5Key = md5($key); // this should be 32 characters in length
157 $subKeyLen = self
::MAX_KEY_LEN
- 1 - strlen($md5Key);
158 $key = substr($key, 0, $subKeyLen) . "_" . $md5Key;
166 public function flush() {
167 return $this->_cache
->flush();