1<?php 2 3/** 4 * SimplePie 5 * 6 * A PHP-Based RSS and Atom Feed Framework. 7 * Takes the hard work out of managing a complete RSS/Atom solution. 8 * 9 * Copyright (c) 2004-2022, Ryan Parman, Sam Sneddon, Ryan McCue, and contributors 10 * All rights reserved. 11 * 12 * Redistribution and use in source and binary forms, with or without modification, are 13 * permitted provided that the following conditions are met: 14 * 15 * * Redistributions of source code must retain the above copyright notice, this list of 16 * conditions and the following disclaimer. 17 * 18 * * Redistributions in binary form must reproduce the above copyright notice, this list 19 * of conditions and the following disclaimer in the documentation and/or other materials 20 * provided with the distribution. 21 * 22 * * Neither the name of the SimplePie Team nor the names of its contributors may be used 23 * to endorse or promote products derived from this software without specific prior 24 * written permission. 25 * 26 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS 27 * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY 28 * AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS 29 * AND CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 30 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 31 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 32 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR 33 * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 34 * POSSIBILITY OF SUCH DAMAGE. 35 * 36 * @package SimplePie 37 * @copyright 2004-2016 Ryan Parman, Sam Sneddon, Ryan McCue 38 * @author Ryan Parman 39 * @author Sam 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 45namespace SimplePie\Cache; 46 47use Memcached as NativeMemcached; 48 49/** 50 * Caches data to memcached 51 * 52 * Registered for URLs with the "memcached" protocol 53 * 54 * For example, `memcached://localhost:11211/?timeout=3600&prefix=sp_` will 55 * connect to memcached on `localhost` on port 11211. All tables will be 56 * prefixed with `sp_` and data will expire after 3600 seconds 57 * 58 * @package SimplePie 59 * @subpackage Caching 60 * @author Paul L. McNeely 61 * @uses Memcached 62 * @deprecated since SimplePie 1.8.0, use implementation of "Psr\SimpleCache\CacheInterface" instead 63 */ 64class Memcached implements Base 65{ 66 /** 67 * NativeMemcached instance 68 * @var NativeMemcached 69 */ 70 protected $cache; 71 72 /** 73 * Options 74 * @var array 75 */ 76 protected $options; 77 78 /** 79 * Cache name 80 * @var string 81 */ 82 protected $name; 83 84 /** 85 * Create a new cache object 86 * @param string $location Location string (from SimplePie::$cache_location) 87 * @param string $name Unique ID for the cache 88 * @param Base::TYPE_FEED|Base::TYPE_IMAGE $type Either TYPE_FEED for SimplePie data, or TYPE_IMAGE for image data 89 */ 90 public function __construct($location, $name, $type) 91 { 92 $this->options = [ 93 'host' => '127.0.0.1', 94 'port' => 11211, 95 'extras' => [ 96 'timeout' => 3600, // one hour 97 'prefix' => 'simplepie_', 98 ], 99 ]; 100 $this->options = array_replace_recursive($this->options, \SimplePie\Cache::parse_URL($location)); 101 102 $this->name = $this->options['extras']['prefix'] . md5("$name:$type"); 103 104 $this->cache = new NativeMemcached(); 105 $this->cache->addServer($this->options['host'], (int)$this->options['port']); 106 } 107 108 /** 109 * Save data to the cache 110 * @param array|\SimplePie\SimplePie $data Data to store in the cache. If passed a SimplePie object, only cache the $data property 111 * @return bool Successfulness 112 */ 113 public function save($data) 114 { 115 if ($data instanceof \SimplePie\SimplePie) { 116 $data = $data->data; 117 } 118 119 return $this->setData(serialize($data)); 120 } 121 122 /** 123 * Retrieve the data saved to the cache 124 * @return array Data for SimplePie::$data 125 */ 126 public function load() 127 { 128 $data = $this->cache->get($this->name); 129 130 if ($data !== false) { 131 return unserialize($data); 132 } 133 return false; 134 } 135 136 /** 137 * Retrieve the last modified time for the cache 138 * @return int Timestamp 139 */ 140 public function mtime() 141 { 142 $data = $this->cache->get($this->name . '_mtime'); 143 return (int) $data; 144 } 145 146 /** 147 * Set the last modified time to the current time 148 * @return bool Success status 149 */ 150 public function touch() 151 { 152 $data = $this->cache->get($this->name); 153 return $this->setData($data); 154 } 155 156 /** 157 * Remove the cache 158 * @return bool Success status 159 */ 160 public function unlink() 161 { 162 return $this->cache->delete($this->name, 0); 163 } 164 165 /** 166 * Set the last modified time and data to NativeMemcached 167 * @return bool Success status 168 */ 169 private function setData($data) 170 { 171 if ($data !== false) { 172 $this->cache->set($this->name . '_mtime', time(), (int)$this->options['extras']['timeout']); 173 return $this->cache->set($this->name, $data, (int)$this->options['extras']['timeout']); 174 } 175 176 return false; 177 } 178} 179 180class_alias('SimplePie\Cache\Memcached', 'SimplePie_Cache_Memcached'); 181