【PHP】PSR-6 Caching Interface（キャッシングインターフェイス）

$o == unserialize(serialize($o))

<?php

namespace Psr\Cache;

/**
 * CacheItemInterface
 * キャッシュ内のオブジェクトと対話するためのインターフェイスを定義する
 */
interface CacheItemInterface
{
    /**
     * 現在のキャッシュ項目のキーを返します。
     * キーは実装ライブラリによってロードされますが、
     * 必要に応じて上位の呼び出し元が使用できるようにする必要があります。
     *
     * @return string このキャッシュ項目のキー文字列。
     */
    public function getKey();

    /**
     * このオブジェクトのキーに関連付けられたキャッシュから項目の値を取得します。
     * 返される値は、もともとset（）によって格納された値と同じでなければなりません。
     * isHit（）がfalseを返す場合、このメソッドはnullを返す必要があります。
     * nullは正当なキャッシュされた値なので、
     * "null値が見つかりました"
     * と
     * "値が見つかりませんでした"
     * を区別するためにisHit（）メソッドを使用する必要があります。
     *
     * @return mixed
     *   このキャッシュアイテムのキーに対応する値。見つからない場合はnull
     */
    public function get();

    /**
     * キャッシュ項目検索でキャッシュヒットが発生したかどうかを確認します。
     * 注意：このメソッドは、isHit（）の呼び出しとget（）の呼び出しの間に
     * 競合条件を持つものであってはなりません。
     *
     * @return bool
     *   要求がキャッシュヒットになった場合はtrue。 そうでなければFalse。
     */
    public function isHit();

    /**
     * このキャッシュアイテムによって表される値を設定します。
     * 引数$valueはPHPによってシリアライズできる項目ですが、
     * 直列化の方法はImplementing Libraryに任されています。
     *
     * @param mixed $value
     *   シリアライズ可能な値を格納します。
     *
     * @return static
     *   呼び出されたオブジェクト。
     */
    public function set($value);

    /**
     * このキャッシュ項目の有効期限を設定します。
     *
     * @param \DateTimeInterface|null $expiration
     *   項目が期限切れとみなされる必要がある時点。
     *   nullが明示的に渡された場合、デフォルト値が使用されます。
     *   どれも設定されていない場合、値は永続的に、
     *   または実装が許す限り長く保存する必要があります。
     *
     * @return static
     *   呼び出されたオブジェクト。
     */
    public function expiresAt($expiration);

    /**
     * Sets the expiration time for this cache item.
     *
     * @param int|\DateInterval|null $time
     *   アイテムが期限切れとみなされる必要がある現在からの期間。
     *   整数パラメータは、有効期限までの秒単位の時間と解釈されます。
     *   nullが明示的に渡された場合、デフォルト値が使用されます。
     *   どれも設定されていない場合、値は永続的に、または実装が許す限り長く保存する必要があります。
     *
     * @return static
     *   呼び出されたオブジェクト。
     */
    public function expiresAfter($time);
}

<?php

namespace Psr\Cache;

/**
 * CacheItemPoolInterface
 * CacheItemInterfaceオブジェクトを生成します。
 */
interface CacheItemPoolInterface
{
    /**
     * 指定されたキーを表すキャッシュ項目を返します。
     * このメソッドは、キャッシュミスの場合でも常に
     * CacheItemInterfaceオブジェクトを返す必要があります。
     * nullを返さないでください。
     *
     * @param string $key
     *   対応するキャッシュ項目を返すキー
     *
     * @throws InvalidArgumentException
     *   $key文字列が正当な値でない場合、
     *   \Psr\Cache\InvalidArgumentException
     *   がスローされなければなりません。
     *
     * @return CacheItemInterface
     *   対応するキャッシュ項目
     */
    public function getItem($key);

    /**
     * トラバース可能なキャッシュ項目のをセット返します。
     *
     * @param string[] $keys
     *   取得する項目のキーのインデックス付き配列
     *
     * @throws InvalidArgumentException
     *   $keysのいずれかのキーが正当な値でない場合、
     *   \Psr\Cache\InvalidArgumentException
     *   がスローされなければなりません。
     *
     * @return array|\Traversable
     *   各アイテムのキャッシュキーによってキーされた
     *   キャッシュアイテムのトラバース可能なコレクション。
     *   そのキーが見つからない場合でも、各キーのキャッシュ
     *   項目が返されます。
     *   ただし、キーが指定されていない場合は、
     *   代わりに空のトラバーサルを返す必要があります。
     */
    public function getItems(array $keys = array());

    /**
     * キャッシュに指定されたキャッシュ項目が含まれているかどうかを確認します。
     *
     * 注意：この方法では、パフォーマンス上の理由からキャッシュされた値を取得
     * することを避けることができます。 これにより、CacheItemInterface::get()
     * との競合状態が発生する可能性があります。
     * このような状況を回避するには、代わりにCacheItemInterface::isHit()を使用します。
     *
     * @param string $key
     *   存在を確認するためのキー
     *
     * @throws InvalidArgumentException
     *   $key文字列が正当な値でない場合
     *   \Psr\Cache\InvalidArgumentException
     *   をスローする必要があります。
     *
     * @return bool
     *   アイテムがキャッシュに存在する場合はtrue、そうでない場合はfalse
     */
    public function hasItem($key);

    /**
     * プール内のすべてのアイテムを削除します。
     *
     * @return bool
     *   プールが正常にクリアされた場合はtrue。
     *   エラーがあった場合はFalseを返します。
     */
    public function clear();

    /**
     * アイテムをプールから削除します。
     *
     * @param string $key
     *   削除するキー
     *
     * @throws InvalidArgumentException
     *   $key文字列が正当な値でない場合
     *   \Psr\Cache\InvalidArgumentException
     *   をスローする必要があります。
     *
     * @return bool
     *   項目が正常に削除された場合はtrue。
     *   エラーがあった場合はFalseを返します。
     */
    public function deleteItem($key);

    /**
     * プールから複数のアイテムを削除します。
     *
     * @param string[] $keys
     *   プールから削除する必要があるキーの配列。
     *
     * @throws InvalidArgumentException
     *   $keysのいずれかのキーが正当な値でない場合、
     *   \Psr\Cache\InvalidArgumentException
     *   がスローされなければなりません。
     *
     * @return bool
     *   アイテムが正常に削除された場合はtrue。
     *   エラーがあった場合はFalseを返します。
     */
    public function deleteItems(array $keys);

    /**
     * キャッシュ項目を保持します。
     *
     * @param CacheItemInterface $item
     *   保存するキャッシュ項目。
     *
     * @return bool
     *   項目が正常に永続化された場合はtrue。
     *   エラーがあった場合はFalseを返します。
     */
    public function save(CacheItemInterface $item);

    /**
     * 後で永続化されるキャッシュ項目を設定します。
     *
     * @param CacheItemInterface $item
     *   保存するキャッシュ項目。
     *
     * @return bool
     *   アイテムがキューに入れられなかった場合、
     *   またはコミットが試行され失敗した場合はFalse。
     *   そうでなければtrue。
     */
    public function saveDeferred(CacheItemInterface $item);

    /**
     * すべての遅延キャッシュ項目を保持します。
     *
     * @return bool
     *   保存されていないアイテムがすべて正常に保存された場合、
     *   または保存されていないアイテムがある場合はTrue。
     *   そうでなければFalse。
     */
    public function commit();
}

<?php

namespace Psr\Cache;

/**
 * 実装ライブラリによってスローされる
 * すべての例外に対する例外インタフェース。
 */
interface CacheException
{
}

<?php

namespace Psr\Cache;

/**
 * 無効なキャッシュ引数の例外インタフェース。
 *
 * 無効な引数がメソッドに渡されると、
 * Psr\Cache\InvalidArgumentException
 * を実装する例外クラスをスローする必要があります。
 */
interface InvalidArgumentException extends CacheException
{
}