PHPackages                             emilio/php-cache - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Caching](/categories/caching)
4. /
5. emilio/php-cache

ActiveLibrary[Caching](/categories/caching)

emilio/php-cache
================

Minimal caching library

9156PHP

Since Jan 4Pushed 9y ago2 watchersCompare

[ Source](https://github.com/emilio/php-cache)[ Packagist](https://packagist.org/packages/emilio/php-cache)[ RSS](/packages/emilio-php-cache/feed)WikiDiscussions master Synced 4w ago

READMEChangelogDependenciesVersions (2)Used By (0)

PHP filesystem backed cache
===========================

[](#php-filesystem-backed-cache)

This class provides an easy fs-backed cache.

[Read more (es)](http://emiliocobos.net/php-cache/) | [Contributors](https://github.com/ecoal95/php-cache/graphs/contributors)

Starting
--------

[](#starting)

You can see an easy example in the `examples/` dir.

You can also install this package with `composer`.

Configuration
-------------

[](#configuration)

There are two main options: `cache_path` y `expires`.

- `cache_path` is the directory where cache will be stored. It's a relative directory by default (`cache`), but it's recommendable to re-configure it.
- `expires` is the cache expiration time **in minutes**.

**Important**: `cache_path` should be writable (that's obvious), but if it's public in the server, which is not recommended, you should forbid access to it.

A way to do it for Apache is having a `.htaccess` as follows in the cache dir:

```
deny from all

```

Usage
-----

[](#usage)

To store any data type you should use the `put` method using an identifier, and the value.

```
Cache::put('key', 'value');
```

### Retrieving data

[](#retrieving-data)

To get data stored in the cache you should use:

```
Cache::get('key');
```

If the item is not found, or it's expired, it will return `null`.

#### Raw data

[](#raw-data)

You can store and retrieve raw data, to prevent decoding and encoding overhead.

You should specify it's raw data in both `put()` and `get()`, as follows:

```
Cache::put($key, $big_chunk_of_data, true);
// ...
Cache::get($key, true);
```

### Deleting data

[](#deleting-data)

You may delete a single item from de cache using the `delete()` method:

```
Cache::delete($key);
```

You may also flush all the cache to delete everything:

```
Cache::flush();
```

Race conditions
---------------

[](#race-conditions)

This library makes atomic writes via `rename`, so no race condition should be possible.

Performance
-----------

[](#performance)

There are some benchmarks over the `benchmarks/` directory.

They're simple ones and you're encouraged to write more extensive ones. In general, **the performance difference compared with memcached or apc is almost unnoticeable with large chunks of data, but it's relatively high with small data fragments**. That's expected due to the fs access overhead.

There are also legacy tests by a contributor in the `legacy-tests` folder which test performance and race-condition ressistance.

###  Health Score

25

—

LowBetter than 35% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity15

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 77.8% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/4107d42878755124aba7539042ce67899caf85b4e47b35f0fd5c39bba8a28fad?d=identicon)[ecoal95](/maintainers/ecoal95)

---

Top Contributors

[![emilio](https://avatars.githubusercontent.com/u/1323194?v=4)](https://github.com/emilio "emilio (21 commits)")[![logicaalternativa](https://avatars.githubusercontent.com/u/4106207?v=4)](https://github.com/logicaalternativa "logicaalternativa (5 commits)")[![Sloy](https://avatars.githubusercontent.com/u/545251?v=4)](https://github.com/Sloy "Sloy (1 commits)")

### Embed Badge

![Health badge](/badges/emilio-php-cache/health.svg)

```
[![Health](https://phpackages.com/badges/emilio-php-cache/health.svg)](https://phpackages.com/packages/emilio-php-cache)
```

###  Alternatives

[beryllium/cachebundle

Provides an interface to Memcache for Symfony2 applications

32136.0k](/packages/beryllium-cachebundle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)