README

Laravel Repositories是一个用于Laravel 5的包，它用于抽象数据库层。这使得应用程序的维护变得更加容易。

安装

在终端中运行以下命令

composer require "bosnadev/repositories: 0.*"

或者将此添加到composer.json文件的require部分

"bosnadev/repositories": "0.*"

然后运行composer update

使用方法

首先，创建你的仓库类。请注意，你的仓库类必须扩展Bosnadev\Repositories\Eloquent\Repository并实现model()方法

<?php namespace App\Repositories;

use Bosnadev\Repositories\Contracts\RepositoryInterface;
use Bosnadev\Repositories\Eloquent\Repository;

class FilmsRepository extends Repository {

    public function model() {
        return 'App\Film';
    }
}

通过实现model()方法，你告诉仓库你想要使用哪个模型类。现在，创建App\Film模型

<?php namespace App;

use Illuminate\Database\Eloquent\Model;

class Film extends Model {

    protected $primaryKey = 'film_id';

    protected $table = 'film';

    protected $casts = [
        "rental_rate"       => 'float'
    ];
}

最后，在控制器中使用仓库

<?php namespace App\Http\Controllers;

use App\Repositories\FilmsRepository as Film;

class FilmsController extends Controller {

    private $film;

    public function __construct(Film $film) {

        $this->film = $film;
    }

    public function index() {
        return \Response::json($this->film->all());
    }
}

可用方法

以下方法可用

Bosnadev\Repositories\Contracts\RepositoryInterface

public function all($columns = array('*'))
public function lists($value, $key = null)
public function paginate($perPage = 1, $columns = array('*'));
public function create(array $data)
// if you use mongodb then you'll need to specify primary key $attribute
public function update(array $data, $id, $attribute = "id")
public function delete($id)
public function find($id, $columns = array('*'))
public function findBy($field, $value, $columns = array('*'))
public function findAllBy($field, $value, $columns = array('*'))
public function findWhere($where, $columns = array('*'))

Bosnadev\Repositories\Contracts\CriteriaInterface

public function apply($model, Repository $repository)

示例使用

在仓库中创建新电影

$this->film->create(Input::all());

更新现有电影

$this->film->update(Input::all(), $film_id);

删除电影

$this->film->delete($id);

按film_id查找电影；

$this->film->find($id);

你也可以选择要获取哪些列

$this->film->find($id, ['title', 'description', 'release_date']);

通过单个列标准获取单行。

$this->film->findBy('title', $title);

或者你可以通过单个列标准获取所有行。

$this->film->findAllBy('author_id', $author_id);

通过多个字段获取所有结果

$this->film->findWhere([
    'author_id' => $author_id,
    ['year','>',$year]
]);

标准

标准是一种简单的方式来应用特定的条件或条件集到仓库查询。你的标准类必须扩展抽象类Bosnadev\Repositories\Criteria\Criteria。

这是一个简单的标准

<?php namespace App\Repositories\Criteria\Films;

use Bosnadev\Repositories\Criteria\Criteria;
use Bosnadev\Repositories\Contracts\RepositoryInterface as Repository;

class LengthOverTwoHours extends Criteria {

    /**
     * @param $model
     * @param RepositoryInterface $repository
     * @return mixed
     */
    public function apply($model, Repository $repository)
    {
        $model = $model->where('length', '>', 120);
        return $model;
    }
}

现在，在控制器类中调用pushCriteria方法

<?php namespace App\Http\Controllers;

use App\Repositories\Criteria\Films\LengthOverTwoHours;
use App\Repositories\FilmsRepository as Film;

class FilmsController extends Controller {

    /**
     * @var Film
     */
    private $film;

    public function __construct(Film $film) {

        $this->film = $film;
    }

    public function index() {
        $this->film->pushCriteria(new LengthOverTwoHours());
        return \Response::json($this->film->all());
    }
}

鸣谢

这个包在很大程度上受到了这个出色包的启发，作者是@andersao。这里是另一个我用作参考的包。