Cómo crear un api RESTful con slim php – introducción

Kelvi S. Padilla — Thu, 24 Jul 2014 04:28:53 +0000

Últimamente se ha vuelto popular consumir servicios web a través de RESTful, según Wikipedia el término se refiere a “una técnica de arquitectura software para sistemas hipermedia distribuidos como la World Wide Web” pero comúnmente se utiliza para interfaces web a través de xml, json y http.

las ventajas de utilizar un servicio RESTful es que podemos utilizar un formato ligero de objetos Javascript llamado JSON, el cual nos permite tener diferentes aplicaciones en distintos lenguajes que pueden interactuar entre sí, gracias a la flexibilidad del protocolo, y con el aumento de aplicaciones móviles es común que las bases de datos y en algunos casos la capacidad de procesamiento la realiza un servidor en la nube y no el teléfono, un ejemplo podría ser el de crear una aplicación en Android para un blog en WordPress, si queremos mostrar una lista de nuestros últimos artículos de manera personalizada, lo ideal sería recoger los datos del servidor y mostrarlos en una lista o en secciones, incluso el plugin jetpack permite el acceso de tu blog a través de su api json sin crearla nosotros lo que lo hace aún mas fácil, mas adelante haré un tutorial de como hacerlo pero por ahora supongamos que no tenemos la api y tenemos que hacerla de forma manual.

Se puede crear un api RESTful en varios lenguajes, en Ruby, PHP o Java por ejemplo, lo que nos da más opciones para escoger, en este caso por flexibilidad y facilidad de uso utilizaremos php y el micro framework slim el cual nos agiliza el tiempo de desarrollo y entre sus ventajas podemos mencionar:

Manejo de métodos HTTP estándar y personalizados
Configuración sencilla
Manejo de rutas
Manejo de plantillas para vistas
Es software libre.

Métodos HTTP utilizados en RESTful

HTTP es un protocolo de transferencias usado en Internet, la mayoría de navegadores sólo utilizan los métodos GET y POST para realizar transferencias dejando de lado los otros métodos (para ver todos lo métodos y su explicación da click aqui ). CRUD es el acrónimo utilizado para referirse a las funciones de Crear, Obtener, Actualizar y Borrar (Create, Read, Update, Delete en inglés), es lo que básicamente haremos con slim utilizando los métodos http para hacerlo, la función de cada método es la siguiente:

GET: utilizado para obtener información (visibles en la url en el navegador).
POST: utilizado para insertar información.
PUT: utilizado para para actualizar datos.
DELETE: utilizado para eliminar datos.

Existen otros métodos en el protocolo http que no usaremos aquí y cabe mencionar que esta es la utilización conocida como RESTful.

Instalación de slim

Primero debes descargar el código, existen dos formas y la más recomendada es por medio de composer lo único que necesitas para hacerlo es agregar en el archivo composer.json.

{
"require": {
"slim/slim": "2.*"
}
}

y ejecutamos php composer.phar install desde la consola (también agregare a la lista un tutorial de composer), y la segunda opción es de manera manual que simplemente bajas la última versión del código que puedes descargar aquí, una vez descargado el código, dentro de la carpeta creas un archivo llamado index.php en el caso de haber hecho la descarga a través de composer agrega el siguiente código:

require 'vendor/autoload.php';

si lo descargaste manual solo necesitas incluir la carpeta slim y en el archivo index.php agregamos el siguiente código:

require 'Slim/Slim.php';
\Slim\Slim::registerAutoloader();

Para iniciar la clase utilizamos lo siguiente:

$app = new \Slim\Slim();

y de esta manera ya tenemos todo listo para comenzar a agregar nuestras funciones, como prueba de que todo esta funcionando podemos agregar el siguiente ejemplo:

require 'Slim/Slim.php';
\Slim\Slim::registerAutoloader();
// GET route
$app->get(
    '/',
    function () {
        $template = <<
    
        
            
            Test de funcionamiento
        
        
            Slim funciona perfectamente
        
    
EOT;
        echo $template;
    }
);
$app->run();

Si vemos en pantalla el mensaje “Slim funciona perfectamente” es porque todo esta funcionado bien. Para no hacer mas largo el tutorial dejaré hasta aquí este primer artículo, en la próxima entrada hablaré sobre las rutas y conexión a mysql, lo cual nos será de utilidad en muchas formas, si te gusto el articulo no olvides en comentar.

La entrada Cómo crear un api RESTful con slim php – introducción aparece primero en Cronicas de un geek.

Cronicas de un geek » web service

Cómo crear un api RESTful con slim php – introducción

Métodos HTTP utilizados en RESTful

Instalación de slim

Slim funciona perfectamente