RestApi plugin for Zend Framework 3
Requirements
This plugin has the following requirements:, (*1)
- Zend Framework 3 or greater.
- PHP 7 or greater.
Installation
You can install this plugin into your Zend Framework application using composer., (*2)
The recommended way to install composer packages is:, (*3)
composer require multidots/zf3-restapi
After installation, go to root path and open composer.json file and add following., (*4)
"autoload": {
"psr-4": {
....
// add following line.
"restapi\\": "vendor/restapi/src/"
}
},
Now Execute following command, (*5)
composer dump-autoload
Now copy this file "vender/restapi/config/restapi.global.php" and paste to root "config/autoload/restapi.global.php", (*6)
Now add this 'restapi' to modules.config.php file., (*7)
return [
....
//add this
'restapi'
];
Usage
You just need to create your API related controller and extend it to ApiController instead of default AbstractActionController. You just need to set you results in apiResponse variable and your response code in httpStatusCode variable and return $this->createResponse(). For example,, (*8)
namespace Application\Controller;
use restapi\Controller\ApiController;
/**
* Foo Controller
*/
class FooController extends ApiController
{
/**
* bar method
*
*/
public function barAction()
{
// your action logic
// Set the HTTP status code. By default, it is set to 200
$this->httpStatusCode = 200;
// Set the response
$this->apiResponse['you_response'] = 'your response data';
return $this->createResponse();
}
}
You can define your logic in your action function as per your need. For above example, you will get following response in json format,, (*9)
{"status":"OK","result":{"you_response":"your response data"}}
The URL for above example will be http://yourdomain.com/foo/bar. You can customize it by setting the your module.config.php as following`., (*10)
'router' => [
'routes' => [
'home' => [
'type' => Literal::class,
'options' => [
'route' => '/',
'defaults' => [
'controller' => Controller\FooController::class,
'action' => 'bar',
'isAuthorizationRequired' => true // set true if this api Required JWT Authorization.
],
],
],
],
],
Simple :), (*11)
Configurations
This plugin provides several configuration related to Response, Request and JWT authentication. The default configurations are in previously you copy and past file this restapi.global.php have configurations`., (*12)
<?php
return [
'ApiRequest' => [
'responseFormat' => [
'statusKey' => 'status',
'statusOkText' => 'OK',
'statusNokText' => 'NOK',
'resultKey' => 'result',
'messageKey' => 'message',
'defaultMessageText' => 'Empty response!',
'errorKey' => 'error',
'defaultErrorText' => 'Unknown request!',
'authenticationRequireText' => 'Authentication Required.',
'pageNotFoundKey' => 'Request Not Found.',
],
'jwtAuth' => [
'cypherKey' => 'R1a#2%dY2fX@3g8r5&s4Kf6*sd(5dHs!5gD4s',
'tokenAlgorithm' => 'HS256'
],
]
];
Request authentication using JWT
You can check for presence of auth token in API request. You need to define a flag isAuthorizationRequired to true or false. For example,, (*13)
'router' => [
'routes' => [
'home' => [
'type' => Literal::class,
'options' => [
'route' => '/',
'defaults' => [
'controller' => Controller\FooController::class,
'action' => 'bar',
'isAuthorizationRequired' => true // set true if this api Required JWT Authorization.
],
],
],
],
],
```
Above API method will require auth token in request. You can pass the auth token in either header, in GET parameter or in POST field., (*14)
If you want to pass token in header, use below format., (*15)
Authorization: Bearer [token]
Example:
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJkYXRhIjoidmFsdWUifQ.xQgVrW5o3iNzA4iY3NDKwDp-pYoIhr-vyFgmi9RuMFo
In case of GET or POST parameter, pass the token in token parameter., (*16)
Generate jwt token
This plugin provides methos to generate jwt token and sign with same key and algorithm. Use $this->generate() method wherever required. Most probably, you will need this in user login and register API. See below example,, (*17)
public function login()
{
/**
* process your data and validate it against database table
*/
// generate token if valid user
// $this->tokenPayload you can access user details.
$this->tokenPayload = ['email' => $user->email, 'name' => $user->name];
$this->generateToken();
// $this->token through you can get token.
$this->apiResponse['token'] = $this->token;
$this->apiResponse['message'] = 'Logged in successfully.';
return $this->createResponse();
}
The default response format of API is json and its structure is defined as below., (*18)
{
"status": "OK",
"result": {
//your result data
}
}
Examples
Below one examples to understand how this plugin works., (*19)
Retrieve articles
Let's create an API which returns a list of articles with basic details like id and title. Our controller will look like,, (*20)
<?php
namespace Application\Controller;
use restapi\Controller\ApiController;
/**
* Articles Controller
*
*
*/
class ArticlesController extends ApiController
{
/**
* index method
*
*/
public function indexAction()
{
$articles = $this->entityManager->getRepository(Article::class)
->findBy([], ['id'=>'ASC']);
$this->apiResponse['articles'] = $articles;
}
}
The response of above API call will look like,, (*21)
{
"status": "OK",
"result": {
"articles": [
{
"id": 1,
"title": "Lorem ipsum"
},
{
"id": 2,
"title": "Donec hendrerit"
}
]
}
}
Reporting Issues
If you have a problem with this plugin or any bug, please open an issue on GitHub., (*22)
Wallogit.com
