Skip to content

Lite & fast micro PHP cache library that is **easy to use**.

License

Notifications You must be signed in to change notification settings

utopia-php/cache

Folders and files

NameName
Last commit message
Last commit date
Mar 24, 2024
Apr 17, 2025
Apr 17, 2025
Mar 21, 2022
Oct 8, 2021
Oct 8, 2021
Nov 5, 2024
Nov 5, 2024
Nov 5, 2024
May 2, 2021
Jun 2, 2024
Apr 17, 2025
Apr 17, 2025
Oct 31, 2024
Oct 29, 2022
Oct 24, 2020

Repository files navigation

Utopia Cache

Build Status Total Downloads Discord

Utopia framework cache library is simple and lite library for managing application cache storing, loading and purging. This library is aiming to be as simple and easy to learn and use. This library is maintained by the Appwrite team.

Although this library is part of the Utopia Framework project it is dependency free and can be used as standalone with any other PHP project or framework.

Getting Started

Install using composer:

composer require utopia-php/cache

File System Adapter

<?php

require_once __DIR__ . '/../../vendor/autoload.php';

use Utopia\Cache\Cache;
use Utopia\Cache\Adapter\Filesystem;

$cache  = new Cache(new Filesystem('/cache-dir'));
$key    = 'data-from-example.com';

$data   = $cache->load($key, 60 * 60 * 24 * 30 * 3 /* 3 months */);

if(!$data) {
    $data = file_get_contents('https://example.com');
    
    $cache->save($key, $data);
}

echo $data;

Contribute

Currently we support only a Filesystem adapter for usage as a cache storage, send a pull request to add redis, memcached or any other storage adapter you might need to use with this library.

System Requirements

Utopia Framework requires PHP 8.0 or later. We recommend using the latest PHP version whenever possible.

Tests

To run all unit tests, use the following Docker command:

docker compose exec tests vendor/bin/phpunit --configuration phpunit.xml tests

To run static code analysis, use the following Psalm command:

docker-compose exec php8 vendor/bin/psalm --show-info=true

Copyright and license

The MIT License (MIT) http://www.opensource.org/licenses/mit-license.php