Vectorface\Cache\CacheHelper

Complexity

Total Complexity

6

Size/Duplication

Total Lines	52
Duplicated Lines	0 %

Test Coverage

Coverage

90.91%

Importance

Changes	3
Bugs	0	Features	1

2 Methods

Rating	Name	Duplication	Size	Complexity
A	runCallback()	0	6	3
A	fetch()	0	11	3

<?php

namespace Vectorface\Cache;

/**
 * Class with a few methods that may assist in implementing item caching.
 */
class CacheHelper
{
    /**
     * Implement the mechanics of caching the result of a heavy function call.
     *
     * For example, if one has a function like so:
     * public static function getLargeDatasetFromDB($arg1, $arg2) {
     *     // Lots of SQL/compute
     *     return $giantDataSet;
     * }
     *
     * One could cache this by adding cache calls to the top/bottom. CacheHelper::fetch can automatate this:
     *
     * function getLargeDataset($arg1, $arg2) {
     *     $key = "SomeClass::LargeDataset($arg1,$arg2)";
     *     $cache = new APCCache();
     *     return CacheHelper::fetch($cache, $key, [SomeClass, 'getLargeDatasetFromDB'], [$arg1, $arg2], 600);
     * }
     *
     * @param Cache $cache The cache from/to which the values should be retrieved/set.
     * @param string $key The cache key which should store the value.
     * @param callable $callback A callable which is expected to return a value to be cached.
     * @param mixed[] $args The arguments to be passed to the callback, if it needs to be called.
     * @param int $ttl If a value is to be set in the cache, set this expiry time (in seconds).
     * @return mixed The value stored in the cache, or returned by the callback.
     */
    public static function fetch(Cache $cache, string $key, callable $callback, array $args = [], $ttl = 300)
    {
        $item = $cache->get($key);
        if ($item === null) {
            $item = static::runCallback($callback, $args);

            if (isset($item)) {
                $cache->set($key, $item, $ttl);
            }
        }
        return $item;
    }

    /**
     * Run the callback, normalizing the arguments.
     *
     * @param callable $callback The callable to be executed to fetch the value the cache.
     * @param mixed[] $args The argument(s) to the callback function.
     * @return mixed The value returned by the callback.
     */
    protected static function runCallback($callback, $args)
    {
        if (!is_array($args)) {

The condition is_array($args) is always true.

            $args = isset($args) ? [$args] : [];
        }
        return call_user_func_array($callback, $args);
    }
}