Новый синтаксис where() и update() для JSON-столбцов в Laravel 5.3

Статистика: Символов — 2 426/2 015 без пробелов (1 531/1 280 без кода):, слов — 252
Разметка: Wiki
Возможность преобразования данных в формат JSON и из него появилась в Laravel в версии 5.0, но раньше это было сделано только для удобства, а данные хранились по-прежнему в текстовом поле. Но в MySQL 5.7 появился настоящий тип JSON.

В Laravel 5.3 появился простой синтаксис для поиска и изменения данных на основе значений конкретных ключей в JSON-столбцах.
{{CUT}}
Предположим, у нас есть таблица с JSON-столбцом:
%%
...
class CreateContactsTable extends Migration
{
  public function up()
  {
    Schema::create('contacts', function (Blueprint $table) {
      $table->increments('id');
      $table->string('name');
      $table->json('meta');
      $table->timestamps();
    });
  }
%%

Представим, что у каждого контакта есть обязательные данные, например, его имя, а набор остальных свойств у разных контактов может различаться. Возможно лучше всего хранить их в JSON-столбце, в примере это столбец %%(t)meta%%.

Предположим, один из контактов выглядит так (вывод в JSON для читаемости):
%%
{
  "id": 1,
  "name": "Alphonse",
  "meta": {
    "wants_newsletter": true,
    "favorite_color": "red"
  }
}
%%

Итак, давайте найдём всех наших пользователей, чей любимый цвет красный. Посмотрите на пример ниже: сначала мы указываем столбец (%%(t)meta%%), затем ставим стрелку (%%(t)->%%), и указываем название ключа JSON-свойства (%%(t)favorite_color%%).
%%
$redLovers = DB::table('users')
  ->where('meta->favorite_color', 'red')
  ->get();
%%

Это означает "найди каждую запись таблицы %%(t)users%%, у которой в %%(t)meta%% хранится JSON-объект, у которого есть ключ %%(t)favorite_color%%, который равен %%(t)red%%".

А если нам надо указать, что %%(t)Alphonse%% больше не хочет получать рассылку новостей?
%%
DB::table('users')
  ->where('id', 1)
  ->update(['meta->wants_newsletter' => false]);
%%

Это здорово, потому что, даже если раньше ключа %%(t)wants_newsletter%% в этой записи не было, теперь он в ней будет, и ему будет присвоено значение %%(t)false%%.

Чувствуете мощь? Мы можем запрашивать данные на основе свойств в JSON-столбцах //и// мы можем изменять отдельные части в JSON-столбце, не проверяя и не переживая за остальные его части. Великолепно.

.(alert)
В MariaDB нет JSON-столбцов, и в PostgreSQL нет JSON-столбцов, и с ними данная функция не будет работать корректно. Поэтому считайте, что пока эта функция только для MySQL 5.7+.