adding zend project folders into old campcaster.
This commit is contained in:
naomiaro
parent
56abfaf28e
commit
7ef0c18b26
4045 changed files with 1054952 additions and 0 deletions
149
library/Zend/Memory/AccessController.php
Normal file
149
library/Zend/Memory/AccessController.php
Normal file
|
|
@ -0,0 +1,149 @@
|
|||
<?php
|
||||
/**
|
||||
* Zend Framework
|
||||
*
|
||||
* LICENSE
|
||||
*
|
||||
* This source file is subject to the new BSD license that is bundled
|
||||
* with this package in the file LICENSE.txt.
|
||||
* It is also available through the world-wide-web at this URL:
|
||||
* http://framework.zend.com/license/new-bsd
|
||||
* If you did not receive a copy of the license and are unable to
|
||||
* obtain it through the world-wide-web, please send an email
|
||||
* to license@zend.com so we can send you a copy immediately.
|
||||
*
|
||||
* @category Zend
|
||||
* @package Zend_Memory
|
||||
* @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
|
||||
* @license http://framework.zend.com/license/new-bsd New BSD License
|
||||
* @version $Id: AccessController.php 20096 2010-01-06 02:05:09Z bkarwin $
|
||||
*/
|
||||
|
||||
/**
|
||||
* Zend_Memory_Container_Interface
|
||||
*/
|
||||
require_once 'Zend/Memory/Container/Interface.php';
|
||||
|
||||
/**
|
||||
* Memory object container access controller.
|
||||
*
|
||||
* Memory manager stores a list of generated objects to control them.
|
||||
* So container objects always have at least one reference and can't be automatically destroyed.
|
||||
*
|
||||
* This class is intended to be an userland proxy to memory container object.
|
||||
* It's not referenced by memory manager and class destructor is invoked immidiately after gouing
|
||||
* out of scope or unset operation.
|
||||
*
|
||||
* Class also provides Zend_Memory_Container_Interface interface and works as proxy for such cases.
|
||||
*
|
||||
* @category Zend
|
||||
* @package Zend_Memory
|
||||
* @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
|
||||
* @license http://framework.zend.com/license/new-bsd New BSD License
|
||||
*/
|
||||
class Zend_Memory_AccessController implements Zend_Memory_Container_Interface
|
||||
{
|
||||
/**
|
||||
* Memory container object
|
||||
*
|
||||
* @var Zend_Memory_Container
|
||||
*/
|
||||
private $_memContainer;
|
||||
|
||||
|
||||
/**
|
||||
* Object constructor
|
||||
*
|
||||
* @param Zend_Memory_Container_Movable $memoryManager
|
||||
*/
|
||||
public function __construct(Zend_Memory_Container_Movable $memContainer)
|
||||
{
|
||||
$this->_memContainer = $memContainer;
|
||||
}
|
||||
|
||||
/**
|
||||
* Object destructor
|
||||
*/
|
||||
public function __destruct()
|
||||
{
|
||||
$this->_memContainer->destroy();
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* Get string value reference
|
||||
*
|
||||
* _Must_ be used for value access before PHP v 5.2
|
||||
* or _may_ be used for performance considerations
|
||||
*
|
||||
* @return &string
|
||||
*/
|
||||
public function &getRef()
|
||||
{
|
||||
return $this->_memContainer->getRef();
|
||||
}
|
||||
|
||||
/**
|
||||
* Signal, that value is updated by external code.
|
||||
*
|
||||
* Should be used together with getRef()
|
||||
*/
|
||||
public function touch()
|
||||
{
|
||||
$this->_memContainer->touch();
|
||||
}
|
||||
|
||||
/**
|
||||
* Lock object in memory.
|
||||
*/
|
||||
public function lock()
|
||||
{
|
||||
$this->_memContainer->lock();
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* Unlock object
|
||||
*/
|
||||
public function unlock()
|
||||
{
|
||||
$this->_memContainer->unlock();
|
||||
}
|
||||
|
||||
/**
|
||||
* Return true if object is locked
|
||||
*
|
||||
* @return boolean
|
||||
*/
|
||||
public function isLocked()
|
||||
{
|
||||
return $this->_memContainer->isLocked();
|
||||
}
|
||||
|
||||
/**
|
||||
* Get handler
|
||||
*
|
||||
* Loads object if necessary and moves it to the top of loaded objects list.
|
||||
* Swaps objects from the bottom of loaded objects list, if necessary.
|
||||
*
|
||||
* @param string $property
|
||||
* @return string
|
||||
* @throws Zend_Memory_Exception
|
||||
*/
|
||||
public function __get($property)
|
||||
{
|
||||
return $this->_memContainer->$property;
|
||||
}
|
||||
|
||||
/**
|
||||
* Set handler
|
||||
*
|
||||
* @param string $property
|
||||
* @param string $value
|
||||
* @throws Zend_Exception
|
||||
*/
|
||||
public function __set($property, $value)
|
||||
{
|
||||
$this->_memContainer->$property = $value;
|
||||
}
|
||||
}
|
||||
35
library/Zend/Memory/Container.php
Normal file
35
library/Zend/Memory/Container.php
Normal file
|
|
@ -0,0 +1,35 @@
|
|||
<?php
|
||||
/**
|
||||
* Zend Framework
|
||||
*
|
||||
* LICENSE
|
||||
*
|
||||
* This source file is subject to the new BSD license that is bundled
|
||||
* with this package in the file LICENSE.txt.
|
||||
* It is also available through the world-wide-web at this URL:
|
||||
* http://framework.zend.com/license/new-bsd
|
||||
* If you did not receive a copy of the license and are unable to
|
||||
* obtain it through the world-wide-web, please send an email
|
||||
* to license@zend.com so we can send you a copy immediately.
|
||||
*
|
||||
* @category Zend
|
||||
* @package Zend_Memory
|
||||
* @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
|
||||
* @license http://framework.zend.com/license/new-bsd New BSD License
|
||||
* @version $Id: Container.php 20096 2010-01-06 02:05:09Z bkarwin $
|
||||
*/
|
||||
|
||||
/** Zend_Memory_Container_Interface */
|
||||
require_once 'Zend/Memory/Container/Interface.php';
|
||||
|
||||
/**
|
||||
* Memory value container
|
||||
*
|
||||
* @category Zend
|
||||
* @package Zend_Memory
|
||||
* @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
|
||||
* @license http://framework.zend.com/license/new-bsd New BSD License
|
||||
*/
|
||||
abstract class Zend_Memory_Container implements Zend_Memory_Container_Interface
|
||||
{
|
||||
}
|
||||
66
library/Zend/Memory/Container/Interface.php
Normal file
66
library/Zend/Memory/Container/Interface.php
Normal file
|
|
@ -0,0 +1,66 @@
|
|||
<?php
|
||||
/**
|
||||
* Zend Framework
|
||||
*
|
||||
* LICENSE
|
||||
*
|
||||
* This source file is subject to the new BSD license that is bundled
|
||||
* with this package in the file LICENSE.txt.
|
||||
* It is also available through the world-wide-web at this URL:
|
||||
* http://framework.zend.com/license/new-bsd
|
||||
* If you did not receive a copy of the license and are unable to
|
||||
* obtain it through the world-wide-web, please send an email
|
||||
* to license@zend.com so we can send you a copy immediately.
|
||||
*
|
||||
* @category Zend
|
||||
* @package Zend_Memory
|
||||
* @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
|
||||
* @license http://framework.zend.com/license/new-bsd New BSD License
|
||||
* @version $Id: Interface.php 20096 2010-01-06 02:05:09Z bkarwin $
|
||||
*/
|
||||
|
||||
/**
|
||||
* Memory value container interface
|
||||
*
|
||||
* @category Zend
|
||||
* @package Zend_Memory
|
||||
* @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
|
||||
* @license http://framework.zend.com/license/new-bsd New BSD License
|
||||
*/
|
||||
interface Zend_Memory_Container_Interface
|
||||
{
|
||||
/**
|
||||
* Get string value reference
|
||||
*
|
||||
* _Must_ be used for value access before PHP v 5.2
|
||||
* or _may_ be used for performance considerations
|
||||
*
|
||||
* @return &string
|
||||
*/
|
||||
public function &getRef();
|
||||
|
||||
/**
|
||||
* Signal, that value is updated by external code.
|
||||
*
|
||||
* Should be used together with getRef()
|
||||
*/
|
||||
public function touch();
|
||||
|
||||
/**
|
||||
* Lock object in memory.
|
||||
*/
|
||||
public function lock();
|
||||
|
||||
/**
|
||||
* Unlock object
|
||||
*/
|
||||
public function unlock();
|
||||
|
||||
/**
|
||||
* Return true if object is locked
|
||||
*
|
||||
* @return boolean
|
||||
*/
|
||||
public function isLocked();
|
||||
}
|
||||
|
||||
113
library/Zend/Memory/Container/Locked.php
Normal file
113
library/Zend/Memory/Container/Locked.php
Normal file
|
|
@ -0,0 +1,113 @@
|
|||
<?php
|
||||
/**
|
||||
* Zend Framework
|
||||
*
|
||||
* LICENSE
|
||||
*
|
||||
* This source file is subject to the new BSD license that is bundled
|
||||
* with this package in the file LICENSE.txt.
|
||||
* It is also available through the world-wide-web at this URL:
|
||||
* http://framework.zend.com/license/new-bsd
|
||||
* If you did not receive a copy of the license and are unable to
|
||||
* obtain it through the world-wide-web, please send an email
|
||||
* to license@zend.com so we can send you a copy immediately.
|
||||
*
|
||||
* @category Zend
|
||||
* @package Zend_Memory
|
||||
* @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
|
||||
* @license http://framework.zend.com/license/new-bsd New BSD License
|
||||
* @version $Id: Locked.php 20096 2010-01-06 02:05:09Z bkarwin $
|
||||
*/
|
||||
|
||||
/** Zend_Memory_Container */
|
||||
require_once 'Zend/Memory/Container.php';
|
||||
|
||||
/**
|
||||
* Memory value container
|
||||
*
|
||||
* Locked (always stored in memory).
|
||||
*
|
||||
* @category Zend
|
||||
* @package Zend_Memory
|
||||
* @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
|
||||
* @license http://framework.zend.com/license/new-bsd New BSD License
|
||||
*/
|
||||
class Zend_Memory_Container_Locked extends Zend_Memory_Container
|
||||
{
|
||||
/**
|
||||
* Value object
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
public $value;
|
||||
|
||||
|
||||
/**
|
||||
* Object constructor
|
||||
*
|
||||
* @param Zend_Memory_Manager $memoryManager
|
||||
* @param integer $id
|
||||
* @param string $value
|
||||
*/
|
||||
public function __construct($value)
|
||||
{
|
||||
$this->value = $value;
|
||||
}
|
||||
|
||||
/**
|
||||
* Lock object in memory.
|
||||
*/
|
||||
public function lock()
|
||||
{
|
||||
/* Do nothing */
|
||||
}
|
||||
|
||||
/**
|
||||
* Unlock object
|
||||
*/
|
||||
public function unlock()
|
||||
{
|
||||
/* Do nothing */
|
||||
}
|
||||
|
||||
/**
|
||||
* Return true if object is locked
|
||||
*
|
||||
* @return boolean
|
||||
*/
|
||||
public function isLocked()
|
||||
{
|
||||
return true;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get string value reference
|
||||
*
|
||||
* _Must_ be used for value access before PHP v 5.2
|
||||
* or _may_ be used for performance considerations
|
||||
*
|
||||
* @return &string
|
||||
*/
|
||||
public function &getRef()
|
||||
{
|
||||
return $this->value;
|
||||
}
|
||||
|
||||
/**
|
||||
* Signal, that value is updated by external code.
|
||||
*
|
||||
* Should be used together with getRef()
|
||||
*/
|
||||
public function touch()
|
||||
{
|
||||
/* Do nothing */
|
||||
}
|
||||
|
||||
/**
|
||||
* Destroy memory container and remove it from memory manager list
|
||||
*/
|
||||
public function destroy()
|
||||
{
|
||||
/* Do nothing */
|
||||
}
|
||||
}
|
||||
297
library/Zend/Memory/Container/Movable.php
Normal file
297
library/Zend/Memory/Container/Movable.php
Normal file
|
|
@ -0,0 +1,297 @@
|
|||
<?php
|
||||
/**
|
||||
* Zend Framework
|
||||
*
|
||||
* LICENSE
|
||||
*
|
||||
* This source file is subject to the new BSD license that is bundled
|
||||
* with this package in the file LICENSE.txt.
|
||||
* It is also available through the world-wide-web at this URL:
|
||||
* http://framework.zend.com/license/new-bsd
|
||||
* If you did not receive a copy of the license and are unable to
|
||||
* obtain it through the world-wide-web, please send an email
|
||||
* to license@zend.com so we can send you a copy immediately.
|
||||
*
|
||||
* @category Zend
|
||||
* @package Zend_Memory
|
||||
* @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
|
||||
* @license http://framework.zend.com/license/new-bsd New BSD License
|
||||
* @version $Id: Movable.php 20096 2010-01-06 02:05:09Z bkarwin $
|
||||
*/
|
||||
|
||||
/** Zend_Memory_Container */
|
||||
require_once 'Zend/Memory/Container.php';
|
||||
|
||||
/** Zend_Memory_Value */
|
||||
require_once 'Zend/Memory/Value.php';
|
||||
|
||||
/**
|
||||
* Memory value container
|
||||
*
|
||||
* Movable (may be swapped with specified backend and unloaded).
|
||||
*
|
||||
* @category Zend
|
||||
* @package Zend_Memory
|
||||
* @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
|
||||
* @license http://framework.zend.com/license/new-bsd New BSD License
|
||||
*/
|
||||
class Zend_Memory_Container_Movable extends Zend_Memory_Container {
|
||||
/**
|
||||
* Internal object Id
|
||||
*
|
||||
* @var integer
|
||||
*/
|
||||
protected $_id;
|
||||
|
||||
/**
|
||||
* Memory manager reference
|
||||
*
|
||||
* @var Zend_Memory_Manager
|
||||
*/
|
||||
private $_memManager;
|
||||
|
||||
/**
|
||||
* Value object
|
||||
*
|
||||
* @var Zend_Memory_Value
|
||||
*/
|
||||
private $_value;
|
||||
|
||||
/** Value states */
|
||||
const LOADED = 1;
|
||||
const SWAPPED = 2;
|
||||
const LOCKED = 4;
|
||||
|
||||
/**
|
||||
* Value state (LOADED/SWAPPED/LOCKED)
|
||||
*
|
||||
* @var integer
|
||||
*/
|
||||
private $_state;
|
||||
|
||||
/**
|
||||
* Object constructor
|
||||
*
|
||||
* @param Zend_Memory_Manager $memoryManager
|
||||
* @param integer $id
|
||||
* @param string $value
|
||||
*/
|
||||
public function __construct(Zend_Memory_Manager $memoryManager, $id, $value)
|
||||
{
|
||||
$this->_memManager = $memoryManager;
|
||||
$this->_id = $id;
|
||||
$this->_state = self::LOADED;
|
||||
$this->_value = new Zend_Memory_Value($value, $this);
|
||||
}
|
||||
|
||||
/**
|
||||
* Lock object in memory.
|
||||
*/
|
||||
public function lock()
|
||||
{
|
||||
if ( !($this->_state & self::LOADED) ) {
|
||||
$this->_memManager->load($this, $this->_id);
|
||||
$this->_state |= self::LOADED;
|
||||
}
|
||||
|
||||
$this->_state |= self::LOCKED;
|
||||
|
||||
/**
|
||||
* @todo
|
||||
* It's possible to set "value" container attribute to avoid modification tracing, while it's locked
|
||||
* Check, if it's more effective
|
||||
*/
|
||||
}
|
||||
|
||||
/**
|
||||
* Unlock object
|
||||
*/
|
||||
public function unlock()
|
||||
{
|
||||
// Clear LOCKED state bit
|
||||
$this->_state &= ~self::LOCKED;
|
||||
}
|
||||
|
||||
/**
|
||||
* Return true if object is locked
|
||||
*
|
||||
* @return boolean
|
||||
*/
|
||||
public function isLocked()
|
||||
{
|
||||
return $this->_state & self::LOCKED;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get handler
|
||||
*
|
||||
* Loads object if necessary and moves it to the top of loaded objects list.
|
||||
* Swaps objects from the bottom of loaded objects list, if necessary.
|
||||
*
|
||||
* @param string $property
|
||||
* @return string
|
||||
* @throws Zend_Memory_Exception
|
||||
*/
|
||||
public function __get($property)
|
||||
{
|
||||
if ($property != 'value') {
|
||||
require_once 'Zend/Memory/Exception.php';
|
||||
throw new Zend_Memory_Exception('Unknown property: Zend_Memory_container::$' . $property);
|
||||
}
|
||||
|
||||
if ( !($this->_state & self::LOADED) ) {
|
||||
$this->_memManager->load($this, $this->_id);
|
||||
$this->_state |= self::LOADED;
|
||||
}
|
||||
|
||||
return $this->_value;
|
||||
}
|
||||
|
||||
/**
|
||||
* Set handler
|
||||
*
|
||||
* @param string $property
|
||||
* @param string $value
|
||||
* @throws Zend_Exception
|
||||
*/
|
||||
public function __set($property, $value)
|
||||
{
|
||||
if ($property != 'value') {
|
||||
require_once 'Zend/Memory/Exception.php';
|
||||
throw new Zend_Memory_Exception('Unknown property: Zend_Memory_container::$' . $property);
|
||||
}
|
||||
|
||||
$this->_state = self::LOADED;
|
||||
$this->_value = new Zend_Memory_Value($value, $this);
|
||||
|
||||
$this->_memManager->processUpdate($this, $this->_id);
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* Get string value reference
|
||||
*
|
||||
* _Must_ be used for value access before PHP v 5.2
|
||||
* or _may_ be used for performance considerations
|
||||
*
|
||||
* @return &string
|
||||
*/
|
||||
public function &getRef()
|
||||
{
|
||||
if ( !($this->_state & self::LOADED) ) {
|
||||
$this->_memManager->load($this, $this->_id);
|
||||
$this->_state |= self::LOADED;
|
||||
}
|
||||
|
||||
return $this->_value->getRef();
|
||||
}
|
||||
|
||||
/**
|
||||
* Signal, that value is updated by external code.
|
||||
*
|
||||
* Should be used together with getRef()
|
||||
*/
|
||||
public function touch()
|
||||
{
|
||||
$this->_memManager->processUpdate($this, $this->_id);
|
||||
}
|
||||
|
||||
/**
|
||||
* Process container value update.
|
||||
* Must be called only by value object
|
||||
*
|
||||
* @internal
|
||||
*/
|
||||
public function processUpdate()
|
||||
{
|
||||
// Clear SWAPPED state bit
|
||||
$this->_state &= ~self::SWAPPED;
|
||||
|
||||
$this->_memManager->processUpdate($this, $this->_id);
|
||||
}
|
||||
|
||||
/**
|
||||
* Start modifications trace
|
||||
*
|
||||
* @internal
|
||||
*/
|
||||
public function startTrace()
|
||||
{
|
||||
if ( !($this->_state & self::LOADED) ) {
|
||||
$this->_memManager->load($this, $this->_id);
|
||||
$this->_state |= self::LOADED;
|
||||
}
|
||||
|
||||
$this->_value->startTrace();
|
||||
}
|
||||
|
||||
/**
|
||||
* Set value (used by memory manager when value is loaded)
|
||||
*
|
||||
* @internal
|
||||
*/
|
||||
public function setValue($value)
|
||||
{
|
||||
$this->_value = new Zend_Memory_Value($value, $this);
|
||||
}
|
||||
|
||||
/**
|
||||
* Clear value (used by memory manager when value is swapped)
|
||||
*
|
||||
* @internal
|
||||
*/
|
||||
public function unloadValue()
|
||||
{
|
||||
// Clear LOADED state bit
|
||||
$this->_state &= ~self::LOADED;
|
||||
|
||||
$this->_value = null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Mark, that object is swapped
|
||||
*
|
||||
* @internal
|
||||
*/
|
||||
public function markAsSwapped()
|
||||
{
|
||||
// Clear LOADED state bit
|
||||
$this->_state |= self::LOADED;
|
||||
}
|
||||
|
||||
/**
|
||||
* Check if object is marked as swapped
|
||||
*
|
||||
* @internal
|
||||
* @return boolean
|
||||
*/
|
||||
public function isSwapped()
|
||||
{
|
||||
return $this->_state & self::SWAPPED;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get object id
|
||||
*
|
||||
* @internal
|
||||
* @return integer
|
||||
*/
|
||||
public function getId()
|
||||
{
|
||||
return $this->_id;
|
||||
}
|
||||
/**
|
||||
* Destroy memory container and remove it from memory manager list
|
||||
*
|
||||
* @internal
|
||||
*/
|
||||
public function destroy()
|
||||
{
|
||||
/**
|
||||
* We don't clean up swap because of performance considerations
|
||||
* Cleaning is performed by Memory Manager destructor
|
||||
*/
|
||||
|
||||
$this->_memManager->unlink($this, $this->_id);
|
||||
}
|
||||
}
|
||||
35
library/Zend/Memory/Exception.php
Normal file
35
library/Zend/Memory/Exception.php
Normal file
|
|
@ -0,0 +1,35 @@
|
|||
<?php
|
||||
/**
|
||||
* Zend Framework
|
||||
*
|
||||
* LICENSE
|
||||
*
|
||||
* This source file is subject to the new BSD license that is bundled
|
||||
* with this package in the file LICENSE.txt.
|
||||
* It is also available through the world-wide-web at this URL:
|
||||
* http://framework.zend.com/license/new-bsd
|
||||
* If you did not receive a copy of the license and are unable to
|
||||
* obtain it through the world-wide-web, please send an email
|
||||
* to license@zend.com so we can send you a copy immediately.
|
||||
*
|
||||
* @category Zend
|
||||
* @package Zend_Memory
|
||||
* @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
|
||||
* @version $Id: Exception.php 20096 2010-01-06 02:05:09Z bkarwin $
|
||||
* @license http://framework.zend.com/license/new-bsd New BSD License
|
||||
*/
|
||||
|
||||
|
||||
/** Zend_Controller_Exception */
|
||||
require_once 'Zend/Exception.php';
|
||||
|
||||
|
||||
/**
|
||||
* @category Zend
|
||||
* @package Zend_Memory
|
||||
* @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
|
||||
* @license http://framework.zend.com/license/new-bsd New BSD License
|
||||
*/
|
||||
class Zend_Memory_Exception extends Zend_Exception
|
||||
{}
|
||||
|
||||
463
library/Zend/Memory/Manager.php
Normal file
463
library/Zend/Memory/Manager.php
Normal file
|
|
@ -0,0 +1,463 @@
|
|||
<?php
|
||||
/**
|
||||
* Zend Framework
|
||||
*
|
||||
* LICENSE
|
||||
*
|
||||
* This source file is subject to the new BSD license that is bundled
|
||||
* with this package in the file LICENSE.txt.
|
||||
* It is also available through the world-wide-web at this URL:
|
||||
* http://framework.zend.com/license/new-bsd
|
||||
* If you did not receive a copy of the license and are unable to
|
||||
* obtain it through the world-wide-web, please send an email
|
||||
* to license@zend.com so we can send you a copy immediately.
|
||||
*
|
||||
* @category Zend
|
||||
* @package Zend_Memory
|
||||
* @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
|
||||
* @license http://framework.zend.com/license/new-bsd New BSD License
|
||||
* @version $Id: Manager.php 20096 2010-01-06 02:05:09Z bkarwin $
|
||||
*/
|
||||
|
||||
/** Zend_Memory_Container_Movable */
|
||||
require_once 'Zend/Memory/Container/Movable.php';
|
||||
|
||||
/** Zend_Memory_Container_Locked */
|
||||
require_once 'Zend/Memory/Container/Locked.php';
|
||||
|
||||
/** Zend_Memory_AccessController */
|
||||
require_once 'Zend/Memory/AccessController.php';
|
||||
|
||||
|
||||
/**
|
||||
* Memory manager
|
||||
*
|
||||
* This class encapsulates memory menagement operations, when PHP works
|
||||
* in limited memory mode.
|
||||
*
|
||||
*
|
||||
* @category Zend
|
||||
* @package Zend_Memory
|
||||
* @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
|
||||
* @license http://framework.zend.com/license/new-bsd New BSD License
|
||||
*/
|
||||
class Zend_Memory_Manager
|
||||
{
|
||||
/**
|
||||
* Object storage backend
|
||||
*
|
||||
* @var Zend_Cache_Backend_Interface
|
||||
*/
|
||||
private $_backend = null;
|
||||
|
||||
/**
|
||||
* Memory grow limit.
|
||||
* Default value is 2/3 of memory_limit php.ini variable
|
||||
* Negative value means no limit
|
||||
*
|
||||
* @var integer
|
||||
*/
|
||||
private $_memoryLimit = -1;
|
||||
|
||||
/**
|
||||
* Minimum value size to be swapped.
|
||||
* Default value is 16K
|
||||
* Negative value means that memory objects are never swapped
|
||||
*
|
||||
* @var integer
|
||||
*/
|
||||
private $_minSize = 16384;
|
||||
|
||||
/**
|
||||
* Overall size of memory, used by values
|
||||
*
|
||||
* @var integer
|
||||
*/
|
||||
private $_memorySize = 0;
|
||||
|
||||
/**
|
||||
* Id for next Zend_Memory object
|
||||
*
|
||||
* @var integer
|
||||
*/
|
||||
private $_nextId = 0;
|
||||
|
||||
/**
|
||||
* List of candidates to unload
|
||||
*
|
||||
* It also represents objects access history. Last accessed objects are moved to the end of array
|
||||
*
|
||||
* array(
|
||||
* <id> => <memory container object>,
|
||||
* ...
|
||||
* )
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
private $_unloadCandidates = array();
|
||||
|
||||
/**
|
||||
* List of object sizes.
|
||||
*
|
||||
* This list is used to calculate modification of object sizes
|
||||
*
|
||||
* array( <id> => <size>, ...)
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
private $_sizes = array();
|
||||
|
||||
/**
|
||||
* Last modified object
|
||||
*
|
||||
* It's used to reduce number of calls necessary to trace objects' modifications
|
||||
* Modification is not processed by memory manager until we do not switch to another
|
||||
* object.
|
||||
* So we have to trace only _first_ object modification and do nothing for others
|
||||
*
|
||||
* @var Zend_Memory_Container_Movable
|
||||
*/
|
||||
private $_lastModified = null;
|
||||
|
||||
/**
|
||||
* Unique memory manager id
|
||||
*
|
||||
* @var integer
|
||||
*/
|
||||
private $_managerId;
|
||||
|
||||
/**
|
||||
* Tags array, used by backend to categorize stored values
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
private $_tags;
|
||||
|
||||
/**
|
||||
* This function is intended to generate unique id, used by memory manager
|
||||
*/
|
||||
private function _generateMemManagerId()
|
||||
{
|
||||
/**
|
||||
* @todo !!!
|
||||
* uniqid() php function doesn't really garantee the id to be unique
|
||||
* it should be changed by something else
|
||||
* (Ex. backend interface should be extended to provide this functionality)
|
||||
*/
|
||||
$this->_managerId = uniqid('ZendMemManager', true);
|
||||
$this->_tags = array($this->_managerId);
|
||||
$this->_managerId .= '_';
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* Memory manager constructor
|
||||
*
|
||||
* If backend is not specified, then memory objects are never swapped
|
||||
*
|
||||
* @param Zend_Cache_Backend $backend
|
||||
* @param array $backendOptions associative array of options for the corresponding backend constructor
|
||||
*/
|
||||
public function __construct($backend = null)
|
||||
{
|
||||
if ($backend === null) {
|
||||
return;
|
||||
}
|
||||
|
||||
$this->_backend = $backend;
|
||||
$this->_generateMemManagerId();
|
||||
|
||||
$memoryLimitStr = trim(ini_get('memory_limit'));
|
||||
if ($memoryLimitStr != '' && $memoryLimitStr != -1) {
|
||||
$this->_memoryLimit = (integer)$memoryLimitStr;
|
||||
switch (strtolower($memoryLimitStr[strlen($memoryLimitStr)-1])) {
|
||||
case 'g':
|
||||
$this->_memoryLimit *= 1024;
|
||||
// Break intentionally omitted
|
||||
case 'm':
|
||||
$this->_memoryLimit *= 1024;
|
||||
// Break intentionally omitted
|
||||
case 'k':
|
||||
$this->_memoryLimit *= 1024;
|
||||
break;
|
||||
|
||||
default:
|
||||
break;
|
||||
}
|
||||
|
||||
$this->_memoryLimit = (int)($this->_memoryLimit*2/3);
|
||||
} // No limit otherwise
|
||||
}
|
||||
|
||||
/**
|
||||
* Object destructor
|
||||
*
|
||||
* Clean up backend storage
|
||||
*/
|
||||
public function __destruct()
|
||||
{
|
||||
if ($this->_backend !== null) {
|
||||
$this->_backend->clean(Zend_Cache::CLEANING_MODE_MATCHING_TAG, $this->_tags);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Set memory grow limit
|
||||
*
|
||||
* @param integer $newLimit
|
||||
* @throws Zend_Exception
|
||||
*/
|
||||
public function setMemoryLimit($newLimit)
|
||||
{
|
||||
$this->_memoryLimit = $newLimit;
|
||||
|
||||
$this->_swapCheck();
|
||||
}
|
||||
|
||||
/**
|
||||
* Get memory grow limit
|
||||
*
|
||||
* @return integer
|
||||
*/
|
||||
public function getMemoryLimit()
|
||||
{
|
||||
return $this->_memoryLimit;
|
||||
}
|
||||
|
||||
/**
|
||||
* Set minimum size of values, which may be swapped
|
||||
*
|
||||
* @param integer $newSize
|
||||
*/
|
||||
public function setMinSize($newSize)
|
||||
{
|
||||
$this->_minSize = $newSize;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get minimum size of values, which may be swapped
|
||||
*
|
||||
* @return integer
|
||||
*/
|
||||
public function getMinSize()
|
||||
{
|
||||
return $this->_minSize;
|
||||
}
|
||||
|
||||
/**
|
||||
* Create new Zend_Memory value container
|
||||
*
|
||||
* @param string $value
|
||||
* @return Zend_Memory_Container_Interface
|
||||
* @throws Zend_Memory_Exception
|
||||
*/
|
||||
public function create($value = '')
|
||||
{
|
||||
return $this->_create($value, false);
|
||||
}
|
||||
|
||||
/**
|
||||
* Create new Zend_Memory value container, which has value always
|
||||
* locked in memory
|
||||
*
|
||||
* @param string $value
|
||||
* @return Zend_Memory_Container_Interface
|
||||
* @throws Zend_Memory_Exception
|
||||
*/
|
||||
public function createLocked($value = '')
|
||||
{
|
||||
return $this->_create($value, true);
|
||||
}
|
||||
|
||||
/**
|
||||
* Create new Zend_Memory object
|
||||
*
|
||||
* @param string $value
|
||||
* @param boolean $locked
|
||||
* @return Zend_Memory_Container_Interface
|
||||
* @throws Zend_Memory_Exception
|
||||
*/
|
||||
private function _create($value, $locked)
|
||||
{
|
||||
$id = $this->_nextId++;
|
||||
|
||||
if ($locked || ($this->_backend === null) /* Use only memory locked objects if backend is not specified */) {
|
||||
return new Zend_Memory_Container_Locked($value);
|
||||
}
|
||||
|
||||
// Commit other objects modifications
|
||||
$this->_commit();
|
||||
|
||||
$valueObject = new Zend_Memory_Container_Movable($this, $id, $value);
|
||||
|
||||
// Store last object size as 0
|
||||
$this->_sizes[$id] = 0;
|
||||
// prepare object for next modifications
|
||||
$this->_lastModified = $valueObject;
|
||||
|
||||
return new Zend_Memory_AccessController($valueObject);
|
||||
}
|
||||
|
||||
/**
|
||||
* Unlink value container from memory manager
|
||||
*
|
||||
* Used by Memory container destroy() method
|
||||
*
|
||||
* @internal
|
||||
* @param integer $id
|
||||
* @return Zend_Memory_Container
|
||||
*/
|
||||
public function unlink(Zend_Memory_Container_Movable $container, $id)
|
||||
{
|
||||
if ($this->_lastModified === $container) {
|
||||
// Drop all object modifications
|
||||
$this->_lastModified = null;
|
||||
unset($this->_sizes[$id]);
|
||||
return;
|
||||
}
|
||||
|
||||
if (isset($this->_unloadCandidates[$id])) {
|
||||
unset($this->_unloadCandidates[$id]);
|
||||
}
|
||||
|
||||
$this->_memorySize -= $this->_sizes[$id];
|
||||
unset($this->_sizes[$id]);
|
||||
}
|
||||
|
||||
/**
|
||||
* Process value update
|
||||
*
|
||||
* @internal
|
||||
* @param Zend_Memory_Container_Movable $container
|
||||
* @param integer $id
|
||||
*/
|
||||
public function processUpdate(Zend_Memory_Container_Movable $container, $id)
|
||||
{
|
||||
/**
|
||||
* This method is automatically invoked by memory container only once per
|
||||
* "modification session", but user may call memory container touch() method
|
||||
* several times depending on used algorithm. So we have to use this check
|
||||
* to optimize this case.
|
||||
*/
|
||||
if ($container === $this->_lastModified) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Remove just updated object from list of candidates to unload
|
||||
if( isset($this->_unloadCandidates[$id])) {
|
||||
unset($this->_unloadCandidates[$id]);
|
||||
}
|
||||
|
||||
// Reduce used memory mark
|
||||
$this->_memorySize -= $this->_sizes[$id];
|
||||
|
||||
// Commit changes of previously modified object if necessary
|
||||
$this->_commit();
|
||||
|
||||
$this->_lastModified = $container;
|
||||
}
|
||||
|
||||
/**
|
||||
* Commit modified object and put it back to the loaded objects list
|
||||
*/
|
||||
private function _commit()
|
||||
{
|
||||
if (($container = $this->_lastModified) === null) {
|
||||
return;
|
||||
}
|
||||
|
||||
$this->_lastModified = null;
|
||||
|
||||
$id = $container->getId();
|
||||
|
||||
// Calculate new object size and increase used memory size by this value
|
||||
$this->_memorySize += ($this->_sizes[$id] = strlen($container->getRef()));
|
||||
|
||||
if ($this->_sizes[$id] > $this->_minSize) {
|
||||
// Move object to "unload candidates list"
|
||||
$this->_unloadCandidates[$id] = $container;
|
||||
}
|
||||
|
||||
$container->startTrace();
|
||||
|
||||
$this->_swapCheck();
|
||||
}
|
||||
|
||||
/**
|
||||
* Check and swap objects if necessary
|
||||
*
|
||||
* @throws Zend_MemoryException
|
||||
*/
|
||||
private function _swapCheck()
|
||||
{
|
||||
if ($this->_memoryLimit < 0 || $this->_memorySize < $this->_memoryLimit) {
|
||||
// Memory limit is not reached
|
||||
// Do nothing
|
||||
return;
|
||||
}
|
||||
|
||||
// walk through loaded objects in access history order
|
||||
foreach ($this->_unloadCandidates as $id => $container) {
|
||||
$this->_swap($container, $id);
|
||||
unset($this->_unloadCandidates[$id]);
|
||||
|
||||
if ($this->_memorySize < $this->_memoryLimit) {
|
||||
// We've swapped enough objects
|
||||
return;
|
||||
}
|
||||
}
|
||||
|
||||
require_once 'Zend/Memory/Exception.php';
|
||||
throw new Zend_Memory_Exception('Memory manager can\'t get enough space.');
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* Swap object data to disk
|
||||
* Actualy swaps data or only unloads it from memory,
|
||||
* if object is not changed since last swap
|
||||
*
|
||||
* @param Zend_Memory_Container_Movable $container
|
||||
* @param integer $id
|
||||
*/
|
||||
private function _swap(Zend_Memory_Container_Movable $container, $id)
|
||||
{
|
||||
if ($container->isLocked()) {
|
||||
return;
|
||||
}
|
||||
|
||||
if (!$container->isSwapped()) {
|
||||
$this->_backend->save($container->getRef(), $this->_managerId . $id, $this->_tags);
|
||||
}
|
||||
|
||||
$this->_memorySize -= $this->_sizes[$id];
|
||||
|
||||
$container->markAsSwapped();
|
||||
$container->unloadValue();
|
||||
}
|
||||
|
||||
/**
|
||||
* Load value from swap file.
|
||||
*
|
||||
* @internal
|
||||
* @param Zend_Memory_Container_Movable $container
|
||||
* @param integer $id
|
||||
*/
|
||||
public function load(Zend_Memory_Container_Movable $container, $id)
|
||||
{
|
||||
$value = $this->_backend->load($this->_managerId . $id, true);
|
||||
|
||||
// Try to swap other objects if necessary
|
||||
// (do not include specified object into check)
|
||||
$this->_memorySize += strlen($value);
|
||||
$this->_swapCheck();
|
||||
|
||||
// Add loaded obect to the end of loaded objects list
|
||||
$container->setValue($value);
|
||||
|
||||
if ($this->_sizes[$id] > $this->_minSize) {
|
||||
// Add object to the end of "unload candidates list"
|
||||
$this->_unloadCandidates[$id] = $container;
|
||||
}
|
||||
}
|
||||
}
|
||||
177
library/Zend/Memory/Value.php
Normal file
177
library/Zend/Memory/Value.php
Normal file
|
|
@ -0,0 +1,177 @@
|
|||
<?php
|
||||
/**
|
||||
* Zend Framework
|
||||
*
|
||||
* LICENSE
|
||||
*
|
||||
* This source file is subject to the new BSD license that is bundled
|
||||
* with this package in the file LICENSE.txt.
|
||||
* It is also available through the world-wide-web at this URL:
|
||||
* http://framework.zend.com/license/new-bsd
|
||||
* If you did not receive a copy of the license and are unable to
|
||||
* obtain it through the world-wide-web, please send an email
|
||||
* to license@zend.com so we can send you a copy immediately.
|
||||
*
|
||||
* @category Zend
|
||||
* @package Zend_Memory
|
||||
* @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
|
||||
* @license http://framework.zend.com/license/new-bsd New BSD License
|
||||
* @version $Id: Value.php 20096 2010-01-06 02:05:09Z bkarwin $
|
||||
*/
|
||||
|
||||
|
||||
/**
|
||||
* String value object
|
||||
*
|
||||
* It's an OO string wrapper.
|
||||
* Used to intercept string updates.
|
||||
*
|
||||
* @category Zend
|
||||
* @package Zend_Memory
|
||||
* @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
|
||||
* @license http://framework.zend.com/license/new-bsd New BSD License
|
||||
* @todo also implement Countable for PHP 5.1 but not yet to stay 5.0 compatible
|
||||
*/
|
||||
class Zend_Memory_Value implements ArrayAccess {
|
||||
/**
|
||||
* Value
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
private $_value;
|
||||
|
||||
/**
|
||||
* Container
|
||||
*
|
||||
* @var Zend_Memory_Container_Interface
|
||||
*/
|
||||
private $_container;
|
||||
|
||||
/**
|
||||
* Boolean flag which signals to trace value modifications
|
||||
*
|
||||
* @var boolean
|
||||
*/
|
||||
private $_trace;
|
||||
|
||||
|
||||
/**
|
||||
* Object constructor
|
||||
*
|
||||
* @param string $value
|
||||
* @param Zend_Memory_Container_Movable $container
|
||||
*/
|
||||
public function __construct($value, Zend_Memory_Container_Movable $container)
|
||||
{
|
||||
$this->_container = $container;
|
||||
|
||||
$this->_value = (string)$value;
|
||||
|
||||
/**
|
||||
* Object is marked as just modified by memory manager
|
||||
* So we don't need to trace followed object modifications and
|
||||
* object is processed (and marked as traced) when another
|
||||
* memory object is modified.
|
||||
*
|
||||
* It reduces overall numberr of calls necessary to modification trace
|
||||
*/
|
||||
$this->_trace = false;
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* ArrayAccess interface method
|
||||
* returns true if string offset exists
|
||||
*
|
||||
* @param integer $offset
|
||||
* @return boolean
|
||||
*/
|
||||
public function offsetExists($offset)
|
||||
{
|
||||
return $offset >= 0 && $offset < strlen($this->_value);
|
||||
}
|
||||
|
||||
/**
|
||||
* ArrayAccess interface method
|
||||
* Get character at $offset position
|
||||
*
|
||||
* @param integer $offset
|
||||
* @return string
|
||||
*/
|
||||
public function offsetGet($offset)
|
||||
{
|
||||
return $this->_value[$offset];
|
||||
}
|
||||
|
||||
/**
|
||||
* ArrayAccess interface method
|
||||
* Set character at $offset position
|
||||
*
|
||||
* @param integer $offset
|
||||
* @param string $char
|
||||
*/
|
||||
public function offsetSet($offset, $char)
|
||||
{
|
||||
$this->_value[$offset] = $char;
|
||||
|
||||
if ($this->_trace) {
|
||||
$this->_trace = false;
|
||||
$this->_container->processUpdate();
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* ArrayAccess interface method
|
||||
* Unset character at $offset position
|
||||
*
|
||||
* @param integer $offset
|
||||
*/
|
||||
public function offsetUnset($offset)
|
||||
{
|
||||
unset($this->_value[$offset]);
|
||||
|
||||
if ($this->_trace) {
|
||||
$this->_trace = false;
|
||||
$this->_container->processUpdate();
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* To string conversion
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function __toString()
|
||||
{
|
||||
return $this->_value;
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* Get string value reference
|
||||
*
|
||||
* _Must_ be used for value access before PHP v 5.2
|
||||
* or _may_ be used for performance considerations
|
||||
*
|
||||
* @internal
|
||||
* @return string
|
||||
*/
|
||||
public function &getRef()
|
||||
{
|
||||
return $this->_value;
|
||||
}
|
||||
|
||||
/**
|
||||
* Start modifications trace
|
||||
*
|
||||
* _Must_ be used for value access before PHP v 5.2
|
||||
* or _may_ be used for performance considerations
|
||||
*
|
||||
* @internal
|
||||
*/
|
||||
public function startTrace()
|
||||
{
|
||||
$this->_trace = true;
|
||||
}
|
||||
}
|
||||
Loading…
Add table
Add a link
Reference in a new issue