l5-repository的使用

最新推荐文章于 2024-12-06 14:41:40 发布

大唐锦绣

最新推荐文章于 2024-12-06 14:41:40 发布

阅读量5.3k

点赞数 3

分类专栏： # Laravel 文章标签： laravel l5-repository

本文链接：https://blog.csdn.net/qq_27295403/article/details/82967600

版权

Laravel 专栏收录该内容

34 篇文章

订阅专栏

这是l5-repository基础使用

Host: GitHub

License: MIT

Language: PHP

安装
Composer
Laravel
方法
Prettus\Repository\Contracts\RepositoryInterface
Prettus\Repository\Contracts\RepositoryCriteriaInterface
Prettus\Repository\Contracts\CacheableInterface
Prettus\Repository\Contracts\PresenterInterface
Prettus\Repository\Contracts\Presentable
Prettus\Repository\Contracts\CriteriaInterface
Prettus\Repository\Contracts\Transformable
用法
创建一个模型
创建一个仓库
Use methods--使用方法
Create a Criteria--创建一个标准（条件）
Using the Criteria in a Controller --在你的控制器中使用标准
Skip criteria defined in the repository --跳过仓库中定义的标准
Popping criteria --弹出标准
Using the RequestCriteria --使用请求标准
Cache --缓存
Validators --验证器
Presenters --呈现器
Skip Presenter defined in the repository 在仓库中跳过呈现器定义

安装

Composer

执行以下命令以获得l5-repository的最新版本:

composer require prettus/l5-repository

Laravel

在您的 config/app.php下的provider数组下结尾处添加

Prettus\Repository\Providers\RepositoryServiceProvider::class

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

If Lumen

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

发布配置(添加配置config/repository.php文件)

php artisan vendor:publish

方法

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 = [*])
create(array $attributes)
update(array $attributes, $id)
updateOrCreate(array $attributes, array $values = [])
delete($id)
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)
getCacheMinutes()
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',
        ...
     ];

     ...
}

创建一个仓库

```php namespace App;

use Prettus\Repository\Eloquent\BaseRepository;

class PostRepository extends BaseRepository {

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

}


### Generators--创建器

通过创建器轻松创建的你仓库

#### Config

You must first configure the storage location of the repository files. By default is the "app" folder and the namespace "App". Please note that, values in the `paths` array are acutally used as both *namespace* and file paths. Relax though, both foreward and backward slashes are taken care of during generation.

你首先必须配置你的仓库文件的储存位置。默认情况下默认文件夹是‘app’，默认的命名空间是‘App’。
请注意：paths数组的值既作为文件路径，又作为命名空间路径。不过是放松的，不区分‘/’（正斜杠）和‘\’（反斜杠）

```php
    ...
    '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',
        ]
    ]

You may want to save the root of your project folder out of the app and add another namespace, for example

您可能希望将项目文件夹的根保存到app下，并添加另一个命名空间，例如

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

Additionally, you may wish to customize where your generated classes end up being saved. That can be accomplished by editing the paths node to your liking. For example:

另外：你可能希望自定义生成的类最终被保存的地方，可以自定义编辑路径完成。例如：

    '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',
        ]
    ]

Commands--命令

To generate everything you need for your Model, run this command:

生成你需要的一切模型，运行一下命令：

php artisan make:entity Post

This will create the Controller, the Validator, the Model, the Repository, the Presenter and the Transformer classes. It will also create a new service provider that will be used to bind the Eloquent Repository with its corresponding Repository Interface. To load it, just add this to your AppServiceProvider@register method:

这个命令将创建控制器（controller）、验证器（Validator）、模型（Model）、仓库（Repository）、呈现器（Presenter）和转换器（Transform）的类文件。它还将创建一个新的服务提供商，将用于绑定具有相应存储库接口的功能的存储库，加载它，添加到你的AppServiceProvider@register中：

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

You can also pass the options from the repository command, since this command is just a wrapper.

To generate a repository for your Post model, use the following command

您也可以通过存储库命令的选项，因为这个命令是一个包装器；你可以单独为你的模型生成一个仓库，使用下面的命令

php artisan make:repository Post

To generate a repository for your Post model with Blog namespace, use the following command

为你的文章添加Blog命名空间，使用一下命令

php artisan make:repository "Blog\Post"

Added fields that are fillable

创建时设置可填充字段

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

To add validations rules directly with your command you need to pass the --rules option and create migrations as well:

创建时设置可填充字段，迁移文件及验证规则：

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

The command will also create your basic RESTfull controller so just add this line into your routes.php file and you will have a basic CRUD:

在你的route.php文件中创建一个资源路由（含增删改查）

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

When running the command, you will be creating the "Entities" folder and "Repositories" inside the folder that you set as the default.

Done, done that just now you do bind its interface for your real repository, for example in your own Repositories Service Provider.

在运行命令时，你可以设置默认的Entities文件夹和Repositories里的文件夹。

这样做，只是现在你做的是为您的真正的存储库绑定它的接口，例如在您自己的存储库服务提供商。

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

And use

使用：

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

Alternatively, you could use the artisan command to do the binding for you.

或者你可以使用artisan命令进行绑定

php artisan make:bindings Cats

Use methods--使用方法

namespace App\Http\Controllers;

use App\PostRepository;

class PostsController extends BaseController {

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

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

    ....
}

Find all results in Repository

从仓库中获取全部数据

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

Find all results in Repository with pagination

从仓库中获取分页数据

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

Find by result by id

通过id获取结果集

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

Hiding attributes of the model

模型隐藏属性

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

Showing only specific attributes of the model

仅显示模型的特定属性

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

Loading the Model relationships

加载模型的关联关系

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

Find by result by field name

通过字段值匹配获取结果集

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

Find by result by multiple fields

根据多个字段值匹配获取结果集

$posts = $this->repository->findWhere([
    //Default Condition =
    'state_id'=>'10',
    'country_id'=>'15',
    //Custom Condition
    ['columnName','>','10']
]);

Find by result by multiple values in one field

根据字段值是否存在与多个value值中获取结果集（in--子查询）

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

Find by result by excluding multiple values in one field

根据字段值是否不存在与多个value值中获取结果集（NotIn--子查询）

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

Find all using custom scope

使用自定义查询范围获取全部数据

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

Create new entry in Repository

在仓库中创建新的记录

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

Update entry in Repository

在仓库中更新记录

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

Delete entry in Repository

在仓库中删除记录

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

Create a Criteria--创建一个标准（条件）

Using the command--使用命令

php artisan make:criteria My

Criteria are a way to change the repository of the query by applying specific conditions according to your needs. You can add multiple Criteria in your repository.

标准是一种通过根据你需要的应用特定条件来改变查询库的方法，你可以在你的仓库中添加多个标准

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;
    }
}

Using the Criteria in a Controller --在你的控制器中使用标准

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();
        ...
    }

}

Getting results from Criteria

根据标准获取结果集

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

Setting the default Criteria in Repository

在你的仓库中设置默认的标准（条件）类

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";
    }
}

Skip criteria defined in the repository --跳过仓库中定义的标准

Use skipCriteria before any other chaining method

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

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

Popping criteria --弹出标准

Use popCriteria to remove a criteria

使用popCriteria删除一个标准

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

Using the RequestCriteria --使用请求标准

RequestCriteria is a standard Criteria implementation. It enables filters to perform in the repository from parameters sent in the request.

You can perform a dynamic search, filter the data and customize the queries.

To use the Criteria in your repository, you can add a new criteria in the boot method of your repository, or directly use in your controller, in order to filter out only a few requests.

请求标准是一个标准的实现，它使用滤器在从请求发送的参数中执行。

你可以执行一个动态搜索，过滤数据和自定义查询。

要使用你仓库中的标准，你可以在你的仓库的boot方法中添加一个新的标准，或直接使用在你的控制器中，为了过滤掉少数的请求

Enabling in your Repository --在你的仓库中使用

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";
    }
}

Remember, you need to define which fields from the model can be searchable.

In your repository set $fieldSearchable with the name of the fields to be searchable or a relation to fields.

注意：你定义的字段在模型中可以搜索到。

在你的仓库中设置$fieldSearchable通过字段名或与字段的关系来进行搜索

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

You can set the type of condition which will be used to perform the query, the default condition is "="

你可以设置默认执行查询的条件类型，默认为"="

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

Enabling in your Controller --在你的控制器中使用

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

Example the Criteria --例如以下标准

Request all data without filter by request

请求所有的数据不需要过滤器

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"
    }
]

Conducting research in the repository

根据请求在仓库中进行搜索

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"
    }
]

Filtering fields

过滤字段

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

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

Sorting the results

结果集排序

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"
    }
]

Sorting through related tables

通过相关表进行排序

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

Query will have something like this

查询语句中将有：

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

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

Query will have something like this

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

Add relationship

添加关联关系

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

Overwrite params name --覆盖参数名称

You can change the name of the parameters in the configuration file config/repository.php

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

Cache --缓存

Add a layer of cache easily to your repository

轻松添加一层缓存到你的仓库中

Cache Usage --缓存的使用

Implements the interface CacheableInterface and use CacheableRepository Trait.

实现接口CacheableInterface和使用CacheableRepository Trait

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

class PostRepository extends BaseRepository implements CacheableInterface {

    use CacheableRepository;

    ...
}

Done , done that your repository will be cached , and the repository cache is cleared whenever an item is created, modified or deleted.

这样做，你的存储库将被缓存，当创建一条新纪录时，缓存将被清除（修改或删除）

Cache Config --缓存配置

You can change the cache settings in the file config/repository.php and also directly on your repository.

你还可以在 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
    //仓库缓存，实现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
    ],
],

It is possible to override these settings directly in the repository.

它是可以直接在仓库中覆盖这些设置的

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;

    ...
}

The cacheable methods are : all, paginate, find, findByField, findWhere, getByCriteria

缓存方法可选值：all, paginate, find, findByField, findWhere, getByCriteria

Validators --验证器

Requires prettus/laravel-validator. composer require prettus/laravel-validator

Easy validation with prettus/laravel-validator

轻松验证 prettus/laravel-validator

For more details click here

Using a Validator Class --使用验证器

Create a Validator --创建一个验证器

In the example below, we define some rules for both creation and edition

在下面的列子中，我们定义了一些创建和版本的规则

use \Prettus\Validator\LaravelValidator;

class PostValidator extends LaravelValidator {

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

}

To define specific rules, proceed as shown below:

定义特定的规则，如下：

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'
        ]
   ];

}

Enabling Validator in your Repository --在你的仓库中使用验证器

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";
    }
}

Defining rules in the repository --在仓库中定义验证规则

Alternatively, instead of using a class to define its validation rules, you can set your rules directly into the rules repository property, it will have the same effect as a Validation class.

另外：不是使用类来定义它的验证规则，您可以将您的规则设置到仓库属性中，它与验证类相同的结果

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";
    }

}

Validation is now ready. In case of a failure an exception will be given of the type: Prettus\Validator\Exceptions\ValidatorException

验证已经准备好了，在失败的情况下将抛出一个异常：Prettus\Validator\Exceptions\ValidatorException

Presenters --呈现器

Presenters function as a wrapper and renderer for objects.

呈现器作为一个对象包装和渲染

Fractal Presenter --分形呈现器

Requires Fractal. composer require league/fractal

There are two ways to implement the Presenter, the first is creating a TransformerAbstract and set it using your Presenter class as described in the Create a Transformer Class.

有两种方法来实现呈现器，首先是创建一个转换器并将它用你的呈现器中创建一个转换器类

The second way is to make your model implement the Transformable interface, and use the default Presenter ModelFractarPresenter, this will have the same effect.

第二种方法是使你的模型继承转换器接口（Transformable），使用默认的呈现器ModelFractarPresenter，两种方法产生的结果是相同的

Transformer Class --转换器类

Create a Transformer using the command --创建一个转换器使用一下命令

php artisan make:transformer Post

This wil generate the class beneath.

这将生成下面的类

Create a Transformer Class --创建转换器类

use League\Fractal\TransformerAbstract;

class PostTransformer extends TransformerAbstract
{
    public function transform(\Post $post)
    {
        return [
            'id'      => (int) $post->id,
            'title'   => $post->title,
            'content' => $post->content
        ];
    }
}

Create a Presenter using the command --创建一个呈现器使用以下命令

php artisan make:presenter Post

The command will prompt you for creating a Transformer too if you haven't already.

如果你还没有创建转换器，该命令会提示你安装一个转换器

Create a Presenter --创建一个呈现器

use Prettus\Repository\Presenter\FractalPresenter;

class PostPresenter extends FractalPresenter {

    /**
     * Prepare data to present
     *
     * @return \League\Fractal\TransformerAbstract
     */
    public function getTransformer()
    {
        return new PostTransformer();
    }
}

Enabling in your Repository --在你的仓库中使用

use Prettus\Repository\Eloquent\BaseRepository;

class PostRepository extends BaseRepository {

    ...

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

Or enable it in your controller with

或者在你的控制器中使用

$this->repository->setPresenter("App\\Presenter\\PostPresenter");

Using the presenter after from the Model --在模型后使用呈现器

If you recorded a presenter and sometime used the skipPresenter() method or simply you do not want your result is not changed automatically by the presenter.

如果你记录了一个呈现器有时用skippresenter()方法或者你不想你的结果是不是由呈现器自动改变

You can implement Presentable interface on your model so you will be able to present your model at any time. See below:

你可以在你的模型实现像样的界面让你可以在任何时候提出你的模型，如下：

In your model, implement the interface Prettus\Repository\Contracts\Presentable and Prettus\Repository\Traits\PresentableTrait

在你的模型中实现Prettus\Repository\Contracts\Presentable接口和使用Prettus\Repository\Traits\PresentableTrait Trait

namespace App;

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

class Post extends Eloquent implements Presentable {

    use PresentableTrait;

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

     ...
}

There, now you can submit your Model individually, See an example:

在这里，现在你可以单独提交你的模型，如下：

$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

//跳过呈现器，输出Model的原始结果集
$post = $repository->skipPresenter()->find(1);

print_r( $post ); //It produces an output as a Model object 它产生一个输出为Model对象
print_r( $post->presenter() ); //It produces an output as array 它产生一个输出为数组

You can skip the presenter at every visit and use it on demand directly into the model, for it set the $skipPresenterattribute to true in your repository:

您可以在每一次访问跳过呈现器，并使用它直接到模型的需求，在你的仓库中设置$skipPresenter属性为true

use Prettus\Repository\Eloquent\BaseRepository;

class PostRepository extends BaseRepository {

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

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

Model Class --模型类

Implement Interface --实现接口

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
         ];
     }
}

Enabling in your Repository --在你的仓库中使用

Prettus\Repository\Presenter\ModelFractalPresenter is a Presenter default for Models implementing Transformable

Prettus\Repository\Presenter\ModelFractalPresenter 是一个实现模型转换默认呈现器

use Prettus\Repository\Eloquent\BaseRepository;

class PostRepository extends BaseRepository {

    ...

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

Or enable it in your controller with

或在你的控制器中使用

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

Skip Presenter defined in the repository 在仓库中跳过呈现器定义

Use skipPresenter before any other chaining method

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

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

$this->repository->skipPresenter();

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

附上研究l5-repository资料：

(1)l5-repository实践记录

l5-repository的使用

目录

安装

Composer

Laravel

方法

Prettus\Repository\Contracts\RepositoryInterface

Prettus\Repository\Contracts\RepositoryCriteriaInterface

Prettus\Repository\Contracts\CacheableInterface

Prettus\Repository\Contracts\PresenterInterface

Prettus\Repository\Contracts\Presentable

Prettus\Repository\Contracts\CriteriaInterface

Prettus\Repository\Contracts\Transformable

用法

创建一个模型

创建一个仓库

Use methods--使用方法

Create a Criteria--创建一个标准（条件）

Using the Criteria in a Controller --在你的控制器中使用标准

Skip criteria defined in the repository --跳过仓库中定义的标准

Popping criteria --弹出标准

Using the RequestCriteria --使用请求标准

Cache --缓存

Validators --验证器

Presenters --呈现器

Skip Presenter defined in the repository 在仓库中跳过呈现器定义