You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
CodeIgniter Rest Server is available on Packagist (using semantic versioning), and installation via composer is the recommended way to install Codeigniter Rest Server. Just add this line to your composer.json file:
Note that you will need to copy rest.php to your config directory (e.g. application/config)
Step 1: Add this to your controller (should be before any of your code)
usechriskacerguis\RestServer\RestController;
Step 2: Extend your controller
class Example extends RestController
Basic GET example
Here is a basic example. This controller, which should be saved as Api.php, can be called in two ways:
https://domain/api/users/ will return the list of all users
https://domain/api/users/id/1 will only return information about the user with id = 1
<?phpdefined('BASEPATH') ORexit('No direct script access allowed');
usechriskacerguis\RestServer\RestController;
class Api extends RestController {
function__construct()
{
// Construct the parent classparent::__construct();
}
publicfunctionusers_get()
{
// Users from a data store e.g. database$users = [
['id' => 0, 'name' => 'John', 'email' => 'john@example.com'],
['id' => 1, 'name' => 'Jim', 'email' => 'jim@example.com'],
];
$id = $this->get( 'id' );
if ( $id === null )
{
// Check if the users data store contains usersif ( $users )
{
// Set the response and exit$this->response( $users, 200 );
}
else
{
// Set the response and exit$this->response( [
'status' => false,
'message' => 'No users were found'
], 404 );
}
}
else
{
if ( array_key_exists( $id, $users ) )
{
$this->response( $users[$id], 200 );
}
else
{
$this->response( [
'status' => false,
'message' => 'No such user found'
], 404 );
}
}
}
}
Extending supported formats
If you need to be able to support more formats for replies, you can extend the
Format class to add the required to_... methods
Extend the RestController class (in libraries/MY_REST_Controller.php)
<?phpusechriskacerguis\RestServer\RestController;
class MY_REST_Controller extends RestController
{
publicfunction__construct()
{
parent::__construct();
// This can be the library's chriskacerguis\RestServer\Format// or your own custom overloaded Format class (see bellow)$this->format = newFormat();
}
}
Extend the Format class (can be created as a CodeIgniter library in libraries/Format.php).
Following is an example to add support for PDF output
<?phpusechriskacerguis\RestServer\FormatasRestServerFormat;
class Format extends RestServerFormat
{
publicfunctionto_pdf($data = null)
{
if ($data === null && func_num_args() === 0) {
$data = $this->_data;
}
if (is_array($data) || substr($data, 0, 4) != '%PDF') {
$html = $this->to_html($data);
// Use your PDF lib of choice. For example mpdf$mpdf = new \Mpdf\Mpdf();
$mpdf->WriteHTML($html);
return$mpdf->Output('', 'S');
}
return$data;
}
}
About
A fully RESTful server implementation for CodeIgniter using one library, one config file and one controller.