CodeIgniter RESTful API

CodeIgniter 3 RESTful API Resource Base Controller

This RESTful API extension is collected into nueip/codeigniter-pack which is a complete solution for Codeigniter framework.

Features

• PSR-7 standardization

• RESTful API implementation

• Laravel Resource Controllers pattern like

OUTLINE

• Demonstration
  • RESTful Create Callback
  • Packed Standard Format
• Requirements
• Installation
• Configuration
  • Routes Setting
• Resource Controllers
  • Build Methods
  • Custom Routes & Methods
  • Behaviors
  • Usage
• HTTP Request
  • Usage
• HTTP Response
  • Usage
• Reference

DEMONSTRATION

Output with status 200 OK:

RESTful Create Callback

Output with status 201 Created:

Packed Standard Format

Output with status 403 Forbidden:

REQUIREMENTS

This library requires the following:

• PHP 5.4.0+
• CodeIgniter 3.0.0+

INSTALLATION

Run Composer in your Codeigniter project under the folder \application:

composer require nueip/codeigniter-rest

Check Codeigniter application/config/config.php:

You could customize the vendor path into $config['composer_autoload']

CONFIGURATION

1. Create a controller to extend nueip\rest\Controller,

2. Add and implement action methods referring by Build Methods.

Then you could access RESTful API:

You could also use /ajax instead of /api if you like:

resource is Controller name, if you don't want to have /api or /ajax in URI you could set Routes Setting as below.

Routes Setting

If you want to have a standard RESTful URI pattern that controller defines as a URI resource, for example:

You could add a pair of routes for this controller into \application\config\routes.php to enable RESTful API url:

RESOURCE CONTROLLERS

The base RESTful API controller is nueip\rest\Controller, the following table is the actions handled by resource controller, the action refers to CI_Controller's action name which you could override:

Without Routes Setting, the URI is like /photos/api & /photos/api/{photo}.

Build Methods:

You could make a resource controller by referring the Template of Resource Controller.

The following RESTful controller methods could be add by your need. which each method refers to the action of Resource Controller table by default, and injects required arguments:

$resourceID (string) is the addressed identity of the resource from request

$requestData (array) is the array input data parsed from request raw body, which supports data format of common content types. (Alternatively, use this->request->getRawBody() to get raw data)

Custom Routes & Methods

The default routes for mapping the same action methods of Resource Controller are below:

You could override it to define your own routes while creating a resource controller:

After reseting routes, each RESTful method (key) would enter into specified controller action (value). For above example, while access /resources/api/ url with GET method would enter into find() action. However, the default route would enter into index() action.

The keys refer to the actions of Resource Controller table, you must define all methods you need.

Behaviors

Resource Controller supports behaviors setting for each action, you could implement such as authentication for different permissions.

_setBehavior()

Set behavior to a action before route

Example:

Usage

pack()

Pack array data into body format

You could override this method for your application standard.

`

Example:

JSON Result:

HTTP REQUEST

The PSR-7 request component nueip\http\request is preloaded into nueip\rest\Controller, which provides input handler and HTTP Authentication. You could call it by $this->request in controller class.

Usage

getRawBody()

Returns the raw HTTP request body

Example:

getAuthCredentialsWithBasic()

Get Credentials with HTTP Basic Authentication

Example:

getAuthCredentialsWithBearer()

Get Credentials with OAuth 2.0 Authorization Framework: Bearer Token Usage

Example:

HTTP RESPONSE

The PSR-7 response component nueip\http\response is preloaded into nueip\rest\Controller, which provides output handler and formatter. You could call it by $this->response in controller class.

Usage

json()

JSON output shortcut

Example:

setFormat()

Set Response Format into CI_Output

Example:

setData()

Set Response Data into CI_Output

Example:

send()

Sends the response to the client.

Example:

withAddedHeader()

Return an instance with the specified header appended with the given value.

Example:

REFERENCE

• HTTP authentication by MDN

• RFC7617 - The 'Basic' HTTP Authentication Scheme

• RFC6750 - The OAuth 2.0 Authorization Framework: Bearer Token Usage

• REST Relationship between URL and HTTP methods

• PSR-7: HTTP message interfaces