ILIAS  release_5-2 Revision v5.2.25-18-g3f80b828510
Memcache.php
Go to the documentation of this file.
1 <?php
37 
43  private $_cachePrefix = null;
44 
50  private $_cacheTime = 600;
51 
57  private $_memcache = null;
58 
59 
67  protected function _storeData() {
68  if ($this->_currentCellIsDirty && !empty($this->_currentObjectID)) {
69  $this->_currentObject->detach();
70 
71  $obj = serialize($this->_currentObject);
72  if (!$this->_memcache->replace($this->_cachePrefix.$this->_currentObjectID.'.cache',$obj,NULL,$this->_cacheTime)) {
73  if (!$this->_memcache->add($this->_cachePrefix.$this->_currentObjectID.'.cache',$obj,NULL,$this->_cacheTime)) {
74  $this->__destruct();
75  throw new PHPExcel_Exception('Failed to store cell '.$this->_currentObjectID.' in MemCache');
76  }
77  }
78  $this->_currentCellIsDirty = false;
79  }
80  $this->_currentObjectID = $this->_currentObject = null;
81  } // function _storeData()
82 
83 
92  public function addCacheData($pCoord, PHPExcel_Cell $cell) {
93  if (($pCoord !== $this->_currentObjectID) && ($this->_currentObjectID !== null)) {
94  $this->_storeData();
95  }
96  $this->_cellCache[$pCoord] = true;
97 
98  $this->_currentObjectID = $pCoord;
99  $this->_currentObject = $cell;
100  $this->_currentCellIsDirty = true;
101 
102  return $cell;
103  } // function addCacheData()
104 
105 
113  public function isDataSet($pCoord) {
114  // Check if the requested entry is the current object, or exists in the cache
115  if (parent::isDataSet($pCoord)) {
116  if ($this->_currentObjectID == $pCoord) {
117  return true;
118  }
119  // Check if the requested entry still exists in Memcache
120  $success = $this->_memcache->get($this->_cachePrefix.$pCoord.'.cache');
121  if ($success === false) {
122  // Entry no longer exists in Memcache, so clear it from the cache array
123  parent::deleteCacheData($pCoord);
124  throw new PHPExcel_Exception('Cell entry '.$pCoord.' no longer exists in MemCache');
125  }
126  return true;
127  }
128  return false;
129  } // function isDataSet()
130 
131 
139  public function getCacheData($pCoord) {
140  if ($pCoord === $this->_currentObjectID) {
141  return $this->_currentObject;
142  }
143  $this->_storeData();
144 
145  // Check if the entry that has been requested actually exists
146  if (parent::isDataSet($pCoord)) {
147  $obj = $this->_memcache->get($this->_cachePrefix.$pCoord.'.cache');
148  if ($obj === false) {
149  // Entry no longer exists in Memcache, so clear it from the cache array
150  parent::deleteCacheData($pCoord);
151  throw new PHPExcel_Exception('Cell entry '.$pCoord.' no longer exists in MemCache');
152  }
153  } else {
154  // Return null if requested entry doesn't exist in cache
155  return null;
156  }
157 
158  // Set current entry to the requested entry
159  $this->_currentObjectID = $pCoord;
160  $this->_currentObject = unserialize($obj);
161  // Re-attach this as the cell's parent
162  $this->_currentObject->attach($this);
163 
164  // Return requested entry
165  return $this->_currentObject;
166  } // function getCacheData()
167 
168 
174  public function getCellList() {
175  if ($this->_currentObjectID !== null) {
176  $this->_storeData();
177  }
178 
179  return parent::getCellList();
180  }
181 
182 
189  public function deleteCacheData($pCoord) {
190  // Delete the entry from Memcache
191  $this->_memcache->delete($this->_cachePrefix.$pCoord.'.cache');
192 
193  // Delete the entry from our cell address array
194  parent::deleteCacheData($pCoord);
195  } // function deleteCacheData()
196 
197 
204  public function copyCellCollection(PHPExcel_Worksheet $parent) {
205  parent::copyCellCollection($parent);
206  // Get a new id for the new file name
207  $baseUnique = $this->_getUniqueID();
208  $newCachePrefix = substr(md5($baseUnique),0,8).'.';
209  $cacheList = $this->getCellList();
210  foreach($cacheList as $cellID) {
211  if ($cellID != $this->_currentObjectID) {
212  $obj = $this->_memcache->get($this->_cachePrefix.$cellID.'.cache');
213  if ($obj === false) {
214  // Entry no longer exists in Memcache, so clear it from the cache array
215  parent::deleteCacheData($cellID);
216  throw new PHPExcel_Exception('Cell entry '.$cellID.' no longer exists in MemCache');
217  }
218  if (!$this->_memcache->add($newCachePrefix.$cellID.'.cache',$obj,NULL,$this->_cacheTime)) {
219  $this->__destruct();
220  throw new PHPExcel_Exception('Failed to store cell '.$cellID.' in MemCache');
221  }
222  }
223  }
224  $this->_cachePrefix = $newCachePrefix;
225  } // function copyCellCollection()
226 
227 
233  public function unsetWorksheetCells() {
234  if(!is_null($this->_currentObject)) {
235  $this->_currentObject->detach();
236  $this->_currentObject = $this->_currentObjectID = null;
237  }
238 
239  // Flush the Memcache cache
240  $this->__destruct();
241 
242  $this->_cellCache = array();
243 
244  // detach ourself from the worksheet, so that it can then delete this object successfully
245  $this->_parent = null;
246  } // function unsetWorksheetCells()
247 
248 
255  public function __construct(PHPExcel_Worksheet $parent, $arguments) {
256  $memcacheServer = (isset($arguments['memcacheServer'])) ? $arguments['memcacheServer'] : 'localhost';
257  $memcachePort = (isset($arguments['memcachePort'])) ? $arguments['memcachePort'] : 11211;
258  $cacheTime = (isset($arguments['cacheTime'])) ? $arguments['cacheTime'] : 600;
259 
260  if (is_null($this->_cachePrefix)) {
261  $baseUnique = $this->_getUniqueID();
262  $this->_cachePrefix = substr(md5($baseUnique),0,8).'.';
263 
264  // Set a new Memcache object and connect to the Memcache server
265  $this->_memcache = new Memcache();
266  if (!$this->_memcache->addServer($memcacheServer, $memcachePort, false, 50, 5, 5, true, array($this, 'failureCallback'))) {
267  throw new PHPExcel_Exception('Could not connect to MemCache server at '.$memcacheServer.':'.$memcachePort);
268  }
269  $this->_cacheTime = $cacheTime;
270 
271  parent::__construct($parent);
272  }
273  } // function __construct()
274 
275 
283  public function failureCallback($host, $port) {
284  throw new PHPExcel_Exception('memcache '.$host.':'.$port.' failed');
285  }
286 
287 
291  public function __destruct() {
292  $cacheList = $this->getCellList();
293  foreach($cacheList as $cellID) {
294  $this->_memcache->delete($this->_cachePrefix.$cellID.'.cache');
295  }
296  } // function __destruct()
297 
304  public static function cacheMethodIsAvailable() {
305  if (!function_exists('memcache_add')) {
306  return false;
307  }
308 
309  return true;
310  }
311 
312 }
getCacheData($pCoord)
Get cell at a specific coordinate.
Definition: Memcache.php:139
unsetWorksheetCells()
Clear the cell collection and disconnect from our parent.
Definition: Memcache.php:233
__destruct()
Destroy this cell collection.
Definition: Memcache.php:291
__construct(PHPExcel_Worksheet $parent, $arguments)
Initialise this new cell collection.
Definition: Memcache.php:255
static cacheMethodIsAvailable()
Identify whether the caching method is currently available Some methods are dependent on the availabi...
Definition: Memcache.php:304
copyCellCollection(PHPExcel_Worksheet $parent)
Clone the cell collection.
Definition: Memcache.php:204
getCellList()
Get a list of all cell addresses currently held in cache.
Definition: Memcache.php:174
$success
Definition: Utf8Test.php:86
_getUniqueID()
Generate a unique ID for cache referencing.
Definition: CacheBase.php:311
_storeData()
Store cell data in cache for the current cell object if it&#39;s "dirty", and the &#39;nullify&#39; the current c...
Definition: Memcache.php:67
failureCallback($host, $port)
Memcache error handler.
Definition: Memcache.php:283
Create styles array
The data for the language used.
deleteCacheData($pCoord)
Delete a cell in cache identified by coordinate address.
Definition: Memcache.php:189
addCacheData($pCoord, PHPExcel_Cell $cell)
Add or Update a cell in cache identified by coordinate address.
Definition: Memcache.php:92
isDataSet($pCoord)
Is a value set in the current PHPExcel_CachedObjectStorage_ICache for an indexed cell?
Definition: Memcache.php:113