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) {
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
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}
$success
Definition: Utf8Test.php:86
An exception for terminatinating execution or to throw for unit testing.
_getUniqueID()
Generate a unique ID for cache referencing.
Definition: CacheBase.php:311
deleteCacheData($pCoord)
Delete a cell in cache identified by coordinate address.
Definition: Memcache.php:189
static cacheMethodIsAvailable()
Identify whether the caching method is currently available Some methods are dependent on the availabi...
Definition: Memcache.php:304
getCellList()
Get a list of all cell addresses currently held in cache.
Definition: Memcache.php:174
addCacheData($pCoord, PHPExcel_Cell $cell)
Add or Update a cell in cache identified by coordinate address.
Definition: Memcache.php:92
copyCellCollection(PHPExcel_Worksheet $parent)
Clone the cell collection.
Definition: Memcache.php:204
unsetWorksheetCells()
Clear the cell collection and disconnect from our parent.
Definition: Memcache.php:233
__construct(PHPExcel_Worksheet $parent, $arguments)
Initialise this new cell collection.
Definition: Memcache.php:255
isDataSet($pCoord)
Is a value set in the current PHPExcel_CachedObjectStorage_ICache for an indexed cell?
Definition: Memcache.php:113
_storeData()
Store cell data in cache for the current cell object if it's "dirty", and the 'nullify' the current c...
Definition: Memcache.php:67
getCacheData($pCoord)
Get cell at a specific coordinate.
Definition: Memcache.php:139
__destruct()
Destroy this cell collection.
Definition: Memcache.php:291