Extends CacheException with \Throwable interface. With PHP 5 backward compatibility.

A do an error on pull request : https://github.com/php-fig/simple-cache/pull/12 ; sorry ;)

This PR fixes type-hint for DateInterval, which should be marked as class from global namespace with leading backslash (\) otherwise IDE assumes it refers to Psr\SimpleCache\DateInterval, which does not exist.

In addition basic class PHPDoc for CacheInterface provided to be consistent with interface definitions from other PSRs.

Just like the logging library I suggest to add a NullCache implementation in order to avoid conditional cache calls.

https://github.com/php-fig/log/blob/master/Psr/Log/NullLogger.php

• Remove CounterInterface from this spec
• Add CacheException & InvalidArgumentException interfaces
• Return success status (bool) on delete, clear & deleteMultiple
• Introduce a default value for getMultiple
• Various documentation clarifications

Included in this PR are two commits, proposing:

v1.1 for PHP 7.2+ with parameter types (PHP 7.2 the first version with parameter type widening to prevent bc breaks) v1.2 for PHP 8 with union parameter types and mixed type

I partly expect this to maybe be closed as this change makes it harder to determine if some code actually implements PSR-16, but:

Background for this was I found myself in position where I only needed single cache methods (get, set, delete) and clear() for a internal in-memory class and was thinking there might be value in having a PSR interface to implement for it, if someone would find themselves in position where they'd like a different behaviour.

I also see possible value in having a separate interface for clear(), as it is something we need for any classes holding some sort of objects in memory (for cases we deem safe) to avoid re-loading the given object repeatedly.

Hello, can you please release this fix as 1.0.2?

This is a fix for PHP 7.4

Static analysators (PHPStan) returns error for @throws doc that Psr\SimpleCache\InvalidArgumentException is not subtype of Throwable

This issue is already fixed in v2 and v3, but they are also using union types, which breaks PHP 7.4

(unfortunately updating project to 8.0+ is not under my control)

I was looking at the dependency graph of some of my applications and I noticed I was mostly depending on psr/simple-cache:^1.0. I knew about the introduction of version 2.0.0 and 3.0.0 and of the rationale behind having a separate 2.0.0 and 3.0.0 branch. What I had forgotten was exactly what the difference was between those two. Typically a changelog is a central location to see the changes per release. This repository was missing that changelog. I took the liberty of creating one.

• Introduce CHANGELOG.md, populated with the releases starting with 1.0.0. The format is based on Keep a Changelog and the changelog from psr/cache.

What: Standardizes the README file providing a common language and an implementation link.

Why: There are differences between PSR's READMEs in regarding language and the lacking of implementations references. So I've updated all READMEs using the https://github.com/php-fig/http-factory as base.

Per this thread, I understand that tool support is not a concern or priority for the FIG, so I don't expect this PR will be merged - a replacement package with corrected type-hints has been published and can be installed as mindplay/simple-cache now.