[12.x] Class uses recursive

[fgaroby]

This PR adds a new class which allow to cache all traits used by a class, its parent classes and trait of their traits.

As suggested in #56069 (comment)

[github-actions]

Thanks for submitting a PR!

Note that draft PR's are not reviewed. If you would like a review, please mark your pull request as ready for review in the GitHub user interface.

Pull requests that are abandoned in draft may be closed due to inactivity.

[shaedrich]

Awesome! Are you going to add trait_uses_recursive() as well?

[shaedrich]

How do you feel about naming it uses()?

[fgaroby]

I'm totally aware about the naming.

[cosmastech]

This is very much what I had envisioned.

I would suggest:

1. Modify class_uses_recursive() so that it relies on this new static class. You've replaced it inside the framework code (which if you didn't do today, someone would come along in a month and do), which is great. However, userland libs will most definitely leverage the class_uses_recursive() function as well, and this will give a win across the board.
2. I think in the base test case, it makes sense to clear the memoized values. https://github.com/laravel/framework/blob/12.x/src/Illuminate/Foundation/Testing/Concerns/InteractsWithTestCaseLifecycle.php#L169-L190
3. Obviously function naming can be improved, as you said.
4. I feel the namespace should be Illuminate\Support, so that it's available globally to all components. Otherwise, Illuminate sub-component have to update their dependencies in their composer.json.

[shaedrich]

I might say, we could go as far as understanding the class as broader (e.g. ClassMetaData) to potentially include other methods.

[shaedrich]

Okay, maybe \Illuminate\Support\Reflector is that class already 🤔

[fgaroby]

Thanks for your comments! 🙏
You're right: I think I will move my code to Reflector class.

[fgaroby]

Done.

[cosmastech]

I think of Laravel/package code uses protected to allow for extension.

Suggested change

	private static array $classesUsesRecursive = [];
	/**
	* @var array<class-string, list<class-string>>
	*/
	protected static array $classesUsesRecursive = [];

[shaedrich]

One thing, you might also cover here, is the following scenario:

We have Child ← Parent ← Grandparent

Reflector::classesUsesRecursive(Child::class); // returns [Parent::class, Grandparent::class] (uncached)
Reflector::classesUsesRecursive(Child::class); // returns [Parent::class, Grandparent::class] (now cached)
Reflector::classesUsesRecursive(Parent::class); // returns [Grandparent::class] (uncached)

The invocation with Parent could potentially also already be cached when called with Child beforehand.