[TOC] ## 概述 PSR-6 已經解決了這個問題，但是在一些簡單的用例中顯得過于繁瑣。這個標準為大部分情況構建更加簡單的接口標準。它獨立于 PSR-6，但盡可能的兼容 PSR-6 ## 安裝 ``` composer require psr/SimpleCache ``` ## 接口 <details> <summary>Psr\SimpleCache\CacheInterface </summary> ``` <?php namespace Psr\SimpleCache; interface CacheInterface { /** * 從緩存中取出值 * * @param string $key 該項在緩存中唯一的key值 * @param mixed $default key不存在時，返回的默認值 * * @return mixed 從緩存中返回的值，或者是不存在時的默認值 * * @throws \Psr\SimpleCache\InvalidArgumentException * 如果給定的key不是一個合法的字符串時，拋出該異常 */ public function get($key, $default = null); /** * 存儲值在cache中，唯一關鍵到一個key及一個可選的存在時間 * * @param string $key 存儲項目的key. * @param mixed $value 存儲的值，必須可以被序列化的 * @param null|int|\DateInterval $ttl 可選項.項目的存在時間，如果該值沒有設置，且驅動支持生存時間時，將設置一個默認值，或者驅自行處理。 * * @return bool true 存儲成功 false 存儲失敗 * * @throws \Psr\SimpleCache\InvalidArgumentException * 如果給定的key不是一個合法的字符串時，拋出該異常。 */ public function set($key, $value, $ttl = null); /** * 刪除指定鍵值的緩存項 * * @param string $key 指定的唯一緩存key對應的項目將會被刪除 * * @return bool 成功刪除時返回ture，有其它錯誤時時返回false * * @throws \Psr\SimpleCache\InvalidArgumentException * 如果給定的key不是一個合法的字符串時，拋出該異常。 */ public function delete($key); /** * 清除所有緩存中的key * * @return bool 成功返回True.失敗返回False */ public function clear(); /** * 根據指定的緩存鍵值列表獲取得多個緩存項目 * * @param iterable $keys 在單次操作中可被獲取的鍵值項 * @param mixed $default 如果key不存在時，返回的默認值 * * @return iterable 返回鍵值對（key=>value形式）列表。如果key不存在，或者已經過期時，返回默認值。 * * @throws \Psr\SimpleCache\InvalidArgumentException * 如果給定的keys既不是合法的數組，也不可以被轉成數組，或者給得的任何一個key不是一個合法的值時，拖出該異常。 */ public function getMultiple($keys, $default = null); /** * 存儲一個鍵值對形式的集合到緩存中。 * * @param iterable $values 一系列操作的鍵值對列表 * @param null|int|\DateInterval $ttl 可選項.項目的存在時間，如果該值沒有設置，且驅動支持生存時間時，將設置一個默認值，或者驅自行處理。 * * @return bool 成功返回True.失敗返回False. * * @throws \Psr\SimpleCache\InvalidArgumentException * 如果給定的keys既不是合法的數組，也不可以被轉成數組，或者給得的任何一個key不是一個合法的值時，拖出該異常. */ public function setMultiple($values, $ttl = null); /** * 單次操作刪除多個緩存項目. * * @param iterable $keys 一個基于字符串鍵列表會被刪除 * * @return bool True 所有項目都成功被刪除時回true,有任何錯誤時返回false * * @throws \Psr\SimpleCache\InvalidArgumentException * 如果給定的keys既不是合法的數組，也不可以被轉成數組，或者給得的任何一個key不是一個合法的值時，拖出該異常. */ public function deleteMultiple($keys); /** * 判斷一個項目在緩存中是否存在 * * 注意: has()方法僅僅在緩存預熱的場景被推薦使用且不允許的活躍 * 的應用中場景中對get/set方法使用, 因為方法受競態條件的限制，當 * 你調用has()方法時會立即返回true。另一個腳本可以刪除它，使應 * 用狀態過期。 * @param string $key 緩存鍵值 * * @return bool * * @throws \Psr\SimpleCache\InvalidArgumentException * 如果給定的key不是一個合法的字符串時，拋出該異常. */ public function has($key); } ``` </details> <br /> <details> <summary>Psr\SimpleCache\CacheException</summary> ``` <?php namespace Psr\SimpleCache; /** * 庫拋出異常的接口，用于所有類型異常。 */ interface CacheException { } ``` </details> <br /> <details> <summary>Psr\SImpleCache\InvalidArgumentException </summary> ``` <?php namespace Psr\SimpleCache; /** * 無效緩存參數異常的接口。 * * 當傳遞一個無效參數時，必須拋出一個實現了此接口的異常。 */ interface InvalidArgumentException extends CacheException { } ``` </details> <br />