1: <?php
  2: /**
  3:  * SimplePie
  4:  *
  5:  * A PHP-Based RSS and Atom Feed Framework.
  6:  * Takes the hard work out of managing a complete RSS/Atom solution.
  7:  *
  8:  * Copyright (c) 2004-2012, Ryan Parman, Geoffrey Sneddon, Ryan McCue, and contributors
  9:  * All rights reserved.
 10:  *
 11:  * Redistribution and use in source and binary forms, with or without modification, are
 12:  * permitted provided that the following conditions are met:
 13:  *
 14:  *  * Redistributions of source code must retain the above copyright notice, this list of
 15:  *    conditions and the following disclaimer.
 16:  *
 17:  *  * Redistributions in binary form must reproduce the above copyright notice, this list
 18:  *    of conditions and the following disclaimer in the documentation and/or other materials
 19:  *    provided with the distribution.
 20:  *
 21:  *  * Neither the name of the SimplePie Team nor the names of its contributors may be used
 22:  *    to endorse or promote products derived from this software without specific prior
 23:  *    written permission.
 24:  *
 25:  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS
 26:  * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
 27:  * AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS
 28:  * AND CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 29:  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
 30:  * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 31:  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
 32:  * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 33:  * POSSIBILITY OF SUCH DAMAGE.
 34:  *
 35:  * @package SimplePie
 36:  * @version 1.3
 37:  * @copyright 2004-2012 Ryan Parman, Geoffrey Sneddon, Ryan McCue
 38:  * @author Ryan Parman
 39:  * @author Geoffrey Sneddon
 40:  * @author Ryan McCue
 41:  * @link http://simplepie.org/ SimplePie
 42:  * @license http://www.opensource.org/licenses/bsd-license.php BSD License
 43:  */
 44: 
 45: /**
 46:  * Used to create cache objects
 47:  *
 48:  * This class can be overloaded with {@see SimplePie::set_cache_class()},
 49:  * although the preferred way is to create your own handler
 50:  * via {@see register()}
 51:  *
 52:  * @package SimplePie
 53:  * @subpackage Caching
 54:  */
 55: class SimplePie_Cache
 56: {
 57:     /**
 58:      * Cache handler classes
 59:      *
 60:      * These receive 3 parameters to their constructor, as documented in
 61:      * {@see register()}
 62:      * @var array
 63:      */
 64:     protected static $handlers = array(
 65:         'mysql' => 'SimplePie_Cache_MySQL',
 66:         'memcache' => 'SimplePie_Cache_Memcache',
 67:     );
 68: 
 69:     /**
 70:      * Don't call the constructor. Please.
 71:      */
 72:     private function __construct() { }
 73: 
 74:     /**
 75:      * Create a new SimplePie_Cache object
 76:      *
 77:      * @param string $location URL location (scheme is used to determine handler)
 78:      * @param string $filename Unique identifier for cache object
 79:      * @param string $extension 'spi' or 'spc'
 80:      * @return SimplePie_Cache_Base Type of object depends on scheme of `$location`
 81:      */
 82:     public static function create($location, $filename, $extension)
 83:     {
 84:         $type = explode(':', $location, 2);
 85:         $type = $type[0];
 86:         if (!empty(self::$handlers[$type]))
 87:         {
 88:             $class = self::$handlers[$type];
 89:             return new $class($location, $filename, $extension);
 90:         }
 91: 
 92:         return new SimplePie_Cache_File($location, $filename, $extension);
 93:     }
 94: 
 95:     /**
 96:      * Register a handler
 97:      *
 98:      * @param string $type DSN type to register for
 99:      * @param string $class Name of handler class. Must implement SimplePie_Cache_Base
100:      */
101:     public static function register($type, $class)
102:     {
103:         self::$handlers[$type] = $class;
104:     }
105: 
106:     /**
107:      * Parse a URL into an array
108:      *
109:      * @param string $url
110:      * @return array
111:      */
112:     public static function parse_URL($url)
113:     {
114:         $params = parse_url($url);
115:         $params['extras'] = array();
116:         if (isset($params['query']))
117:         {
118:             parse_str($params['query'], $params['extras']);
119:         }
120:         return $params;
121:     }
122: }
123: