feat: add Factories::define() to explicitly override a class

[kenjis]

Description
Fixes #7694

• add Factories::define() to explicitly override a class
• [BC] preferApp works only for no namespaced classname
• [BC] rename Factories::$basenames to $aliases

I would like to deprecate preferApp option.

Changes
Property structure:

$basenames = [component => [basename => FQCN]];
↓
$aliases = [component => [alias => FQCN]];

basename is a short classname, or short classname with sub-directories.
alias is a FQCN, short classname, or short classname with sub-directories.
Factories::define() sets $aliases.

Behavior:

• model(\Myth\Auth\Models\UserModel::class) or model('Myth\Auth\Models\UserModel')
  • before:
    • returns App\Models\UserModel if exists and preferApp is true
    • returns Myth\Auth\Models\UserModel if exists and preferApp is false
  • after:
    • returns Myth\Auth\Models\UserModel even if preferApp is true
    • returns App\Models\UserModel if you define Factories::define('models', 'Myth\Auth\Models\UserModel', 'App\Models\UserModel') before the first call of the model()

Checklist:

• Securely signed commits
• Component(s) with PHPDoc blocks, only if necessary or adds value
• Unit testing, with >80% coverage
• User guide updated
• Conforms to style guide

[MGatner]

Can you give an example of how this would affect an existing workflow? For example right now Myth:Auth controller might use:

$user = model('UserModel')->find($userId);

... and a developer would supply app/Models/UserModel.php to override. With this update, would the developer need to add something to boot like:

use App\Models\UserModel;

Factories::define('models', 'UserModel', UserModel::class);

?

[MGatner]

These can get mixed up very easily. Let's stick to something like "shortname" for the unqualified version.

Suggested change

	* @param string $name Classname. The first parameter of Factories magic method
	* @param string $classname FQCN to load
	* @param string $name Class shortname. The first parameter of Factories magic method
	* @param string $classname FQCN to load

[MGatner]

Or I see I called it "basename" below. Doesn't matter as long as we are consistent.

[kenjis]

I introduced a new term "class alias".

[MGatner]

Is this the only breaking change? It seems like the rest of this PR could be rolled out separately without as big an impact.

[kenjis]

Perhaps.

And it is what I want to change. Also it is Paul's opinion. See #7694 (comment)

[kenjis]

@MGatner No. model('UserModel') specifies no namespaced classname 'UserModel'. So Factories look for App\Models\UserModel (preferApp works).

But if there is code like model(\Myth\Auth\Models\UserModel::class) or model('Myth\Auth\Models\UserModel'), Factories returns Myth\Auth\Models\UserModel if you don't define anything.

[MGatner]

Nice work!

[kenjis]

Rebased and added commits from a3c768a test: add test.