マルチログインの勉強をしていたんですが、どうも設定ファイルとか弄ってるだけでは納得がいかないのでソースを読むことにしました。
今更な記事ですが自分用のメモ程度に残しておきます。
参考
【Laravel】 認証や認可に関する補足資料
Laravel の Guard（認証） って実際何をやっているのじゃ？
私の環境PHP 7.4.27Laravel 8.80.0
<div class="remark-highlight"><pre class="language-unknown"><code class="language-unknown">sail@70ee715b44b3:/var/www/html$ php -v
PHP 7.4.27 (cli) (built: Dec 20 2021 21:28:33) ( NTS )
Copyright (c) The PHP Group
Zend Engine v3.4.0, Copyright (c) Zend Technologies
 with Zend OPcache v7.4.27, Copyright (c), by Zend Technologies
 with Xdebug v3.1.2, Copyright (c) 2002-2021, by Derick Rethans
sail@70ee715b44b3:/var/www/html$ php artisan -V
Laravel Framework 8.80.0
sail@70ee715b44b3:/var/www/html$</code></pre></div>
<h2>Authファサード</h2>
普段Auth::user()のようにやっているAuthファサードはAuthManagerクラスを取得します。Illuminate\Auth\AuthServiceProviderにサービスコンテナへの登録が記載されている
<div class="remark-highlight"><pre class="language-html"><code class="language-html">/**
 * Register the authenticator services.
 *
 * @return void
 */
 protected function registerAuthenticator()
 {
 $this->app->singleton('auth', function ($app) {
 return new AuthManager($app);
 });

 $this->app->singleton('auth.driver', function ($app) {
 return $app['auth']->guard();
 });
 }
</code></pre></div>
つまりこのAuthManagerが認証クラスの肝というわけですね。
<h2>ざっくりとAuthManagerの流れ(自己解析)</h2>
プロバイダの取得はCreatesUserProvidersトレイトに処理が移ります
<ul>
<li>AuthManager
<ul>
<li>コンストラクタguardメソッドを呼び出してSessionGuard/TokenGuarを取得する(設定値によるがデフォルトはこれが用意されている)</li>
<li>guard($name = null)defaultで設定しているguardの値を$nameとしてresolveメソッドを呼び出す</li>
<li>resolve($name)getConfigメソッドで$this->app[‘config’][“auth.guards.{$name}”]を取得するAuth::extendで設定してるガードがないか確認。あればそこで設定をreturnさせるcreate + $confid[‘driver’] + Driverメソッドを呼び出す(ucfirst:先頭文字大文字化)例えば、createSessionDriverメソッドです</li>
<li>createSessionDriver($name, $config)$this->createUserProvider($config[‘provider’] ?? null)を発火する
<ul>
<li>guardメソッドを呼び出してSessionGuard/TokenGuarを取得する(設定値によるがデフォルトはこれが用意されている)</li>
<li>defaultで設定しているguardの値を$nameとしてresolveメソッドを呼び出す</li>
<li>getConfigメソッドで$this->app[‘config’][“auth.guards.{$name}”]を取得する</li>
<li>Auth::extendで設定してるガードがないか確認。あればそこで設定をreturnさせる</li>
<li>create + $confid[‘driver’] + Driverメソッドを呼び出す(ucfirst:先頭文字大文字化)</li>
<li>例えば、createSessionDriverメソッドです</li>
<li>$this->createUserProvider($config[‘provider’] ?? null)を発火する</li>
</ul>
</li>
</ul>
</li>
<li>trait CreatesUserProviders
<ul>
<li>createUserProvider($provider = null)getProviderConfigurationメソッドを発火する</li>
<li>getProviderConfiguration($provider)$this->app[‘config’][‘auth.providers.’.$provider];を取得する</li>
<li>createUserProvider($provider = null)取得したcofnigのdriver(例eloquent)をdriver変数に詰めるdriverの値に応じてcreateDatabaseProviderかcreateEloquentProviderを返す
<ul>
<li>getProviderConfigurationメソッドを発火する</li>
<li>$this->app[‘config’][‘auth.providers.’.$provider];を取得する</li>
<li>取得したcofnigのdriver(例eloquent)をdriver変数に詰める</li>
<li>driverの値に応じてcreateDatabaseProviderかcreateEloquentProviderを返す</li>
</ul>
</li>
</ul>
</li>
<li>AuthManager
<ul>
<li>createSessionDriver($name, $config)SessionGuard($name, $provider, $this->app[‘session.store’]);をnewするnewしたものはguardとしてメソッドの戻り値になる</li>
<li>コンストラクタ取得したguardのuserメソッドを発火する
<ul>
<li>SessionGuard($name, $provider, $this->app[‘session.store’]);をnewする</li>
<li>newしたものはguardとしてメソッドの戻り値になる</li>
<li>取得したguardのuserメソッドを発火する</li>
</ul>
</li>
</ul>
</li>
</ul>
ちなみにここの$nameの引数はルーティングのミドルウェアで指定します。
<div class="remark-highlight"><pre class="language-php"><code class="language-php">Route::middleware(['auth:misaka'])->get('/misaka',function(){
 return "misaka";
 });
</code></pre></div>
<h4>マジックメソッドでguardのメソッドをコールする</h4>
guradメソッドはresolveメソッドの呼び出しを行います。
<div class="remark-highlight"><pre class="language-php"><code class="language-php">/**
 * Dynamically call the default driver instance.
 *
 * @param string $method
 * @param array $parameters
 * @return mixed
 */
 public function __call($method, $parameters)
 {
 return $this->guard()->{$method}(...$parameters);
 }
</code></pre></div>
<h2>Guard</h2>
認証処理を行う。Illuminate\Contracts\Auth\Guardインターフェースが該当します。実装クラスはSessionGuardとTokenGuardです。SessionGuardクラスはStatefulGuardを実装して、StatefulGuardはGuardを継承している。
config/auth.phpのguards.{defaults.guard}.driverによって実装クラスを変化させる
機能(一部)
<h2>プロバイダ</h2>
認証ユーザの取得などを行う。CreatesUserProvidersというtraitで主にプロバイダ自体の取得処理を行う。Illuminate\Contracts\Auth\UserProviderインターフェースが該当する実装クラスは、DatabaseUserProviderとEloquentUserProviderがある。
config/auth.phpのproviders.{defaults.guard.provider}.driverによって取得するプロバイダが変更されます。
また実装クラスのコンストラクタでconfig/auth.phpのproviders.{defaults.guard.provider}.modelで指定されたクラスを渡しています。※EloquentUserProviderの場合。※DatabaseUserProviderの場合はconfig/auth.phpのproviders.{defaults.guard.provider}.table
<div class="remark-highlight"><pre class="language-php"><code class="language-php">/**
 * Create an instance of the database user provider.
 *
 * @param array $config
 * @return \Illuminate\Auth\DatabaseUserProvider
 */
 protected function createDatabaseProvider($config)
 {
 $connection = $this->app['db']->connection($config['connection'] ?? null);

 return new DatabaseUserProvider($connection, $this->app['hash'], $config['table']);
 }

 /**
 * Create an instance of the Eloquent user provider.
 *
 * @param array $config
 * @return \Illuminate\Auth\EloquentUserProvider
 */
 protected function createEloquentProvider($config)
 {
 return new EloquentUserProvider($this->app['hash'], $config['model']);
 }
</code></pre></div>
auth.phpの抜粋
<div class="remark-highlight"><pre class="language-php"><code class="language-php">'providers' => [
 'users' => [
 'driver' => 'eloquent',
 'model' => App\Models\User::class,
 ],

 // 'users' => [
 // 'driver' => 'database',
 // 'table' => 'users',
 // ],
 ],
</code></pre></div>
機能(一部)
SessionGuardをインスタンス化する際に、コンストラクタにプロバイダーが渡されます。プロバイダーの使われ方として、例えばSessionGuardのuserメソッドではAuthenticatableを実装したクラスを、retrieveByIdメソッドにて取得しています。
<h2>Authenticatable</h2>
App\Models\Userクラスが継承しているクラスです。大抵はUserクラスをコピってもう一つの認証モデルを作るので意識しないですが、なぜこれを継承する必要があるのでしょうか？
<div class="remark-highlight"><pre class="language-php"><code class="language-php">class User extends Authenticatable
{
 use HasApiTokens;
 use HasFactory;
 use HasProfilePhoto;
 use Notifiable;
 use TwoFactorAuthenticatable;

</code></pre></div>
AuthenticatableはIlluminate\Foundation\Auth\Userクラスです。このクラスはIlluminate\Contracts\Auth\Authenticatableインターフェースを実装しています。
EloquentUserProviderクラスでは以下のようにAuthenticatableを実装したクラスが必要になるためです。
<div class="remark-highlight"><pre class="language-php"><code class="language-php">use Illuminate\Contracts\Auth\Authenticatable as UserContract;

....
 
 public function validateCredentials(UserContract $user, array $credentials)
 {
 $plain = $credentials['password'];

 return $this->hasher->check($plain, $user->getAuthPassword());
 }
</code></pre></div>
また、SessionGuardクラスでもこのインターフェースを実装したクラスを受取ることが前提になっています。
そのため、ただModelを継承したクラスではダメということです。※Authenticatableを実装すれば良い
<h2>マルチログイン</h2>
ここまで入ってくると、ようやくマルチログインでauth.phpに記載する意味がわかってきます。もちろんauth.phpにはコメントもあって何をすればいいのか書いてるのですが、それだけでは、なぜそうなるのかというモヤモヤは解消されません。

Laravel | AuthManagerを理解する