ActiveRecord for API
Clone or download
Latest commit 1f887c5 Jul 5, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs/readme minor Apr 15, 2017
src Query from accepte Array Jul 5, 2018
tests csfixed Jun 27, 2018
.gitignore minor Jun 27, 2018
.php_cs csfixed Jan 28, 2018
.scrutinizer.yml minor Jun 27, 2018
.travis.yml csfixed Jan 28, 2018
CHANGELOG.md version bump to 0.3.0 Jun 27, 2018
LICENSE
README.md csfixed Jan 28, 2018
chkipper.json version bump to 0.1.0 Jan 25, 2017
composer.json simplified config May 22, 2017
hidev.yml renamed `hidev.yml` May 22, 2017
history.md version bump to 0.3.0 Jun 27, 2018
phpunit.xml.dist added functional test for simple config (no DI) Feb 8, 2017
version version bump to 0.3.0 Jun 27, 2018

README.md

HiArt

ActiveRecord for API

Latest Stable Version Total Downloads Build Status Scrutinizer Code Coverage Scrutinizer Code Quality Dependency Status

This Yii2 extension provides ActiveRecord implementation that allows to access remote/web API same way as you do with normal Yii2 DB ActiveRecord.

Installation

The preferred way to install this yii2-extension is through composer.

composer require "hiqdev/yii2-hiart"

But if you prefer Guzzle transport use yii2-hiart-guzzle package:

composer require "hiqdev/yii2-hiart-guzzle"

Configuration

To use this extension, configure hiart component in your application config:

    'components' => [
        'hiart' => [
            'class' => \hiqdev\hiart\rest\Connection::class,
            'requestClass' => \hiqdev\hiart\auto\Request::class,
            'baseUri' => 'https://site.com/api/v3/',
        ],
    ],

Note three main options:

  • class specifies class that actually implements API to be accessed, REST in this case
  • requestClass specifies transport implementation to be used, auto in this case
  • baseUri specifies starting point of the API

Transports

Available transports are:

You can implement your own transport. All you need is to create two classes: Request and Response, it's not difficult see available implementations. Transport can be even non-HTTP based.

Query builders

QueryBuilder is what actually implements an API.

We are developing QueryBuilders for:

You can implement your own API. Basically all you need is create your QueryBuilder class with these methods:

  • buildMethod(Query $query)
  • buildHeaders(Query $query)
  • buildUri(Query $query)
  • buildQueryParams(Query $query)
  • buildBody(Query $query)
  • buildFormParams(Query $query)

See available implementations and ask questions using issues on GitHub.

Usage

Define your Model:

class User extends \hiqdev\hiart\ActiveRecord
{
    public function rules()
    {
        return [
            ['id', 'integer', 'min' => 1],
            ['login', 'string', 'min' => 2, 'max' => 32],
        ];
    }
}

Note that you use general hiqdev\hiart\ActiveRecord class not specific for certain API. API is specified in connection options and you don't need to change model classes when you change API.

Then you just use your models same way as DB ActiveRecord models.

$user = new User();
$user->login = 'sol';

$user->save();

$admins = User::find()->where(['type' => User::ADMIN_TYPE])->all();

Basically all the features of Yii2 ActiveRecord work if your API provides them.

License

This project is released under the terms of the BSD-3-Clause license. Read more here.

Copyright © 2015-2018, HiQDev (http://hiqdev.com/)

Acknowledgments