[6.x] Allow developer to preserve query parameters on paginated Api resources

[deleugpn]

Reattempt at #30729 without static configuration.

Instead of statically configuring it once, the developer would have to call ->preserveQueryParameters() after instantiating the Resource Collection, but I still like the DX with this case.

class MyHandler
{
    public function __invoke(MyRepository $repository)
    {
        return MyResourceCollection::make($repository->paginate())->preserveQueryParameters();
    }
}

[taylorotwell]

Yeah this feels a lot better. Thanks.

[driesvints]

Maybe rename the method to something less verbose? Thinking withUrl or something in the likes.

[Alymosul]

Maybe shouldPreserveQueryParamters would be better and expressive.

[taylorotwell]

I tweaked this into two methods and did some renaming:

[BrandonSurowiec]

Documentation will need to be added to laravel/docs for the new preserveQuery() and withQuery() methods.