nuwave/ember-eloquent

Laravel package to translate api responses into ember-data readable formats.

Ember-Eloquent

Introduction

I have been working quite a bit with Ember recently and I wanted to create Ember Data formatted responses including sideloading. This proeject utilizes Fractal's JsonApiSerializer and tweaks it a bit to create json responses that are consumable by ember-data., _(*1)

This is still a work in progress, so please use with caution, _(*2)

Installation

Install the composer package, _(*3)

composer require nuwave/ember-eloquent

Add the service provider to you app.php file, _(*4)

'NuWave\Serializers\SerializerServiceProvider',

Publish the config file, _(*5)

php artisan vendor:publish

Create your model transformers (Fractal), _(*6)

Fractal Transformer Guide, _(*7)

Edit the config file with your application namespace (optional: you can also add a suffix if your naming convension utilizes it), _(*8)

// config/ember.php

return [
    /*
    |---------------------------------------------------------------------
    | Transformer Namespace
    |---------------------------------------------------------------------
    |
    | Set the default namespace for your transformer
    |
    */
    'namespace' => 'MyApp\Transformers',

    /*
    |---------------------------------------------------------------------
    | Transformer Suffix
    |---------------------------------------------------------------------
    |
    | Set the suffix for your transformer naming convention.
    |
    | Default value is null
    */
    'suffix' => null
];

Add EmberTrait to your controllers (or your base Controller). This will allow you to utilize the emberResponse method which takes your Model/Collection along with the model name and transforms it into an ember-data formatted response., _(*9)

class UserController extends Controller {

  use EmberTrait;

  public function index()
  {
    $users = User::all();

    // or

    $users = User::paginate(20); // meta data will be included in response

    return $this->emberResponse($users, 'User');
  }

  // ...

  public function show($id)
  {
    $user = User::find($id);

    return $this->emberResponse($user, 'User');
  }
}