[11.x] Added toInstance method to Http client to convert response to class object

[andrey-helldar]

When using an Http client, you often need to generate an object from the response, so you have to do something like this:

public function some(): Some
{
    $data = Http::post($url)->json();
    
    return new Some($data);
}

This PR adds a new method to the response object - “toInstance” (I couldn't think of a better name 😅). This way we can improve the data return:

public function some(): Some
{
    return Http::post($url)->toInstance(Some::class);
}

In addition, it is possible to specify not only the name of the key, from where the data for translation will be taken, for example:

public function some(): Some
{
    return Http::post($url)->toInstance(Some::class, 'foo.bar');
}

But also use callback function for manual control if object formation is a non-standard process. This will allow the developer to choose how the transformation should take place. For example:

public function some($custom): Some
{
    return Http::post($url)->toInstance(
        fn (array $data) => new Some($data['foo'], $data['bar'], $custom)
    );
}

And, of course, you can specify the name of the key from which this data will be taken:

public function some($custom): Some
{
    return Http::post($url)->toInstance(
        fn (array $data) => new Some($data['foo'], $data['bar'], $custom),
        'foo.bar'
    );
}

[taylorotwell]

Thanks for your pull request to Laravel!

Unfortunately, I'm going to delay merging this code for now. To preserve our ability to adequately maintain the framework, we need to be very careful regarding the amount of code we include.

If applicable, please consider releasing your code as a package so that the community can still take advantage of your contributions!

[andrey-helldar]

Ok, i did it 🙂

https://github.com/TheDragonCode/laravel-http-macros