### Release Notes for [4.0.4](https://github.com/laminas/laminas-cach…

…e/milestone/62)

### 4.0.4

- Total issues resolved: **0**
- Total pull requests resolved: **3**
- Total contributors: **1**

#### Documentation

 - [328: Add new `max_items` `Memory` adapter option](#328) thanks to @boesing
 - [327: Add new `FilesystemOptions` related to `Filesystem` v3.0](#327) thanks to @boesing
 - [326: Update documentation to reflect most recent changes regarding v4 and adapters](#326) thanks to @boesing

### Release Notes for [4.0.3](https://github.com/laminas/laminas-cach…

…e/milestone/61)

### 4.0.3

- Total issues resolved: **0**
- Total pull requests resolved: **1**
- Total contributors: **1**

#### Bug

 - [322: Add adapter options template to StorageInterface usage](#322) thanks to @boesing

### Release Notes for [4.0.2](https://github.com/laminas/laminas-cach…

…e/milestone/60)

4.0.x bugfix release (patch)

### 4.0.2

- Total issues resolved: **0**
- Total pull requests resolved: **1**
- Total contributors: **1**

#### Bug

 - [321: Add adapter options template to `StorageInterface` usage](#321) thanks to @boesing

### Release Notes for [4.0.1](https://github.com/laminas/laminas-cach…

…e/milestone/57)

4.0.x bugfix release (patch)

### 4.0.1

- Total issues resolved: **0**
- Total pull requests resolved: **1**
- Total contributors: **1**

#### Bug

 - [319: Add missing template param for `StorageInterface`](#319) thanks to @boesing

### Release Notes for [4.0.0](https://github.com/laminas/laminas-cach…

…e/milestone/11)

`laminas-cache` 4.0.0 is here and finally adds native types **everywhere**, adds support for `psr/cache` and `psr/simple-cache` v2 & v3 and introduces an all new metadata logic which allows adapters to provide metadata they actually support.

Please read more on how to migrate your project in our [migration guideline](https://github.com/laminas/laminas-cache/blob/5fc9681221c9120adeb091e084524e953e1434a0/docs/book/v4/migration/to-version-4.md).

### Added
- Every adapter which supports `metadata` now implements `MetadataCapableInterface` and provides a dedicated object containing all the metadata values it supports
- Adds support for `psr/cache` and `psr/simple-cache` v2 & v3

### Removed
- `supportedMetadata` capability from `Capabilities`
- `KeyListIterator::CURRENT_AS_METADATA` mode along with `Laminas\Cache\Exception\MissingKeyException`
- automatic instantiation of `SerializerInterface` when calling `PluginOptions#getSerializer`
- Increment and decrement feature from `StorageInterface`, so there is no more `StorageInterface#incrementItem`, `StorageInterface#decrementItem`, `StorageInterface#decrementItems` and `StorageInterface#incrementItems`
  - this also removes `incrementItem`, `incrementItems`, `decrementItem`, `derementItems` events (`pre`, `post` and `exception`)
- dependency inversion on virtual package `laminas/laminas-cache-storage-adapter-implementation` which now allows `laminas-cache` to be required without a concrete storage adapter implementation
- removed support for `psr/cache` and `psr/simple-cache` v1

### Breaking Changes
- `AbstractAdapter` and `StorageInterface` are not aware of the methods `getMetadata` anymore. These were moved to the new `MetadataCapableInterface`
- `Capabilities` do not provide `supportedMetadata` anymore. The supported metadata is tied to the used storage adapter and thus, was already requiring projects to explicitly know the exact implementation of the cache backend in case of using these metadatas anyway
- `KeyListIterator` and the corresponding `IteratorInterface` does not provide the `mode` `CURRENT_AS_METADATA` anymore
- `PluginOptions#getSerializer` does not create a serializer anymore if a `string` option was passed, instead, the `string` is returned
- Increment and decrement feature was removed from `StorageInterface`, so there is no more `StorageInterface#incrementItem`, `StorageInterface#decrementItem`, `StorageInterface#decrementItems` and `StorageInterface#incrementItems`
  - this also removes `incrementItem`, `incrementItems`, `decrementItem`, `derementItems` events (`pre`, `post` and `exception`)
- Every method now has native return types
- Every property now has native types
- Every method argument now has native types
- `ObjectCache` does not inherit the `CallbackCache` pattern anymore

### 4.0.0

- Total issues resolved: **9**
- Total pull requests resolved: **18**
- Total contributors: **4**

#### BC Break,Enhancement

 - [317: Allow integer keys for some more methods](#317) thanks to @boesing
 - [310: Enhance type strictness and add `final` to a bunch of classes](#310) thanks to @boesing
 - [308: Provide `Capabilities` as a read-only class](#308) thanks to @boesing
 - [296: Support for `laminas/laminas-servicemanager` v4](#296) thanks to @boesing
 - [275: Introduce support for PSR-6 and PSR-16 v2 & v3](#275) thanks to @boesing
 - [273: Introduce `MetadataCapableInterface`](#273) thanks to @boesing
 - [14: reduce arguments by reference](#14) thanks to @weierophinney

#### Enhancement

 - [316: Narrow some more string types to `non-empty-string`](#316) thanks to @boesing
 - [291: Remove `laminas/laminas-feed` dev-dependency](#291) thanks to @boesing
 - [290: Update `vimeo/psalm` to v5.20.0](#290) thanks to @boesing
 - [289: Remove virtual package dependency of `laminas/laminas-cache-storage-implementation`](#289) thanks to @boesing
 - [277: Update `vimeo/psalm` to v5.16 once available](#277) thanks to @boesing

#### Bug,Enhancement

 - [315: Allow integerish keys in methods handling multiple keys at once](#315) thanks to @boesing

#### BC Break,Feature Removal

 - [311: Remove unsupported array configuration structure (array shape)](#311) thanks to @boesing
 - [309: Remove deprecated configuration support](#309) thanks to @boesing

#### BC Break

 - [295: Introduce native type-hints and pass-by-reference values](#295) thanks to @boesing and @ravcz
 - [294: Removal of `increment` and `decrement` functionality](#294) thanks to @boesing
 - [272: Remove dependency on real storage adapters and therefore benchmarks](#272) thanks to @boesing

#### Feature Request

 - [292: Incompatibility of laminas-cache and newer psr/cache versions ](#292) thanks to @smsalert-mobi

#### BC Break,Bug

 - [276: `Serializer` plugin has to serialize `token` to enable `StorageInterface#checkAndSetItem` comparing the correct values](#276) thanks to @boesing

#### Documentation

 - [274: Documentation for v4.0.0 including migration guide](#274) thanks to @boesing

### Release Notes for [3.12.2](https://github.com/laminas/laminas-cac…

…he/milestone/55)

3.12.x bugfix release (patch)

### 3.12.2

- Total issues resolved: **1**
- Total pull requests resolved: **1**
- Total contributors: **1**

#### Documentation

 - [300: Documentation: Add `ssl_context` option to `RedisCluster` documentation](#300) thanks to @boesing

### Release Notes for [3.12.1](https://github.com/laminas/laminas-cac…

…he/milestone/54)

3.12.x bugfix release (patch)

### 3.12.1

- Total issues resolved: **1**
- Total pull requests resolved: **1**
- Total contributors: **1**

#### Bug

 - [286: Infinite loop when fetching some cache-related services via container in projects without registered `config` service](#286) thanks to @InvisibleSmiley

### Release Notes for [3.12.0](https://github.com/laminas/laminas-cac…

…he/milestone/52)

### 3.12.0

- Total issues resolved: **0**
- Total pull requests resolved: **1**
- Total contributors: **1**

#### Enhancement

 - [280: Add support for PHP 8.3](#280) thanks to @fezfez

### Release Notes for [3.11.0](https://github.com/laminas/laminas-cac…

…he/milestone/48)

Feature release (minor)

### Added
- `AdapterPluginManager` is now configurable via `storage_adapters`

### Changed
- Added direct support for `PSR-20`
- minimum `laminas/laminas-servicemanager` version was raised to `3.21.0`

### Removed
- PHP 8.0 support was removed

### 3.11.0

- Total issues resolved: **1**
- Total pull requests resolved: **3**
- Total contributors: **2**

#### Enhancement

 - [266: Allow configuration of `AdapterPluginManager` via config file](#266) thanks to @rohm1
 - [264: Remove PHP 8.0 support](#264) thanks to @boesing
 - [263: Replace `stella-maris/clock` with `psr/clock`](#263) thanks to @boesing

#### Enhancement,Good First Issue,Help Wanted

 - [261: Provide native support for PSR-20](#261) thanks to @boesing

### Release Notes for [3.10.1](https://github.com/laminas/laminas-cac…

…he/milestone/47)

3.10.x bugfix release (patch)

### 3.10.1

- Total issues resolved: **0**
- Total pull requests resolved: **2**
- Total contributors: **2**

 - [259: Merge release 3.9.1 into 3.10.x](#259) thanks to @github-actions[bot]

#### Bug,Documentation

 - [258: Updates migration guide to fix the wrong link to the installation page](#258) thanks to @froschdesign