Nel
post precedente ho mostrato come creare un semplice sistema
API con il solo metodo GET. Ma se volessimo un server API che risponda
secondo lo standard
RESTful, dovremmo gestire anche i metodi POST, PUT
e DELETE.
In particolare, lo standard consiglia di utilizzare:
- GET per richieste di lettura di una risorsa
- POST per richieste di creazione di una risorsa
- PUT per richieste di modi ca di una risorsa
- DELETE per richieste di eliminazione di una risorsa
Per fare questo velocemente e possibile appoggiarsi ad una libreria di
terze parti,
codeigniter-restserver.
Installazione
Il primo passo è ovviamente scaricare il pacchetto dalla pagina github della libreria. Il pacchetto includerebbe anche CodeIgniter, ma è molto probabile che si voglia integrare
restserver in un progetto codeigniter gi à esistente. In questo caso è su fficiente copiare i files
application/libraries/Format.php
application/libraries/REST_Controller.php
application/config/rest.php
nella propria directory application, e ricordarsi di caricare automaticamente la classe
REST_Controller come libreria nel fi le di con gurazione
application/config/autoload.php
Per personalizzare le opzioni di restserver, basta modi care l'apposito fi le precedentemente copiato:
application/config/rest.php
Funzionamento di base
Per il buon funzionamento del sistema è necessario creare controller che estendono la classe base
REST_Controller. La libreria elabora le richieste sulla base del metodo HTTP utilizzato e della risorsa (controller), eseguendo la funzione corrispondente all'insieme dei due elementi, sempre seguendo la logica CodeIgniter. Per spiegarmi meglio, ipotizziamo di avere il seguente controller:
class News extends REST_Controller
{
public function index_get()
{
// Lettura delle news
}
public function index_post()
{
// Crea una news
}
public function index_put()
{
// Modifica una news
}
public function index_delete()
{
// Elimina una news
}
}
Una richiesta del tipo
GET http://www.example.com/news
comporterà l'esecuzione della funzione
index_get,
index perché l'url è senza una funzione specificata (news è direttamente il controller) e
get perché il metodo HTTP utilizzato è, appunto, GET.
L'accesso ai parametri è garantito dalle funzioni get, post e put.
$this->get('id'); //mappatura di $this->input->get()
$this->post('id'); //mappatura di $this->input->post()
$this->put('id');
Per i parametri del metodo DELETE, poiché lo standard non li prevede, è sufficiente gestirli direttamente dalla funzione richiamata dal controllore:
public function index_delete($id)
{
$this->response(array(
'returned from delete:' => $id,
));
}
E' possibile inviare in output una struttura dati con la funzione
response, gestendo anche la risposta HTTP direttamente (opzionale).
In questo modo la libreria si preoccuperà di formattare la risposta a seconda dello standard impostato nella configurazione (io consiglio JSON).
Inoltre, gestendo le risposte HTTP, è possibile utilizzare codici appropriati come il 201 per
HTTP 201 Created
e 404 per
HTTP 404 Not Found (in quest'ultimo caso il primo parametro sarà una risorsa vuota, come ad esempio un array senza elementi).
public function index_post()
{
// ...crea una news
$this->response($news, 201); // Manda la risposta HTTP 201
}
Queste sono i tips principali per lo sviluppo di un sistema API con codeigniter-restserver. Non ho parlato per motivi di tempo delle altre caratteristiche della libreria, quali la gestione di API Keys, la gestione dell'autenticazione ecc. per le quali rimando direttamente al
sito ufficiale.
