[5.7] Add original parameters to Route

[d3jn]

Recently had a need to retrieve original (on-bound) route's parameters values (similar to original attributes values in Eloquent), such feature was requested for some time too. Here is the issue laravel/ideas#1260 where this feature has been requested/discussed previously.

This PR just adds additional field to Illuminate\Routing\Route to preserve parameters original state - this field is initialized only once when route is bound and has public getters that mimic already existing methods for parameters field.

[imanghafoori1]

Where are the unit tests then?

[imanghafoori1]

Does the logic exception make sense ?!
You may just return an empty array or something.
Exceptions are not good to throw to the users as I know.

[d3jn]

@imanghafoori1

Does the logic exception make sense ?!
You may just return an empty array or something.
Exceptions are not good to throw to the users as I know.

LogicException is part of standard PHP library and to quote official documentation on the matter:

[It is] exception that represents error in the program logic. This kind of exception should lead directly to a fix in your code.

So it makes sense to be here because it indicates that you are trying to access parameters of yet to be bound route instance (which is a clear indication of an error in your code). It was already thrown when accessing unset parameters field, so it should also be thrown when trying to access original parameters too (because originalParameters just initialized with on-bound parameters value and is available only when parameters field is).

Where are the unit tests then?

Sure, will append this PR with tests. My bad.

[martinbean]

@d3jn Is this for retrieving the value of a route parameter before it’s bound to a model, i.e. the original string representation?

[d3jn]

@martinbean yes. It should come handy in case your resolution logic mutates the value in a way that it can no longer be retrieved from the resolved one or will require you to do additional queries/operations to do so (as it was in my case).

[martinbean]

@d3jn Great. Thanks!