Add query parameters to named routes.

[Kim Hallberg]

Currently, named routes don't support passing in query parameters to route, which doesn't provide 100% feature parity with native named routes. I noticed this while updating my test app tangerine to support named routes.

I also confirmed this by updating the feature parity test and appending a query parameter.

test('feature parity', function () {
    Route::get('/posts/{lowerCase}/{UpperCase}/{podcast}/{user:email}/show', function (
        string $id,
        string $upperCase,
        Podcast $podcast,
        User $user) {
        //
    })->name('users.regular');

    $parameters = [
        'lowerCase' => 'lowerCaseValue',
        'upperCase' => 'UpperCaseValue',
        'podcast' => Podcast::first(),
        'user' => User::first(),
        'query' => 'string',
    ];

    $expectedRoute = '/posts/lowerCaseValue/UpperCaseValue/1/[e-mail]/show?query=string';

    $route = route('users.regular', [
        'lowerCase' => 'lowerCaseValue',
        'UpperCase' => 'UpperCaseValue',
        'podcast' => Podcast::first(),
        'user' => User::first(),
        'query' => 'string',
    ], false);

    expect($route)->toBe($expectedRoute);

    $route = route('posts.show', $parameters, false);

    expect($route)->toBe($expectedRoute);
});

This fails the expectation for Folio's named routes, but not for the native named routes:

 FAILED  Tests\Feature\NameTest > feature parity                                                                                             
  Failed asserting that two strings are identical.
  -'/posts/lowerCaseValue/UpperCaseValue/1/[e-mail]/show?query=string'
  +'/posts/lowerCaseValue/UpperCaseValue/1/[e-mail]/show'
  

  at tests/Feature/NameTest.php:103
     99▕     expect($route)->toBe($expectedRoute);
    100▕ 
    101▕     $route = route('posts.show', $parameters, false);
    102▕ 
  ➜ 103▕     expect($route)->toBe($expectedRoute);
    104▕ });
    105▕ 
    106▕ test('model route binding wrong column', function () {
    107▕     $parameters = [

  1   tests/Feature/NameTest.php:103


  Tests:    1 failed (2 assertions)
  Duration: 0.08s

This is used internally by Laravel, say password reset when generating the URL for the notification, which adds the users' email as a query parameter. Using a regular named route adds the query parameter, while Folio doesn't.

Would be great if Folio also supported adding query parameters when generating a URL with route.

[Dries Vints]

@nunomaduro this is the same request as #81 I think

[Kim Hallberg]

this is the same request as #81 I think

Don't think so, sounds like #81 wants to be able to pre-defined queries in the Folio file, maybe? IDK, query strings are already working in Folio, and Folio with Volt. They're accessible via request() or $_GET as always. Or with state()->url() in Volt.

What I'm asking is to be able to generate a URL with route and include query parameters in that. Figure a signup page with a referrer for instance:

route('register', ['referrer' => '[e-mail]']);
// Currently with Folio named route:
// http://localhost/register

route('register', ['referrer' => '[e-mail]']);
// Currently with a regular named route:
// http://localhost/register?referrer=dries%40laravel.com

Generating a URL with a named Folio route doesn't include the query parameter, as a regular named route would.

[Nuno Maduro]

Fix in progress: #88.