Add support for an actor provider for extensions which use a user reference

[mbabker]

Ref: #2843

This is kind of a fresh take on #2074 which is seemingly more relevant with stuff like FrankenPHP out there nowadays. For now I went with a single interface that can be used by all extensions (since loggable (and the WIP revisionable) have a similar thing), but since the extensions also have different requirements (blameable supports strings and associations, loggable only supports strings), maybe this needs more refinement. Also for now there aren't any implementations shipped in this library, what goes on within a provider is probably better handled either in the framework integrations or directly within an application.

[codecov]

Codecov Report

Attention: Patch coverage is 72.41379% with 8 lines in your changes missing coverage. Please review.

Project coverage is 78.50%. Comparing base (8cc3f95) to head (faaae31).
Report is 1 commits behind head on main.

Files with missing lines	Patch %	Lines
src/Loggable/LoggableListener.php	56.25%	7 Missing ⚠️
src/Blameable/BlameableListener.php	92.30%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #2914      +/-   ##
==========================================
- Coverage   78.53%   78.50%   -0.04%     
==========================================
  Files         168      168              
  Lines        8760     8778      +18     
==========================================
+ Hits         6880     6891      +11     
- Misses       1880     1887       +7     

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

[stof]

This seems like a good idea.

One benefit (once I implement the actor provider in StofDoctrineExtensionsBundle) is that this will avoid reading the authenticated user early in the request (requiring to potentially start the session), even in requests that won't ever record a blameable change.

[stof]

@mbabker what is the plan for this PR ? Are you going to merge it ? I got a new report on the bundle that would also be solved by migrating to the actor provider.

[mbabker]

I went ahead and did a quick docs update, should be ready for review/merge now.

[phansys]

Thank you @mbabker!

[phansys]

@stof, this was released under 3.19.0.

Thanks!