Transient.php

<?php

namespace AC;

use LogicException;

class Transient implements Expirable
{

    /**
     * @var Storage\Option
     */
    protected $option;

    /**
     * @var Storage\Timestamp
     */
    protected $timestamp;

    public function __construct(string $key, bool $network_only = false)
    {
        $option_factory = $network_only
            ? new Storage\NetworkOptionFactory()
            : new Storage\OptionFactory();

        $this->option = $option_factory->create($key);
        $this->timestamp = new Storage\Timestamp(
            $option_factory->create($key . '_timestamp')
        );
    }

    public function is_expired(int $timestamp = null): bool
    {
        return $this->timestamp->is_expired($timestamp);
    }

    public function has_expiration_time(): bool
    {
        return false !== $this->timestamp->get();
    }

    /**
     * @return mixed
     */
    public function get()
    {
        return $this->option->get();
    }

    public function delete(): void
    {
        $this->option->delete();
        $this->timestamp->delete();
    }

    /**
     * @param mixed $data
     * @param int   $expiration Time until expiration in seconds.
     *
     * @return bool
     * @throws LogicException
     */
    public function save($data, int $expiration): bool
    {
        // Always store timestamp before option data.
        $this->timestamp->save(time() + $expiration);

        return $this->option->save($data);
    }

}