laravel6 ソースコード - dispatchToRouter()の返すクロージャの引数にどこからどうやって値が渡るのか分かりません

Question

laravel6のソースコードについて質問させていただきます。
RequestインスタンスのrequestUriにどのタイミングでURLが格納されるのかを特定しようとしており、関連するソースコードを読んでおります。

Xdebug等を駆使し、createFromBaseメソッドによって作られた空のRequestインスタンスをIlluminate\Foundation\Http\KernelクラスのsendRequestThroughRouterメソッドに渡すと、渡されたRequestインスタンスのrequestUriに値が格納されるというところまで突き止めました。

問題はそこから先で、sendRequestThroughRouterメソッドがどのようにしてrequestUriを取得しているのかがわかりません。SendRequestThroughRouterメソッドの一番最後の行で呼んでいるthen($this->dispatchToRouter())がどのような挙動になっているのか、どうしても理解できないからです。

特に、dispatchToRouter()については、ソースコードを見ると、単にクロージャを返しているだけのようなのですが、そのクロージャは引数として$requestを受け取ることとなっています。この$requestは呼び出し元であるsendRequestThroughRouterメソッドに渡された$requestのことかなと思ったのですが、自分の雑なPHPの理解では、クロージャに外部から引数を渡すときはuseを使う必要があるのではと思い、この$requestにどこからどうやって値が渡るのかがわからず、これ以上コードを読み進めることができずにいます。

有識者の方、ご指導のほど、どうぞよろしくお願いいたします。

namespace Illuminate\Foundation\Http;

class Kernel implements KernelContract
{

// 一部抜粋

    protected function sendRequestThroughRouter($request)
    {
        $this->app->instance('request', $request);

        Facade::clearResolvedInstance('request');

        $this->bootstrap();

        return (new Pipeline($this->app))
                    ->send($request)
                    ->through($this->app->shouldSkipMiddleware() ? [] : $this->middleware)
                    ->then($this->dispatchToRouter());
    }

    protected function dispatchToRouter()
    {
        return function ($request) { //この$requestにはどこからどうやって値が渡るのか
            $this->app->instance('request', $request);

            return $this->router->dispatch($request);
        };
    }

Comments

[m.ts10806]

ドキュメント確認します　　というコメントを見た気がしたのですが、
この質問内容だと何も確認してないように見受けられます。

[hasukawa]

ドキュメントは確認しましたが、私の質問に対する解説は載っていなかったと理解しています。(少なくともドキュメントの検索窓でdispatchToRouterで検索しても何もヒットしませんでした。)
ドキュメントに書いてあるのは主にlaravelの使い方かと思いますが、目的は、laravelの使い方を知ることではなく、laravelの挙動を「ソースコードから」理解することですので。
もし私の探し方が甘かったということであれば、恐れ入りますが、下の方のご回答のような解説が載っているドキュメントのページをご教示いただけませんでしょうか。
宜しくお願い致します。

Answer 1

どうやらvendor/laravel/framework/src/Illuminate/Pipeline/Pipeline.phpの
public function then(Closure $destination)と public function send($passable)を見たら分かるようです。
public function send($passable)の**$passableが質問文で抜粋してあるコードの$request**です。

前のコメントで反応無かったんであえて本回答に書きますが、コードを読むのは面倒くさいだけで特にコツはありません、ただソースを愚直に追うだけです。
実際に自分もこの質問を見てからの数分程度、vimで追ってみただけです。grepすら使ってません。

dispatchToRouterについて調べた手順

vendor/laravel/framework/src/Illuminate/Foundation/Http/Kernel.phpを見ると、

Pipeline->send->through->then(dispatchToRouter())

という呼び出しと共に使われている事が分かるので、Pipelineがどこにあるかをファイル内を検索するとuse Illuminate\Routing\Pipeline;している事が分かる

vendor/laravel/framework/src/Illuminate/Routing/Pipeline.phpでthenを検索してみるがヒットしないので、extendsしているBasePipelineに目星をつけて、BasePipelineを検索するとuse Illuminate\Pipeline\Pipeline as BasePipeline;している事が分かる

vendor/laravel/framework/src/Illuminate/Pipeline/Pipeline.phpでthenを検索すると

 97     public function then(Closure $destination)
 98     {
 99         $pipeline = array_reduce(
100             array_reverse($this->pipes()), $this->carry(), $this->prepareDestination($destination)
101         );
102
103         return $pipeline($this->passable);
104     }
105

が見つかり、$this->prepareDestination($destination)という呼び出しをしている事が分かる

同ファイル内でprepareDestinationを調べてみると、

26         return function ($passable) use ($destination) {
127             try {
128                 return $destination($passable);
129             } catch (Throwable $e) {
130                 return $this->handleException($passable, $e);
131             }
132         };

と使われている事が分かる。
では$passableが何かという事で同ファイル内をpassable検索すると

 58     public function send($passable)
 59     {
 60         $this->passable = $passable;
 61
 62         return $this;
 63     }

が見つかり、sendで渡しているパラメーターだという事が分かる
そしてsendで渡しているものが何かというと、最初のファイルに戻って$requestだという事が分かる

そしてこれが分かったところでLaravel使う上では全く何の役にも立たないのです。

Comments

[hasukawa]

詳細なご回答ありがとうございました。
まさにこのような解説が欲しかったところです。大変勉強になりました。
laravelを「使う」うえでは役にたたないことは確かですが、著名なフレームワークから、将来にわたって使えるデザインパターンを学ぶという意味では、ソースコードリーディングは有意義だと信じています。（10年後までlaravelが現役な保証はどこにもないので。。。）

[hentaiman]

そうですね、プログラム書く事に的を絞ればフレームワークを読むことで書き方の発見はあるしそれらは実務でも役に立ちますね。
コーディングオンリーじゃないのならフレームワークで使われている周辺知識の学習の方が有益な感じはしますが（sqs・redis・workerなど）