Skip to content

Latest commit

 

History

History
143 lines (94 loc) · 6.47 KB

eloquent-serialization.md

File metadata and controls

143 lines (94 loc) · 6.47 KB

git b1d293216e13a68917ae3ab4ef2b4235101610d0

Eloquent: Сериализация

Вступление

При построении JSON API, очень часто требуется конвертация моделей и отношений в массивы или JSON. Eloquent обладает как удобным механизмом для подобных конвертаций, так и инструментами для контроля над отдельными атрибутами при сериализации.

Основы использования

Преобразование модели в массив

Чтобы преобразовать модель вместе с загруженными отношениями в массив, можно использовать метод toArray. Этот метод рекурсивный, таким образом все атрибуты и все отношения (включая отношения отношений) будут преобразованы в массивы:

$user = App\User::with('roles')->first();

return $user->toArray();

Также можно преобразовывать в массивы и коллекции:

$users = App\User::all();

return $users->toArray();

Преобразование модели в JSON

Чтобы преобразовать модель в JSON можно использовать метод toJson. Как и toArray, метод toJson рекурсивный, таким образом все атрибуты и все отношения будут преобразованы в JSON:

$user = App\User::find(1);

return $user->toJson();

Как вариант, можно привести модель или коллекцию к строке, что автоматически сделает вызов метода toJson:

$user = App\User::find(1);

return (string) $user;

Т.к. модели и коллекции преобразуются в JSON при приведении к строке, вы можете возвращать объекты Eloquent напрямую из маршрутов и контроллеров:

Route::get('users', function () {
    return App\User::all();
});

Скрытие атрибутов при экспорте в JSON

Иногда необходимо ограничить видимость атрибутов (таких как например пароль) при конвертации в массив или JSON представление. Для реализации этого функционала добавьте атрибут $hidden к своей модели таким образом:

<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    /**
     * Перечень полей, которые должны быть скрыты при экспорте.
     *
     * @var array
     */
    protected $hidden = ['password'];
}

Обратите внимание: Когда скрываете отношения, используйте название метода, а не имя динамического атрибута.

В качестве альтернативного варианта, можно использовать атрибут visible и определить "белый" список разрешенных полей и отношений при конвертации в JSON:

<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    /**
     *Перечень полей, которые должны быть доступны при экспорте.
     *
     * @var array
     */
    protected $visible = ['first_name', 'last_name'];
}

Временно открываем спрятанные атрибуты

Если вам необходимо в какой-то ситуации открыть обычно спрятанный атрибут, используйте метод makeVisible. Метод makeVisible возвращает инстанс модели для удобства построения цепочки вызовов:

return $user->makeVisible('attribute')->toArray();

Добавление атрибутов в JSON

Бывают ситуации, когда при экспорте вам может понадобиться добавить атрибуты, соответствующих полей для которых в БД нет. Чтобы сделать это, для начала, определите для него получающий метод (аксессор):

<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    /**
     * Получить признак админа для пользователя.
     *
     * @return bool
     */
    public function getIsAdminAttribute()
    {
        return $this->attributes['admin'] == 'yes';
    }
}

После того, как такой метод создан, добавьте имя атрибута в проперти appends:

<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    /**
     * Перечень атрибутов для добавления при экспорте через получающие методы (аксессоры).
     *
     * @var array
     */
    protected $appends = ['is_admin'];
}

После того как атрибут добавлен в массив appends, он будет доступен как при конвертации в массив так и JSON. К этим атрибутам также относятся правила, заданные в visible и hidden массивах.