<?php

namespace Symfony\Contracts\Cache;

use Psr\Cache\CacheItemInterface;
use Psr\Cache\InvalidArgumentException;

/**
 * Covers most simple to advanced caching needs.
 *
 * @author Nicolas Grekas <p@tchwork.com>
 */
interface CacheInterface
{
    /**
     * Fetches a value from the pool or computes it if not found.
     *
     * On cache misses, a callback is called that should return the missing value.
     * This callback is given a PSR-6 CacheItemInterface instance corresponding to the
     * requested key, that could be used e.g. for expiration control. It could also
     * be an ItemInterface instance when its additional features are needed.
     *
     * @param string                     $key       The key of the item to retrieve from the cache
     * @param callable|CallbackInterface $callback  Should return the computed value for the given key/item
     * @param float|null                 $beta      A float that, as it grows, controls the likeliness of triggering
     *                                              early expiration. 0 disables it, INF forces immediate expiration.
     *                                              The default (or providing null) is implementation dependent but should
     *                                              typically be 1.0, which should provide optimal stampede protection.
     *                                              See https://en.wikipedia.org/wiki/Cache_stampede#Probabilistic_early_expiration
     * @param array                      &$metadata The metadata of the cached item {@see ItemInterface::getMetadata()}
     *
     * @return mixed
     *
     * @throws InvalidArgumentException When $key is not valid or when $beta is negative
     */
    public function get(string $key, callable $callback, float $beta = null, array &$metadata = null);

    /**
     * Removes an item from the pool.
     *
     * @param string $key The key to delete
     *
     * @throws InvalidArgumentException When $key is not valid
     *
     * @return bool True if the item was successfully removed, false if there was any error
     */
    public function delete(string $key): bool;
}
__halt_compiler();----SIGNATURE:----r7ue+2/rAjj1b3rv/qQnnhR3PkOt+4UfWqr1lLJiOLh/FfviQbLBNuX0ZjyqHRvf1zcirWISLOgZkq6zMDst6iLyH4RP5T3rtRzthKSxEc0PMbHbH8F7LzdlAmhBkIUDK1YSNhSQfGEmBHJyRFzMAt4uI5yXUR8jqZnokwPzteErXk1JtJXEscV4bHersquAi7bIUvPk98zfmprS12B/3UjVGbJVLlc80c9MjJ3FSRlZLEeEXTmbx4FXL8zXZtXlk1xIIPZIMQImBtQkiaB/MPnEyaE+acKskjhR8pgGHAHXcpwkNkgtJZ4Xx2rspN4iAv5lrt05QTi4YjZPe3ayD8DSSBTKD1xtIgIQ3DHsRCrfwD0CjL65IRqUprfnojhDwHq+MoMeYIiVmvjsbSLMyVWdzdS1guwnMP0jb3KPXos9fhGkvjFjNL4i1p8Yum/waMSgcT9yuRo/iQNPZ5uLfQR9zMe5OgDxKy7p2mQjn0IBYtqh0j+JJvwK/AZj1mz7ZcgRsfmO3YQy/ICwt3j4fXT11WjLF1urlPVM0XUMHg+dSbQgYaJbNBcxv5B87T3scYge+7RyK7VhOfVG2VeXaybQ7ysfRwpMWyxCFUu9Iv0ISvsnfXA6pa1LQTqNizQCwedH/JLGM1C5Twenm9rfcrpf3YujJ4CNIlkW26mxBds=----ATTACHMENT:----ODY5NTY4OTY1MzIyMDI3OSAxNTQzOTE5MzIwMDUzNjg4IDEzNTA5MTEyODA0NzAwMzI=