Added extension mechanism

Author: Geolim4

CHANGELOG.md

@@ -2,10 +2,15 @@
 ##### xx january 2024
 - __API__
   - Upgraded Phpfastcache API to `4.3.0` ([see changes](CHANGELOG_API.md))
+- __Extensions__ (💡 New in 9.2)
+  - Created an extension mechanism to allow future driver to be loaded independently, see [README.md](README.md)
+  - Created first extension for `Couchbasev4` support which will be moved to a [sub-repository](https://github.com/PHPSocialNetwork/couchbasev4-extension).
+  - **IMPORTANT**: *AS OF V10* the following drivers will be **MOVED** to their own sub-repositories an extension: `Arangodb`, `Couchdb`, `Cassandra`, `Dynamodb`, `Firestore`, `Mongodb`. However `Couchbasev3` will stay in the core for compatibility reason but will be deprecated. 
 - __Events__
   - EventManager is now scoped to its own poll if retrieved through `ExtendedCacheItemPoolTrait::->getEventManager()`. Global EventManager `EventManager::getInstance()` remains unchanged, see [EVENTS.md](./docs/EVENTS.md).
-  - `EventManagerInterface::on()` now accepts a single `string $events` or an `array $events`.
+  - `EventManagerInterface::on()` now also accepts a single `string $events`.
   - Alias `\Phpfastcache\PhpfastcacheEventManager` of `\Phpfastcache\EventManager` has been added to improve your code import readability.
+  - Deprecated `\Phpfastcache\Event\EventManagerDispatcherInterface::hasEventManager` to be removed for v10.
 - __Drivers__
   - Implemented #906 // **Added `RedisCluster` driver support**
   - Driver `Memstatic` has changed its name to `Memory` for more consistency.
@@ -17,6 +22,8 @@
   - Internal: Implemented multiple keys fetch (*if supported by the backend*) to improve the performances behind all `getItems()` calls. Currently only supported in some backends, but it may evolve in the future.
   - Internal: Implemented multiple keys delete (*if supported by the backend*) to improve the performances behind all `deleteItems()` calls. Currently only supported in some backends, but it may evolve in the future.
   - `\Phpfastcache\CacheContract::get()` now accepts a `\Stringable $cacheKey` argument.
+- __Tags__
+  - Added `\Phpfastcache\Core\Item\TaggableCacheItemInterface::isTagged(): bool`
 - __Misc__
   - Fixed multiple code typo & updated README.md
 

CHANGELOG_API.md

@@ -4,11 +4,13 @@
 - Deprecated `ConfigurationOption::setPreventCacheSlams()` for future removal, use `IOConfigurationOption::setPreventCacheSlams()` instead.
 - Deprecated `ConfigurationOption::getCacheSlamsTimeout()` for future removal, use `IOConfigurationOption::getCacheSlamsTimeout()` instead.
 - Deprecated `ConfigurationOption::setCacheSlamsTimeout()` for future removal, use `IOConfigurationOption::setCacheSlamsTimeout()` instead.
+- Deprecated `\Phpfastcache\Event\EventManagerDispatcherInterface::hasEventManager` to be removed for v10.
 - Created `IOConfigurationOption::isPreventCacheSlams()`. This method will **only be available** for `Files, Sqlite, Leveldb` drivers.
 - Created `IOConfigurationOption::setPreventCacheSlams()`. This method will **only be available** for `Files, Sqlite, Leveldb` drivers.
 - Created `IOConfigurationOption::getCacheSlamsTimeout()`. This method will **only be available** for `Files, Sqlite, Leveldb` drivers.
 - Created `IOConfigurationOption::setCacheSlamsTimeout()`. This method will **only be available** for `Files, Sqlite, Leveldb` drivers.
-- Method `EventManagerInterface::on(array|string $events, callable $callback)` now accepts a single `string $events` or an `array $events`.
+- Method `EventManagerInterface::on(array|string $events, callable $callback)` now also accepts a single `string $events`.
+- Added `\Phpfastcache\Core\Item\TaggableCacheItemInterface::isTagged`.
 
 
 ## 4.2.0

CONTRIBUTING.md

@@ -2,7 +2,7 @@ Contributing to PhpFastCache
 ========================
 
 Please note that this project is released with a
-[Contributor Code of Conduct](http://contributor-covenant.org/version/1/4/).
+[Contributor Code of Conduct](https://www.contributor-covenant.org/version/1/4/code-of-conduct/).
 By participating in this project you agree to abide by its terms.
 
 Reporting Issues
@@ -16,7 +16,7 @@ resolved in a timely manner.
 Contributing policy
 -------------------
 
-Our contributing policy is described in our [Coding Guideline](https://github.com/PHPSocialNetwork/phpfastcache/blob/v7/CODING_GUIDELINE.md)
+Our contributing policy is described in our [Coding Guideline](https://github.com/PHPSocialNetwork/phpfastcache/blob/master/CODING_GUIDELINE.md)
 
 Developer notes
 -------------------
@@ -26,7 +26,7 @@ To run tests follow the steps:
 1) Run `./bin/ci/scripts/install_dependencies.sh`
 2) Run `./vendor/bin/phpcs lib/  --report=summary`
 3) Run `./vendor/bin/phpmd lib/ ansi phpmd.xml`
-4) Run `./vendor/bin/phpstan analyse lib/ -l 2 -c phpstan_lite.neon 2>&1`
+4) Run `./vendor/bin/phpstan analyse lib/ -c phpstan_lite.neon 2>&1`
 5) Run `php -f ./bin/ci/run_tests.php`
 
 If you are on Windows environment simply run the file `quality.bat` located at the root of the project to run the step 2, 3 and 4 in once.
@@ -35,4 +35,4 @@ The last command will run all the unit tests of the project.
 If an error appears, fix it then you can submit your pull request.
 
 Some tests will be skipped if you don't have special dependencies installed (Arangodb, Couchbase, Couchdb, Firestore credential and SDK, Dynamodb credential, etc.).\
-So don't worry if those tests are skipped as long as they **pass** on the Github and Travis CIs.
+So don't worry if those tests are skipped as long as they **pass** on the GitHub and Travis CIs.

EXTENSIONS.MD

@@ -0,0 +1,20 @@
+## As of the 9.2 an extension concept has been introduced.
+
+It's pretty but allow Phpfastcache to split up its drivers into sub-repository with a simple additional call to make.
+
+The 9.2 make the beginning of a new external extension: `Couchbasev4`
+
+There's only 2 steps:
+
+1) Add it to your composer: `composer install phpfastcache/couchbasev4-extension`
+2) Call the CacheManager: `CacheManager::getInstance('Couchbasev4')`
+
+Be aware that as of the v10 the following drivers will be **MOVED** to their own sub-repositories an extension: 
+- `Arangodb`
+- `Couchdb`
+- `Cassandra`
+- `Dynamodb`
+- `Firestore`
+- `Mongodb`
+
+However `Couchbasev3` will stay in the core for compatibility reason but will be **deprecated**.