Store.php

TLDR

This file contains the interface Store defined within the Illuminate\Contracts\Cache namespace. The interface defines methods for retrieving, storing, incrementing, decrementing, forever storing, and removing items from the cache. It also includes a method to retrieve the cache key prefix.

Methods

get

Retrieves an item from the cache based on the given key.

many

Retrieves multiple items from the cache based on an array of keys. Items not found in the cache will have a null value.

put

Stores an item in the cache for a given number of seconds.

putMany

Stores multiple items in the cache for a given number of seconds.

increment

Increments the value of an item in the cache.

decrement

Decrements the value of an item in the cache.

forever

Stores an item in the cache indefinitely.

forget

Removes an item from the cache based on the given key.

flush

Removes all items from the cache.

getPrefix

Returns the cache key prefix.

<?php

namespace Illuminate\Contracts\Cache;

interface Store
{
    /**
     * Retrieve an item from the cache by key.
     *
     * @param  string|array  $key
     * @return mixed
     */
    public function get($key);

    /**
     * Retrieve multiple items from the cache by key.
     *
     * Items not found in the cache will have a null value.
     *
     * @param  array  $keys
     * @return array
     */
    public function many(array $keys);

    /**
     * Store an item in the cache for a given number of seconds.
     *
     * @param  string  $key
     * @param  mixed  $value
     * @param  int  $seconds
     * @return bool
     */
    public function put($key, $value, $seconds);

    /**
     * Store multiple items in the cache for a given number of seconds.
     *
     * @param  array  $values
     * @param  int  $seconds
     * @return bool
     */
    public function putMany(array $values, $seconds);

    /**
     * Increment the value of an item in the cache.
     *
     * @param  string  $key
     * @param  mixed  $value
     * @return int|bool
     */
    public function increment($key, $value = 1);

    /**
     * Decrement the value of an item in the cache.
     *
     * @param  string  $key
     * @param  mixed  $value
     * @return int|bool
     */
    public function decrement($key, $value = 1);

    /**
     * Store an item in the cache indefinitely.
     *
     * @param  string  $key
     * @param  mixed  $value
     * @return bool
     */
    public function forever($key, $value);

    /**
     * Remove an item from the cache.
     *
     * @param  string  $key
     * @return bool
     */
    public function forget($key);

    /**
     * Remove all items from the cache.
     *
     * @return bool
     */
    public function flush();

    /**
     * Get the cache key prefix.
     *
     * @return string
     */
    public function getPrefix();
}