3.2.0

Release Notes for 3.2.0

Feature release (minor)

Changes

• Cache items which get expired by using CacheItemInterface#expiresAfter now start expiring immediately after calling that method. Prior this release, they started to expire after passing them to either CacheItemPoolInterface#save or in case they were passed to CacheItemPoolInterface#saveDeferred after calling CacheItemPoolInterface#commit

Removed

• Support for PHP 7.3

3.2.0

• Total issues resolved: 0
• Total pull requests resolved: 5
• Total contributors: 3

Bug,Documentation

• 208: Documentation fixes thanks to @boesing

renovate

• 201: Configure Renovate thanks to @renovate[bot]

Bug,Enhancement

• 199: CacheItem for PSR-6 needs to start expiring after calling CacheItemInterface#expiresAfter thanks to @boesing

Enhancement

• 198: Update psalm to v4.24.0 thanks to @boesing
• 190: Prepare for Renovate with reusable workflows thanks to @ghostwriter

3.1.3

Release Notes for 3.1.3

3.1.x bugfix release (patch)

3.1.3

• Total issues resolved: 1
• Total pull requests resolved: 1
• Total contributors: 2

Bug

• 194: CacheItemPoolDecorator does not properly handle multiple unsaved deferred items thanks to @boesing and @shandyDev

3.1.2

Release Notes for 3.1.2

3.1.x bugfix release (patch)

3.1.2

• Total issues resolved: 0
• Total pull requests resolved: 1
• Total contributors: 1

Bug

• 185: Fix storage adapter factory assertion with adapter key thanks to @snapshotpl

3.1.1

Release Notes for 3.1.1

3.1.x bugfix release (patch)

Changed

• In 3.1.0, we released a BC compatibility for v2.12.0+. Sadly we had a slip there and thus the changes were applied to the StoragePluginFactoryInterface instead of the StorageAdapterFactoryInterface. This release reverts these changes and applies the BC compatibility to the proper factory.

Breaking Changes

• In case you already migrated to 3.1.0 in the last 24h and changed the plugin configuration accordingly, updating to this version would cause breaks in your project. If you haven't changed any configuration, an update wont cause any issues.

---

3.1.1

• Total issues resolved: 0
• Total pull requests resolved: 1
• Total contributors: 1

BC Break,Bug

• 183: Revert changes made for adapter name from StoragePluginFactoryInterface and apply to StorageAdapterFactoryInterface instead thanks to @snapshotpl

3.1.0

Release Notes for 3.1.0

Feature release (minor)

Added

• Added adapter as a compatible array key for storage adapter configurations. This will provide support for the array structure which had to be changed in v2 of laminas-cache to be compatible with the v3 release. This was somehow changed in v3 without backporting it to v2 and thus, this change will provide better support for components which have to provide support for both v2 and v3

Deprecated

• With this release, we are also deprecating the name array configuration key which has to be adapter.

3.1.0

• Total issues resolved: 0
• Total pull requests resolved: 1
• Total contributors: 1

Bug,Enhancement

• 182: Allow adapter as configuration key when using StoragePluginFactoryInterface thanks to @boesing

3.0.1

Release Notes for 3.0.1

3.0.x bugfix release (patch)

3.0.1

• Total issues resolved: 0
• Total pull requests resolved: 1
• Total contributors: 1

Bug,Documentation

• 180: Adds missing migration guide to navigation thanks to @froschdesign

3.0.0

Release Notes for 3.0.0

laminas-cache 3.0.0 is here and finally enables projects to only require those cache adapters which are actually used by the project.

Please read more on how to migrate your project in our migration guideline.

Added

• Adds PHP 8.1 support to laminas-cache
• PSR-6 CacheItemPoolDecorator now validates the maximum key length
• Each cache adapter now has to be implicitly required by a project

Removed

• StorageFactory and PatternFactory were removed
• ClassCache pattern was removed while there is no alternative
• Both PatternCacheFactory and StoragePatternCacheFactory (introduced in v2.12.0) in order to provide forward compatibility for v3.0.0 are removed
• PatternPluginManager and PatternPluginManagerFactory were removed since most pattern require an underlying cache adapter which must now be passed via dependency injection rather than an option. Therefore, the PatternOptions are not capable of the storage option anymore
• The PluginManagerLookupTrait which was used to provide forward compatibility for the StorageAdapterFactoryInterface

Breaking Changes

• CallbackCache, OutputCache and ObjectCache now require the underlying cache adapter (StorageInterface) as 1st __construct dependency. The options can be passed via 2nd __construct argument but are optional.
  Please note that it is not possible to inject the pattern configuration as an array anymore
• Storage configurations must be in a specific shape. For more details, head to the release notes of 2.12.0
• All cache adapters are now marked as final and are not extensible anymore. In case that you are extending one of the cache adapters, please change your code as composition should be preferred over inheritance. For an example, please check out the composition over inheritance section.
• Due to the enhancement of CacheItemPoolDecorator, the maximum key length for the underlying cache adapter is validated before it is passed to the adapter.
• The SerializationTrait which was meant to be used by both PSR-6 and PSR-16 decorators is now marked as internal.
• The PCRE_MAXIMUM_QUANTIFIER_LENGTH constant of the SimpleCacheDecorator (which was marked as internal) has now been moved to the new (also internal) MaximumKeyLengthTrait and thus had to become a public static property (as traits do not support constants).

---

All compatible satellite packages which do support laminas-cache v3 can be found here.

3.0.0

• Total issues resolved: 3
• Total pull requests resolved: 22
• Total contributors: 4

BC Break,Enhancement

• 177: PSR-6 maximum cache key length validation thanks to @boesing
• 141: Mark plugin managers final thanks to @boesing
• 55: Remove all adapters from plugin manager thanks to @boesing
• 48: Support for PHP 8.0 thanks to @boesing

Enhancement

• 167: Removed old code related to deleted ClassCache pattern thanks to @boesing
• 165: Support PHP 8.1 thanks to @boesing
• 163: Provide interface factory for StorageAdapterFactoryInterface thanks to @boesing
• 144: Use dependency inversion for cache adapters thanks to @boesing
• 143: Remove dependency of cache adapters thanks to @boesing
• 79: Mark plugin manager objects final thanks to @boesing
• 67: Psalm thanks to @boesing
• 62: Specify cache storage adapters as suggestions rather than requirements thanks to @holtkamp
• 57: feat: introduce StorageItem::setItems for CacheItemPoolDecorator::commit thanks to @boesing

Bug

• 164: PHP 8.1: SimpleCacheDecorator#convertIterableToArray converts float to integer array keys thanks to @boesing
• 54: qa: bring back unit test for AdapterOptions thanks to @boesing
• 53: qa: bring back unit test for AbstractAdapter thanks to @boesing

Documentation

• 148: Remove abandoned adapters v3 from documentation thanks to @boesing
• 60: Migration Guide for v3.0 thanks to @boesing

Documentation,Enhancement

• 145: Documentation for APCu adapter thanks to @boesing
• 142: Adds versioning for documentation thanks to @froschdesign
• 51: Fix documentation snippets thanks to @malukenho

BC Break

• 93: Remove PatternFactory as it was marked as deprecated in v2.11.0 thanks to @boesing
• 61: qa: remove zendframework compatibility thanks to @boesing
• 52: Remove deprecations from 2.x thanks to @boesing

2.13.2

Release Notes for 2.13.2

2.13.x bugfix release (patch)

2.13.2

• Total issues resolved: 0
• Total pull requests resolved: 1
• Total contributors: 1

Bug

• 173: Merge release 2.12.3 into 2.13.x thanks to @github-actions[bot]

2.13.1

Release Notes for 2.13.1

2.13.x bugfix release (patch)

2.13.1

• Total issues resolved: 0
• Total pull requests resolved: 1
• Total contributors: 1

Bug,hacktoberfest-accepted

• 169: Widening return type hint of SimpleCacheDecorator::translateThrowable method thanks to @mariojrrc

2.12.3

Release Notes for 2.12.3

2.12.x bugfix release (patch)

2.12.3

• Total issues resolved: 0
• Total pull requests resolved: 1
• Total contributors: 1

Bug

• 172: Pass $options in StoragePluginFactory thanks to @boesing