MaplePHP Cache, a clean and user-friendly caching library. MaplePHP Cache is designed to provide a seamless caching experience with simplicity and ease of use as its core principles. Whether you're familiar with PSR-6 or PSR-16, this library offers a smooth and intuitive caching solution for your PHP applications.
composer require maplephp/cache Start with initiate the MaplePHP Cache class and pass on a Handler to it.
use MaplePHP\Cache\Cache; use MaplePHP\Cache\Handlers\FileSystemHandler; $cache = new Cache(new FileSystemHandler(dirname(__FILE__)."/storage/cache"));It is super easy to use
$expireInOneHour = 3600; // 3600 seconds = 1 hour if(!$cache->has("test") && $cache->set("test", "Lorem ipsum dolor", $expireInOneHour)) { echo "Cache has been set<br>"; } echo "Get cache: ".$cache->get("test");While not required, it is advisable to handle critical throwable errors that may occur, such as an invalid cache key, insufficient file permissions, or possible connection issues with a cache server. Logging these exceptions can be beneficial for error tracking and troubleshooting purposes.
$cache = new Cache(new FileSystemHandler(dirname(__FILE__))); try { // Invalid key set print_r($cache->get("te st")); } catch (Exception $e) { // Will trigger: Invalid cache key. Only alphanumeric characters, underscores, and dots are allowed. echo $e->getMessage(); }Save cache as a file on you system.
Arg1: (string) Path to directory where you want to save the cache fiels
use MaplePHP\Cache\Handlers\FileSystemHandler; $fileSystem = new FileSystemHandler(dirname(__FILE__)."/storage/cache");Use Memcached to save cache in memory (high performance)
Arg1: (string|array) Host to server (or get default with class constant "MemcachedHandler::HOST")
Arg2: (int|null) Port to server (or get default with class constant "MemcachedHandler::PORT")
Arg3: (int) Weight to server (Arg is default 0 but you can also set it with default with class constant "MemcachedHandler::WEIGHT")
use MaplePHP\Cache\Handlers\MemcachedHandler; // One server $memcached = new MemcachedHandler(MemcachedHandler::HOST, MemcachedHandler::PORT, MemcachedHandler::WEIGHT); // Multiple servers $memcached = new MemcachedHandler([ ["Memcached.server1.com", 11211, 1], // Weight "1" (this server has priority) ["Memcached.server2.com", 11212, 2], ["Memcached.server3.com", 11300, 3] ]);Can return mixed values if successful if miss then return default value. The default value is not required and is by default null.
$cache->get("test", "Default value");Will return bool
$cache->has("test");It is allowed to set cache values of mixed types like strings, arrays and including PSR-7: HTTP Streams. Will return bool.
// Set cache with 1 hour lifetime $cache->set("test", "Lorem ipsum dolor", 3600); // Set cache that will persist $cache->set("test2", "Lorem ipsum dolor");Will return bool
$cache->delete("test");Will return bool
$cache->clear();Will return array with mixed values if successful, if miss then return default value. The default value is not required and is by default null.
$cache->getMultiple(["test1", "test2"], "Default value");Will return bool
$cache->setMultiple(["test1" => "Lorem", "test2" => "Ipsum"], 3600);Will return bool
$cache->deleteMultiple(["test1", "test2"]);If your application needs advanced caching features, hierarchical caching, or cache tagging, PSR-6 is a more suitable choice.
use MaplePHP\Cache\Handlers\FileSystemHandler; $cache = new FileSystemHandler(dirname(__FILE__)."/storage/cache"); $item = $cache->getItem('test'); try { if(!$item->isHit()) { $item->set(["Lorem 1", "Lorem 2"])->expiresAfter(3600); $cache->save($item); echo "Insert to cache: "; print_r($item->get()); } else { echo "Read from cache: "; print_r($item->get()); } } catch (Exception $e) { echo $e->getMessage(); }