Added yii\caching\CallbackDependency to allow using a callback to determine if a cache dependency is still valid

[laxity7]

Using a callback function is more convenient to use than a string, as in yii\caching\ExpressionDependency.

Q	A
Is bugfix?	❌
New feature?	✔️
Breaks BC?	❌

[what-the-diff]

PR Summary

• Introduction of yii\caching\CallbackDependency in various language guides
  The yii\caching\CallbackDependency class, a new caching tool, has been added to several documentation guides. These are resources that assist developers, and are now available in a variety of languages—Spanish, French, Japanese, Portuguese, Russian, Chinese, and English.

• Inclusion of yii\caching\CallbackDependency class to framework
  The yii\caching\CallbackDependency class has also been integrated into the main framework. This new functionality will empower developers to handle caching dependencies in a more flexible manner.

• Modification of generateDependencyData method
  The generateDependencyData method, used for creating dependency data, found in FileDependency.php has been updated. The alterations will improve how dependencies are being processed.

• Addition of test cases for yii\caching\CallbackDependency
  Tests for the newly added yii\caching\CallbackDependency have been introduced. This testing helps validate the correct functioning of the new class, ensuring that it works reliably and as expected. It's a big step towards achieving higher quality and stability in our software.

[codecov]

Codecov Report

Attention: Patch coverage is 22.22222% with 7 lines in your changes are missing coverage. Please review.

Project coverage is 46.70%. Comparing base (923c309) to head (1ecdbe5).

❗ Current head 1ecdbe5 differs from pull request most recent head 848ddf9. Consider uploading reports for the commit 848ddf9 to get more accurate results

Files	Patch %	Lines
framework/caching/FileDependency.php	0.00%	4 Missing ⚠️
framework/caching/CallbackDependency.php	50.00%	2 Missing ⚠️
framework/classes.php	0.00%	1 Missing ⚠️

Additional details and impacted files

@@              Coverage Diff              @@
##             master   #20137       +/-   ##
=============================================
- Coverage     64.82%   46.70%   -18.13%     
=============================================
  Files           429      446       +17     
  Lines         37074    43917     +6843     
=============================================
- Hits          24034    20510     -3524     
- Misses        13040    23407    +10367     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[rob006]

IMO this needs some documentation how to configure serialization to handle closures - I suspect that most users will try to use this class with anonymous functions, and it won't work by default, because PHP does not handle serializing closures by default and Yii does not do anything to work around this limitation.

[laxity7]

@samdark is't possible to merge or is there something else to do?

[samdark]

Thanks.

[OndrejVasicek]

Doesn't CallbackDependency make ExpressionDependency obsolete?
Also - I can't see info about the class in the guide on web, even though it's in this PR. I can't even find in in the API - https://www.yiiframework.com/doc/api/2.0/yii-caching-dependency