Download the PHP package simialbi/yii2-rest-client without Composer
On this page you can find all versions of the php package simialbi/yii2-rest-client. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package yii2-rest-client
REST Client for Yii 2 (ActiveRecord-like model)
This extension provides an interface to work with RESTful API via ActiveRecord-like model in Yii 2. It is based on ApexWire's yii2-restclient.
Resources
Installation
The preferred way to install this extension is through composer.
Either run
or add
to the require
section of your composer.json
.
Configuration
To use this extension, configure restclient component in your application config:
Parameter | Default | Description |
---|---|---|
baseUrl |
'' |
The location of the api. E.g. for http://api.site.com/v1/users the baseUrl would be http://api.site.com/v1/ (required) |
auth |
Either a Closure which returns a string or a string . The rest connection will be passed as parameter. |
|
usePluralisation |
true |
Whether to use plural version for lists (index action) or not (e.g. http://api.site.com/users instead of user ) |
useFilterKeyword |
true |
Whether to use "filter" key word in url parameters when filtering (e.g. ?filter[name]=user instead of ?name=user |
enableExceptions |
false |
Whether the connection should throw an exception if response is not 200 or not |
itemsProperty |
If your items are wrapped inside a property (e.g. items ), set it's name here |
|
requestConfig |
[] |
Client request configuration |
responseConfig |
[] |
Client response configuration |
updateMethod |
'put' |
The method to use for update operations. |
isTestMode |
false |
Whether we are in test mode or not (prevent execution) |
enableQueryCache |
false |
Whether to enable query caching |
queryCacheDuration |
3600 |
The default number of seconds that query results can remain valid in cache |
queryCache |
'cache' |
The cache object or the ID of the cache application component |
Usage
Define your Model
It's important that you define the primary key by overriding primaryKey()
method. Otherwise you'll get an exception.
If you do not override the modelName()
method, it will guess it by class name (MyModel becomes my-model). It's used
to generate the URL together with simialbi\yii2\rest\Connection::$baseUrl
.
The usage how to define the active record (rules, behaviors etc.) is the same like yii\db\ActiveRecord.
Important: Be sure to either define the properties of the object like in the example above (
@property
syntax in phpdoc) or override theattributes()
method to return the allowed attributes as arrayThe same about relations. Be sure to either define them via
@property-read
phpdoc comment or override thegetRelations
method. If the related class has not the same namespace as the main class, be sure to use the fully qualified class name (e.g.@property-read \app\models\OtherModel[] $otherModels
)
License
yii2-rest-client is released under MIT license. See bundled LICENSE for details.