hungnm1518/laravel-repositories

Laravel 5|6|7|8|9 - 数据库层的存储库

v6.0.1 2023-02-24 16:03 UTC

This package is auto-updated.

Last update: 2024-09-24 19:44:23 UTC


README

Laravel 5 存储库用于抽象数据层,使我们的应用程序更易于维护。

Latest Stable Version Total Downloads Latest Unstable Version License Analytics Code Climate

查看版本: 1.0.* / 2.0.*

迁移到: 2.0 / 2.1

你想了解更多关于存储库模式的信息? 阅读这篇优秀的文章

目录

安装

Composer

执行以下命令以获取软件包的最新版本:

composer require prettus/l5-repository

Laravel

>= laravel5.5

ServiceProvider 将自动附加

其他

在你的 config/app.php 中,将 Prettus\Repository\Providers\RepositoryServiceProvider::class 添加到 providers 数组的末尾

'providers' => [
    ...
    Prettus\Repository\Providers\RepositoryServiceProvider::class,
],

如果使用 Lumen

$app->register(Prettus\Repository\Providers\LumenRepositoryServiceProvider::class);

发布配置

php artisan vendor:publish --provider "Prettus\Repository\Providers\RepositoryServiceProvider"

方法

Prettus\Repository\Contracts\RepositoryInterface

  • all($columns = array('*'))
  • first($columns = array('*'))
  • paginate($limit = null, $columns = ['*'])
  • find($id, $columns = ['*'])
  • findByField($field, $value, $columns = ['*'])
  • findWhere(array $where, $columns = ['*'])
  • findWhereIn($field, array $where, $columns = [*])
  • findWhereNotIn($field, array $where, $columns = [*])
  • findWhereBetween($field, array $where, $columns = [*])
  • create(array $attributes)
  • update(array $attributes, $id)
  • updateOrCreate(array $attributes, array $values = [])
  • delete($id)
  • deleteWhere(array $where)
  • orderBy($column, $direction = 'asc');
  • with(array $relations);
  • has(string $relation);
  • whereHas(string $relation, closure $closure);
  • hidden(array $fields);
  • visible(array $fields);
  • scopeQuery(Closure $scope);
  • getFieldsSearchable();
  • setPresenter($presenter);
  • skipPresenter($status = true);

Prettus\Repository\Contracts\RepositoryCriteriaInterface

  • pushCriteria($criteria)
  • popCriteria($criteria)
  • getCriteria()
  • getByCriteria(CriteriaInterface $criteria)
  • skipCriteria($status = true)
  • getFieldsSearchable()

Prettus\Repository\Contracts\CacheableInterface

  • setCacheRepository(CacheRepository $repository)
  • getCacheRepository()
  • getCacheKey($method, $args = null)
  • getCacheTime()
  • skipCache($status = true)

Prettus\Repository\Contracts\PresenterInterface

  • present($data);

Prettus\Repository\Contracts\Presentable

  • setPresenter(PresenterInterface $presenter);
  • presenter();

Prettus\Repository\Contracts\CriteriaInterface

  • apply($model, RepositoryInterface $repository);

Prettus\Repository\Contracts\Transformable

  • transform();

用法

创建模型

正常创建您的模型,但定义可以从输入表单数据填充的属性很重要。

namespace App;

class Post extends Eloquent { // or Ardent, Or any other Model Class

    protected $fillable = [
        'title',
        'author',
        ...
     ];

     ...
}

创建存储库

namespace App;

use Prettus\Repository\Eloquent\BaseRepository;

class PostRepository extends BaseRepository {

    /**
     * Specify Model class name
     *
     * @return string
     */
    function model()
    {
        return "App\\Post";
    }
}

生成器

通过生成器轻松创建您的仓库。

配置

您必须首先配置仓库文件的存储位置。默认为 "app" 文件夹和 "App" 命名空间。请注意,paths 数组中的值实际上同时用作 命名空间 和文件路径。不过,生成过程中会处理正斜杠和反斜杠。

    ...
    'generator'=>[
        'basePath'=>app()->path(),
        'rootNamespace'=>'App\\',
        'paths'=>[
            'models'       => 'Entities',
            'repositories' => 'Repositories',
            'interfaces'   => 'Repositories',
            'transformers' => 'Transformers',
            'presenters'   => 'Presenters',
            'validators'   => 'Validators',
            'controllers'  => 'Http/Controllers',
            'provider'     => 'RepositoryServiceProvider',
            'criteria'     => 'Criteria',
        ]
    ]

您可能希望将项目文件夹的根目录放在 "app" 之外,并添加另一个命名空间,例如

    ...
     'generator'=>[
        'basePath'      => base_path('src/Lorem'),
        'rootNamespace' => 'Lorem\\'
    ]

此外,您可能希望自定义生成的类保存的位置。可以通过编辑 paths 节点来实现。例如

    'generator'=>[
        'basePath'=>app()->path(),
        'rootNamespace'=>'App\\',
        'paths'=>[
            'models'=>'Models',
            'repositories'=>'Repositories\\Eloquent',
            'interfaces'=>'Contracts\\Repositories',
            'transformers'=>'Transformers',
            'presenters'=>'Presenters'
            'validators'   => 'Validators',
            'controllers'  => 'Http/Controllers',
            'provider'     => 'RepositoryServiceProvider',
            'criteria'     => 'Criteria',
        ]
    ]

命令

要为您的模型生成所有需要的内容,请运行此命令

php artisan make:entity Post

这将创建控制器、验证器、模型、仓库、表示器和转换器类。它还将创建一个新的服务提供程序,该提供程序将用于将 Eloquent 仓库与其对应的仓库接口绑定。要加载它,只需将以下内容添加到 AppServiceProvider 的 @register 方法中

    $this->app->register(RepositoryServiceProvider::class);

您还可以传递来自 repository 命令的选项,因为此命令只是一个包装器。

要为您的 Post 模型生成仓库,请使用以下命令

php artisan make:repository Post

要为具有 Blog 命名空间的 Post 模型生成仓库,请使用以下命令

php artisan make:repository "Blog\Post"

添加可填充字段

php artisan make:repository "Blog\Post" --fillable="title,content"

要直接通过命令添加验证规则,需要传递 --rules 选项并创建迁移

php artisan make:entity Cat --fillable="title:string,content:text" --rules="title=>required|min:2, content=>sometimes|min:10"

该命令还会创建您的基本 RESTful 控制器,只需将此行添加到 routes.php 文件中,您将拥有基本的 CRUD。

Route::resource('cats', CatsController::class);

运行命令时,您将创建默认设置的文件夹中的 "Entities" 和 "Repositories"。

现在已完成,您仍然需要将其接口绑定到您的实际仓库,例如在您的自己的 Repositories 服务提供程序中。

App::bind('{YOUR_NAMESPACE}Repositories\PostRepository', '{YOUR_NAMESPACE}Repositories\PostRepositoryEloquent');

使用

public function __construct({YOUR_NAMESPACE}Repositories\PostRepository $repository){
    $this->repository = $repository;
}

或者,您可以使用 artisan 命令为您执行绑定。

php artisan make:bindings Cats

使用方法

namespace App\Http\Controllers;

use App\PostRepository;

class PostsController extends BaseController {

    /**
     * @var PostRepository
     */
    protected $repository;

    public function __construct(PostRepository $repository){
        $this->repository = $repository;
    }

    ....
}

在仓库中查找所有结果

$posts = $this->repository->all();

带分页的仓库中查找所有结果

$posts = $this->repository->paginate($limit = null, $columns = ['*']);

按 id 查找结果

$post = $this->repository->find($id);

隐藏模型属性

$post = $this->repository->hidden(['country_id'])->find($id);

只显示模型特定属性

$post = $this->repository->visible(['id', 'state_id'])->find($id);

加载模型关系

$post = $this->repository->with(['state'])->find($id);

按字段名查找结果

$posts = $this->repository->findByField('country_id','15');

按多个字段查找结果

$posts = $this->repository->findWhere([
    //Default Condition =
    'state_id'=>'10',
    'country_id'=>'15',

    //Custom Condition
    ['columnName1','>','10'],

    //DATE, DAY, MONTH, YEAR
    ['columnName2','DATE','2021-07-02'], //whereDate
    ['columnName3','DATE >=','2021-07-02'], //whereDate with operator

    ['columnName4','IN',['value1','value2']], //whereIn
    ['columnName5','NOTIN',['value1','value2']], //whereNotIn
    ['columnName6','EXIST',''], //whereExists
    
    //HAS, HASMORPH, DOESNTHAVE, DOESNTHAVEMORPH
    ['columnName7','HAS',function($query){}], //whereHas

    //BETWEEN, BETWEENCOLUMNS, NOTBETWEEN, NOTBETWEENCOLUMNS
    ['columnName8','BETWEEN',[10, 100]], //whereBetween
]);

按一个字段中的多个值查找结果

$posts = $this->repository->findWhereIn('id', [1,2,3,4,5]);

按一个字段中排除多个值查找结果

$posts = $this->repository->findWhereNotIn('id', [6,7,8,9,10]);

使用自定义范围查找所有结果

$posts = $this->repository->scopeQuery(function($query){
    return $query->orderBy('sort_order','asc');
})->all();

在仓库中创建新条目

$post = $this->repository->create( Input::all() );

在仓库中更新条目

$post = $this->repository->update( Input::all(), $id );

在仓库中删除条目

$this->repository->delete($id)

按多个字段删除仓库中的条目

$this->repository->deleteWhere([
    //Default Condition =
    'state_id'=>'10',
    'country_id'=>'15',
])

创建条件

使用命令

php artisan make:criteria MyCriteria

标准是更改查询仓库的一种方式,通过根据您的需求应用特定的条件。您可以在您的仓库中添加多个标准。

use Prettus\Repository\Contracts\RepositoryInterface;
use Prettus\Repository\Contracts\CriteriaInterface;

class MyCriteria implements CriteriaInterface {

    public function apply($model, RepositoryInterface $repository)
    {
        $model = $model->where('user_id','=', Auth::user()->id );
        return $model;
    }
}

在控制器中使用条件

namespace App\Http\Controllers;

use App\PostRepository;

class PostsController extends BaseController {

    /**
     * @var PostRepository
     */
    protected $repository;

    public function __construct(PostRepository $repository){
        $this->repository = $repository;
    }


    public function index()
    {
        $this->repository->pushCriteria(new MyCriteria1());
        $this->repository->pushCriteria(MyCriteria2::class);
        $posts = $this->repository->all();
		...
    }

}

从标准获取结果

$posts = $this->repository->getByCriteria(new MyCriteria());

在仓库中设置默认标准

use Prettus\Repository\Eloquent\BaseRepository;

class PostRepository extends BaseRepository {

    public function boot(){
        $this->pushCriteria(new MyCriteria());
        // or
        $this->pushCriteria(AnotherCriteria::class);
        ...
    }

    function model(){
       return "App\\Post";
    }
}

跳过仓库中定义的标准

在调用任何其他链接方法之前使用 skipCriteria

$posts = $this->repository->skipCriteria()->all();

弹出标准

使用 popCriteria 来删除标准

$this->repository->popCriteria(new Criteria1());
// or
$this->repository->popCriteria(Criteria1::class);

使用请求条件

RequestCriteria 是标准的标准实现。它允许过滤器从请求中发送的参数在仓库中执行。

您可以进行动态搜索,过滤数据并自定义查询。

要在您的仓库中使用标准,您可以在仓库的 boot 方法中添加新的标准,或者直接在控制器中使用,以便过滤出只有少数请求。

在存储库中启用

use Prettus\Repository\Eloquent\BaseRepository;
use Prettus\Repository\Criteria\RequestCriteria;


class PostRepository extends BaseRepository {

	/**
     * @var array
     */
    protected $fieldSearchable = [
        'name',
        'email'
    ];

    public function boot(){
        $this->pushCriteria(app('Prettus\Repository\Criteria\RequestCriteria'));
        ...
    }

    function model(){
       return "App\\Post";
    }
}

记住,您需要定义模型中哪些字段是可以搜索的。

在您的仓库中,将 $fieldSearchable 设置为要搜索的字段名称或字段之间的关系。

protected $fieldSearchable = [
	'name',
	'email',
	'product.name'
];

您可以设置用于执行查询的条件类型,默认条件是 "="

protected $fieldSearchable = [
	'name'=>'like',
	'email', // Default Condition "="
	'your_field'=>'condition'
];

在控制器中启用

	public function index()
    {
        $this->repository->pushCriteria(app('Prettus\Repository\Criteria\RequestCriteria'));
        $posts = $this->repository->all();
		...
    }

示例:条件

通过请求请求所有数据而不进行过滤

http://prettus.local/users

[
    {
        "id": 1,
        "name": "John Doe",
        "email": "john@gmail.com",
        "created_at": "-0001-11-30 00:00:00",
        "updated_at": "-0001-11-30 00:00:00"
    },
    {
        "id": 2,
        "name": "Lorem Ipsum",
        "email": "lorem@ipsum.com",
        "created_at": "-0001-11-30 00:00:00",
        "updated_at": "-0001-11-30 00:00:00"
    },
    {
        "id": 3,
        "name": "Laravel",
        "email": "laravel@gmail.com",
        "created_at": "-0001-11-30 00:00:00",
        "updated_at": "-0001-11-30 00:00:00"
    }
]

在仓库中执行研究

http://prettus.local/users?search=John%20Doe

或者

http://prettus.local/users?search=John&searchFields=name:like

或者

http://prettus.local/users?search=john@gmail.com&searchFields=email:=

或者

http://prettus.local/users?search=name:John Doe;email:john@gmail.com

或者

http://prettus.local/users?search=name:John;email:john@gmail.com&searchFields=name:like;email:=

[
    {
        "id": 1,
        "name": "John Doe",
        "email": "john@gmail.com",
        "created_at": "-0001-11-30 00:00:00",
        "updated_at": "-0001-11-30 00:00:00"
    }
]

您可以使用“search”参数而不使用完整的“searchFields”参数。

http://prettus.local/users?search=id:2;age:17;email:john@gmail.com&searchFields='id':=

默认情况下,RequestCriteria 使用每个查询参数的 OR 比较运算符进行查询。http://prettus.local/users?search=age:17;email:john@gmail.com

上面的示例将执行以下查询

SELECT * FROM users WHERE age = 17 OR email = 'john@gmail.com';

为了使用 AND 进行查询,传递如下的 searchJoin 参数

http://prettus.local/users?search=age:17;email:john@gmail.com&searchJoin=and

过滤字段

http://prettus.local/users?filter=id;name

[
    {
        "id": 1,
        "name": "John Doe"
    },
    {
        "id": 2,
        "name": "Lorem Ipsum"
    },
    {
        "id": 3,
        "name": "Laravel"
    }
]

排序结果

http://prettus.local/users?filter=id;name&orderBy=id&sortedBy=desc

[
    {
        "id": 3,
        "name": "Laravel"
    },
    {
        "id": 2,
        "name": "Lorem Ipsum"
    },
    {
        "id": 1,
        "name": "John Doe"
    }
]

通过相关表排序

http://prettus.local/users?orderBy=posts|title&sortedBy=desc

查询将类似于以下内容

...
INNER JOIN posts ON users.post_id = posts.id
...
ORDER BY title
...

http://prettus.local/users?orderBy=posts:custom_id|posts.title&sortedBy=desc

查询将类似于以下内容

...
INNER JOIN posts ON users.custom_id = posts.id
...
ORDER BY posts.title
...

http://prettus.local/users?orderBy=posts:custom_id,other_id|posts.title&sortedBy=desc

查询将类似于以下内容

...
INNER JOIN posts ON users.custom_id = posts.other_id
...
ORDER BY posts.title
...

使用相同排序方式的多列排序

http://prettus.local/users?orderBy=name;created_at&sortedBy=desc

结果将类似于以下内容

   [
       {
           "id": 1,
           "name": "Laravel",
           "created_at": "-0001-11-29 00:00:00"
       },
       {
           "id": 3,
           "name": "Laravel",
           "created_at": "-0001-11-28 00:00:00"
       },
       {
           "id": 2,
           "name": "John Doe",
           "created_at": "-0001-11-30 00:00:00"
       }
   ]

使用不同排序方式的多列排序

http://prettus.local/users?orderBy=name;created_at&sortedBy=desc;asc

结果将类似于以下内容

   [
       {
           "id": 3,
           "name": "Laravel",
           "created_at": "-0001-11-28 00:00:00"
       },
       {
           "id": 1,
           "name": "Laravel",
           "created_at": "-0001-11-29 00:00:00"
       },
       {
           "id": 2,
           "name": "John Doe",
           "created_at": "-0001-11-30 00:00:00"
       }
   ]

添加关系

http://prettus.local/users?with=groups

过滤范围

http://prettus.local/product?search=price:100,500&searchFields=price:between

结果将类似于以下内容

   [
       {
           "id": 3,
           "price": "150",
           "created_at": "-0001-11-28 00:00:00"
       },
       {
           "id": 1,
           "price": "300",
           "created_at": "-0001-11-29 00:00:00"
       },
       {
           "id": 2,
           "price": "450",
           "created_at": "-0001-11-30 00:00:00"
       }
   ]

WhereIn 过滤

http://prettus.local/product?search=price:300,500&searchFields=price:in

结果将类似于以下内容

   [
       {
           "id": 1,
           "price": "300",
           "created_at": "-0001-11-29 00:00:00"
       }
   ]

重写参数名称

您可以在配置文件 config/repository.php 中更改参数的名称

缓存

轻松地为您的仓库添加缓存层

缓存使用

实现 CacheableInterface 接口并使用 CacheableRepository 特性。

use Prettus\Repository\Eloquent\BaseRepository;
use Prettus\Repository\Contracts\CacheableInterface;
use Prettus\Repository\Traits\CacheableRepository;

class PostRepository extends BaseRepository implements CacheableInterface {

    use CacheableRepository;

    ...
}

完成,这样您的仓库就会被缓存,并且在创建、修改或删除项目时,仓库缓存会被清除。

缓存配置

您可以在文件 config/repository.php 中更改缓存设置,也可以直接在您的仓库上进行更改。

config/repository.php

'cache'=>[
    //Enable or disable cache repositories
    'enabled'   => true,

    //Lifetime of cache
    'minutes'   => 30,

    //Repository Cache, implementation Illuminate\Contracts\Cache\Repository
    'repository'=> 'cache',

    //Sets clearing the cache
    'clean'     => [
        //Enable, disable clearing the cache on changes
        'enabled' => true,

        'on' => [
            //Enable, disable clearing the cache when you create an item
            'create'=>true,

            //Enable, disable clearing the cache when upgrading an item
            'update'=>true,

            //Enable, disable clearing the cache when you delete an item
            'delete'=>true,
        ]
    ],
    'params' => [
        //Request parameter that will be used to bypass the cache repository
        'skipCache'=>'skipCache'
    ],
    'allowed'=>[
        //Allow caching only for some methods
        'only'  =>null,

        //Allow caching for all available methods, except
        'except'=>null
    ],
],

您可以直接在仓库中覆盖这些设置。

use Prettus\Repository\Eloquent\BaseRepository;
use Prettus\Repository\Contracts\CacheableInterface;
use Prettus\Repository\Traits\CacheableRepository;

class PostRepository extends BaseRepository implements CacheableInterface {

    // Setting the lifetime of the cache to a repository specifically
    protected $cacheMinutes = 90;

    protected $cacheOnly = ['all', ...];
    //or
    protected $cacheExcept = ['find', ...];

    use CacheableRepository;

    ...
}

可缓存的方发有:all, paginate, find, findByField, findWhere, getByCriteria

验证器

需要 prettus/laravel-validator. composer require prettus/laravel-validator

使用 prettus/laravel-validator 进行简单验证

有关更多详细信息,请点击此处

使用验证器类

创建验证器

在下面的示例中,我们为创建和编辑定义了一些规则

use \Prettus\Validator\LaravelValidator;

class PostValidator extends LaravelValidator {

    protected $rules = [
        'title' => 'required',
        'text'  => 'min:3',
        'author'=> 'required'
    ];

}

要定义特定规则,请按以下步骤进行

use \Prettus\Validator\Contracts\ValidatorInterface;
use \Prettus\Validator\LaravelValidator;

class PostValidator extends LaravelValidator {

    protected $rules = [
        ValidatorInterface::RULE_CREATE => [
            'title' => 'required',
            'text'  => 'min:3',
            'author'=> 'required'
        ],
        ValidatorInterface::RULE_UPDATE => [
            'title' => 'required'
        ]
   ];

}
在存储库中启用验证器
use Prettus\Repository\Eloquent\BaseRepository;
use Prettus\Repository\Criteria\RequestCriteria;

class PostRepository extends BaseRepository {

    /**
     * Specify Model class name
     *
     * @return mixed
     */
    function model(){
       return "App\\Post";
    }

    /**
     * Specify Validator class name
     *
     * @return mixed
     */
    public function validator()
    {
        return "App\\PostValidator";
    }
}

在存储库中定义规则

或者,您可以直接在规则仓库属性中设置您的规则,这将与 Validation 类具有相同的效果,而不必使用一个类来定义其验证规则。

use Prettus\Repository\Eloquent\BaseRepository;
use Prettus\Repository\Criteria\RequestCriteria;
use Prettus\Validator\Contracts\ValidatorInterface;

class PostRepository extends BaseRepository {

    /**
     * Specify Validator Rules
     * @var array
     */
     protected $rules = [
        ValidatorInterface::RULE_CREATE => [
            'title' => 'required',
            'text'  => 'min:3',
            'author'=> 'required'
        ],
        ValidatorInterface::RULE_UPDATE => [
            'title' => 'required'
        ]
   ];

    /**
     * Specify Model class name
     *
     * @return mixed
     */
    function model(){
       return "App\\Post";
    }

}

验证现在已就绪。如果验证失败,将会抛出类型为 Prettus\Validator\Exceptions\ValidatorException 的异常

演示者

表示者充当对象的包装器和渲染器

Fractal 演示者

需要 Fractal. composer require league/fractal

实现Presenter有两种方式,第一种是创建一个TransformerAbstract,并使用你的Presenter类设置它,具体方法见《创建Transformer类》。

第二种方式是让你的模型实现Transformable接口,并使用默认的Presenter ModelFractalPresenter,这会产生相同的效果。

Transformer类
使用以下命令创建Transformer
php artisan make:transformer Post

这将生成下面的类。

创建Transformer类
use League\Fractal\TransformerAbstract;

class PostTransformer extends TransformerAbstract
{
    public function transform(\Post $post)
    {
        return [
            'id'      => (int) $post->id,
            'title'   => $post->title,
            'content' => $post->content
        ];
    }
}
使用以下命令创建Presenter
php artisan make:presenter Post

如果你还没有创建Transformer,该命令会提示你创建。

创建Presenter
use Prettus\Repository\Presenter\FractalPresenter;

class PostPresenter extends FractalPresenter {

    /**
     * Prepare data to present
     *
     * @return \League\Fractal\TransformerAbstract
     */
    public function getTransformer()
    {
        return new PostTransformer();
    }
}
在存储库中启用
use Prettus\Repository\Eloquent\BaseRepository;

class PostRepository extends BaseRepository {

    ...

    public function presenter()
    {
        return "App\\Presenter\\PostPresenter";
    }
}

或者,你可以在控制器中通过以下方式启用它

$this->repository->setPresenter("App\\Presenter\\PostPresenter");
从模型使用Presenter之后

如果你记录了一个Presenter,有时使用了skipPresenter()方法,或者你不想你的结果被Presenter自动更改。你可以在你的模型上实现Presentable接口,这样你就可以在任何时候展示你的模型。见下文

在你的模型中实现接口Prettus\Repository\Contracts\PresentablePrettus\Repository\Traits\PresentableTrait

namespace App;

use Prettus\Repository\Contracts\Presentable;
use Prettus\Repository\Traits\PresentableTrait;

class Post extends Eloquent implements Presentable {

    use PresentableTrait;

    protected $fillable = [
        'title',
        'author',
        ...
     ];

     ...
}

现在,你可以单独提交你的模型,见以下示例

$repository = app('App\PostRepository');
$repository->setPresenter("Prettus\\Repository\\Presenter\\ModelFractalPresenter");

//Getting the result transformed by the presenter directly in the search
$post = $repository->find(1);

print_r( $post ); //It produces an output as array

...

//Skip presenter and bringing the original result of the Model
$post = $repository->skipPresenter()->find(1);

print_r( $post ); //It produces an output as a Model object
print_r( $post->presenter() ); //It produces an output as array

你可以在每次访问时跳过Presenter,并直接在模型中使用它,为了实现这一点,在你的仓库中将$skipPresenter属性设置为true

use Prettus\Repository\Eloquent\BaseRepository;

class PostRepository extends BaseRepository {

    /**
    * @var bool
    */
    protected $skipPresenter = true;

    public function presenter()
    {
        return "App\\Presenter\\PostPresenter";
    }
}
模型类
实现接口
namespace App;

use Prettus\Repository\Contracts\Transformable;

class Post extends Eloquent implements Transformable {
     ...
     /**
      * @return array
      */
     public function transform()
     {
         return [
             'id'      => (int) $this->id,
             'title'   => $this->title,
             'content' => $this->content
         ];
     }
}
在存储库中启用

Prettus\Repository\Presenter\ModelFractalPresenter是实现了Transformable的模型的默认Presenter

use Prettus\Repository\Eloquent\BaseRepository;

class PostRepository extends BaseRepository {

    ...

    public function presenter()
    {
        return "Prettus\\Repository\\Presenter\\ModelFractalPresenter";
    }
}

或者,你可以在控制器中通过以下方式启用它

$this->repository->setPresenter("Prettus\\Repository\\Presenter\\ModelFractalPresenter");

在仓库中跳过Presenter定义

在使用任何其他链式方法之前使用skipPresenter

$posts = $this->repository->skipPresenter()->all();

或者

$this->repository->skipPresenter();

$posts = $this->repository->all();