1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188
|
<?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_Serializer
* @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: Serializer.php 20575 2010-01-24 17:48:27Z mabe $
*/
/** @see Zend_Loader_PluginLoader */
require_once 'Zend/Loader/PluginLoader.php';
/**
* @category Zend
* @package Zend_Serializer
* @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_Serializer
{
/**
* Plugin loader to load adapter.
*
* @var null|Zend_Loader_PluginLoader
*/
private static $_adapterLoader = null;
/**
* The default adapter.
*
* @var string|Zend_Serializer_AdapterInterface
*/
protected static $_defaultAdapter = 'PhpSerialize';
/**
* Create a serializer adapter instance.
*
* @param string|Zend_Serializer_Adapter_AdapterInterface $adapterName Name of the adapter class
* @param array |Zend_Config $opts Serializer options
* @return Zend_Serializer_Adapter_AdapterInterface
*/
public static function factory($adapterName, $opts = array())
{
if ($adapterName instanceof Zend_Serializer_Adapter_AdapterInterface) {
return $adapterName; // $adapterName is already an adapter object
}
$adapterLoader = self::getAdapterLoader();
try {
$adapterClass = $adapterLoader->load($adapterName);
} catch (Exception $e) {
require_once 'Zend/Serializer/Exception.php';
throw new Zend_Serializer_Exception('Can\'t load serializer adapter "'.$adapterName.'"', 0, $e);
}
// ZF-8842:
// check that the loaded class implements Zend_Serializer_Adapter_AdapterInterface without execute code
if (!in_array('Zend_Serializer_Adapter_AdapterInterface', class_implements($adapterClass))) {
require_once 'Zend/Serializer/Exception.php';
throw new Zend_Serializer_Exception('The serializer adapter class "'.$adapterClass.'" must implement Zend_Serializer_Adapter_AdapterInterface');
}
return new $adapterClass($opts);
}
/**
* Get the adapter plugin loader.
*
* @return Zend_Loader_PluginLoader
*/
public static function getAdapterLoader()
{
if (self::$_adapterLoader === null) {
self::$_adapterLoader = self::_getDefaultAdapterLoader();
}
return self::$_adapterLoader;
}
/**
* Change the adapter plugin load.
*
* @param Zend_Loader_PluginLoader $pluginLoader
* @return void
*/
public static function setAdapterLoader(Zend_Loader_PluginLoader $pluginLoader)
{
self::$_adapterLoader = $pluginLoader;
}
/**
* Resets the internal adapter plugin loader
*
* @return Zend_Loader_PluginLoader
*/
public static function resetAdapterLoader()
{
self::$_adapterLoader = self::_getDefaultAdapterLoader();
return self::$_adapterLoader;
}
/**
* Returns a default adapter plugin loader
*
* @return Zend_Loader_PluginLoader
*/
protected static function _getDefaultAdapterLoader()
{
$loader = new Zend_Loader_PluginLoader();
$loader->addPrefixPath('Zend_Serializer_Adapter', dirname(__FILE__).'/Serializer/Adapter');
return $loader;
}
/**
* Change the default adapter.
*
* @param string|Zend_Serializer_Adapter_AdapterInterface $adapter
* @param array|Zend_Config $options
*/
public static function setDefaultAdapter($adapter, $options = array())
{
self::$_defaultAdapter = self::factory($adapter, $options);
}
/**
* Get the default adapter.
*
* @return Zend_Serializer_Adapter_AdapterInterface
*/
public static function getDefaultAdapter()
{
if (!self::$_defaultAdapter instanceof Zend_Serializer_Adapter_AdapterInterface) {
self::setDefaultAdapter(self::$_defaultAdapter);
}
return self::$_defaultAdapter;
}
/**
* Generates a storable representation of a value using the default adapter.
*
* @param mixed $value
* @param array $options
* @return string
* @throws Zend_Serializer_Exception
*/
public static function serialize($value, array $options = array())
{
if (isset($options['adapter'])) {
$adapter = self::factory($options['adapter']);
unset($options['adapter']);
} else {
$adapter = self::getDefaultAdapter();
}
return $adapter->serialize($value, $options);
}
/**
* Creates a PHP value from a stored representation using the default adapter.
*
* @param string $serialized
* @param array $options
* @return mixed
* @throws Zend_Serializer_Exception
*/
public static function unserialize($serialized, array $options = array())
{
if (isset($options['adapter'])) {
$adapter = self::factory($options['adapter']);
unset($options['adapter']);
} else {
$adapter = self::getDefaultAdapter();
}
return $adapter->unserialize($serialized, $options);
}
}
|