[10.x] add Storage::json() method to read and decode a json file

[lorenzolosa]

Laravel v10.4.0 introduced a File::json() method to retrieve json encoded data from a file. That's nice, but often files are accessed using Storage and not File. Here I'm adding a similar Storage::json(), i.e.:

$data = Storage::json('sample.json');

which is equivalent to:

$contents = Storage::get('sample.json');
$data = json_decode($contents, true);

This is really the same as #46481, but for Storage instead of File.

[ankurk91]

Can you add JSON_THROW_ON_ERROR option

[cosmastech]

Can you add JSON_THROW_ON_ERROR option

Would it make sense to be able to pass all of the normal json_decode() args?

[taylorotwell]

Flag support added to both methods.

[chrysanthos]

Isn't this a breaking change? The $lock parameter is now third instead of second?

[driesvints]

I've sent in a PR to revert this one.

[driesvints]

It seems this isn't released yet so there's no breaking change here.