feat(cache): add deleteMatching method definition in CacheInterface

[yassinedoghri]

Description
I've added the deleteMatching method back in 2021 to delete multiple cache items based on a pattern. At that time, I didn't get the chance to add the method definition to the CacheInterface because it would introduce a breaking change for users.

Being a breaking change, this PR adds the definition by targeting the next minor version branch (4.7).
This would fix any annoying error from static type checkers, like phpstan for example.

Furthermore, I've removed the base implementation from BaseHandler because all handlers have the method implemented anyways.

fixes #7828

[michalsn]

Thank you. We will need a changelog entry for this, here: https://github.com/codeigniter4/CodeIgniter4/blob/4.7/user_guide_src/source/changelogs/v4.7.0.rst?plain=1#L43

[yassinedoghri]

Done, thank you for the review!

[michalsn]

One tiny request: please move the Cache entry before the Image entry so we can keep everything in alphabetical order. Thanks!

[yassinedoghri]

@michalsn Done :)

[michalsn]

Looks good, thank you.

[neznaika0]

`{@inheritDoc}` can be deleted.

[yassinedoghri]

I have added the native missing return types for all CacheInterface methods and updated the handlers accordingly.
👉 Note that I have fixed a bug for Wincache's increment and decrement methods: they returned mixed instead of bool or int.

Also, I took the liberty to remove the false return type on the getMetaData() method which was deprecated. Let me know if you want me to revert this.

I have added notes to the changelogs for both the changes.

Anything else worth changing while we're at it?

[michalsn]

Nice catch with WincacheHandler. Can you add this under the "Bugs Fixed" section of the changelog?

[yassinedoghri]

All done!

One more thing, I found a // FIXME comment in MemcachedHandler's decrement() method:

CodeIgniter4/system/Cache/Handlers/MemcachedHandler.php

Lines 218 to 220 in 92100b2

	// FIXME: third parameter isn't other handler actions.
	return $this->memcached->decrement($key, $offset, $offset, 60);

The comment says that the third parameter (being the $initial_value) isn't present in other handlers. What does it mean exactly? Should it be?

I'm guessing the fix should be another PR anyways?

[michalsn]

I don't use this cache, but it seems like MemcachedHandler for increment() and decrement() is... at least inconsistent.

The $initial_value should always be 0, and we should not set the TTL (we should skip this parameter entirely). Besides, we should support Memcache too - just like we do for other methods, not sure why this was skipped here.

Yes, this should go to a different PR.

[michalsn]

Thank you!

[paulbalandan]

Thanks. I think this should be 2 separate PRs: 1 for the deleteMatching method, the other for the method signature changes.

[yassinedoghri]

Thanks. I think this should be 2 separate PRs: 1 for the deleteMatching method, the other for the method signature changes.

Done. Here's the new PR: #9811

I'll wait for this PR to be merged first before rebasing the other one and merging it.

[paulbalandan]

Thank you, @yassinedoghri