[5.8] Support JSON queries on MariaDB

[staudenmeir]

Laravel uses the -> operator to query JSON columns on MySQL:

select * from `users` where `options`->'$."language"' = ?

This operator is specific to MySQL and not available on MariaDB. We can support both databases by using the JSON_EXTRACT() function instead (MySQL, MariaDB):

select * from `users` where json_extract(`options`, '$."language"') = ?

From the MySQL documentation:

The -> operator serves as an alias for the JSON_EXTRACT() function [...]

The ->> operator can be used to unquote the JSON result (User::select('options->>language')). In this case, we have to wrap JSON_EXTRACT() in JSON_UNQUOTE() (MySQL, MariaDB).

For whereJsonContains() we have to split the JSON selector into the field and the path and pass the optional path as the third parameter (MySQL, MariaDB).

whereJsonLength() already supports MariaDB.

This is a breaking change for people who select JSON values without a column alias:

$user = User::select('options->language')->first();
dd($user->{'`options`->\'$."language"\''});

This PR also simplifies SQLiteGrammar and SqlServerGrammar by using wrapJsonFieldAndPath().

[X-Coder264]

@staudenmeir Could you please document this breaking change in the upgrade docs for 5.8?

[wimil]

support laravel 6 ?

[richbowen]

Is this available in laravel 7 and 8?

[staudenmeir]

@rgb-one Yes.