We shall skip the database connection and we shall use a static array for the data. This is the PHP code:

File: app/controllers/framework_controller.php

<?php

class FrameworkController extends RestController {

    protected $fw = array(1 => array(
            "name" => "KumbiaPHP",
            "description" => "The best PHP framework on the world"
        ),
        array(
            "name" => "Laravel",
            "description" => "The new boy in the neighbourhood"
        ),
        array(
            "name" => "Symfony",
            "description" => "The old veteran man"
        ),
    );

    public function get($id) {
        if (isset($this->fw[$id])) {
            $this->data = $this->fw[$id];
        } else {
            $this->error('This framework doesn\'t exist', 404);
        }
    }

    public function getAll() {
        $this->data = $this->fw;
    }

}

We created a new controller called Framework controller with two actions: getAll for getting all frameworks, and get for getting a framework by id. But this controller is still accessible for all users.  Now, we shall open the rest_controller.php file located in the directory default\app\libs. Add the user’s data for the authentication in an array and add the  validation in the initialize method.

<?php

require_once CORE_PATH . 'kumbia/kumbia_rest.php';

class RestController extends KumbiaRest {

    protected $users = array(
        'alberto' => '123456',
        'ashrey' => '0000'
    );

    final protected function initialize() {
        $user = isset($_SERVER['PHP_AUTH_USER']) ? filter_var($_SERVER['PHP_AUTH_USER']) : null;
        $pass = isset($_SERVER['PHP_AUTH_PW']) ? filter_var($_SERVER['PHP_AUTH_PW']) : null;
        if (isset($this->users[$user]) && ($this->users[$user] == $pass)) {
            return true;
        } else {
            $this->data = $this->error("Fail authentication", 401);
            header('WWW-Authenticate: Basic realm="Private Area"');
            return false;
        }
    }

    final protected function finalize() {
        
    }

}

Now, you need to send a valid user and password for access to the results. You can use a tool like Postman or HttpRequester for to test, or your browser. Using Firefox, you will look a dialogue like:

If you type a correct user and password you can see a page like:

else you will see a page like:

La entrada How to create a REST Service with Basic Auth in KumbiaPHP se publicó primero en KumbiaPHP Framework PHP en español.

Ahora veremos cómo empezar!!

Crearemos un controlador como siempre lo hemos realizado con la diferencia que ahora lo vamos a extender de RestController

En el código anterior he creado un controlador llamado services, el cual al momento de recibir una petición GET invocara a la acción get, Por default cada acción se llama como el método usado por el cliente  como pueden ser  GET, POST, PUT, DELETE, OPTIONS, y demás.

Por lo cual en un controlador REST podríamos tener al menos 4 acciones

Public function get($id){}

Public function post($id){}

Public function put($id){}

Public function delete($id){}

Pero muchas veces necesitamos algo más que eso, para ello podemos hacer uso de la convención de nombre para servicios rest de KumbiaPHP el cual es:

get_nombre_accion()

post_nombre_acccion()

Por ejemplo en la clase servicio tendré un método para buscar un artículo, mi método se llama buscarArt y cómo va atender las peticiones get pasara a llamarse get_buscarArt($id) quedando de la siguiente manera:

Como se puede observar el formato de salida es Json, en la siguiente imagen vemos los datos devuelto por la aplicación.

POST

Ahora mi aplicación en el lado del cliente enviara al servidor la información para guardar la nota venta, dicha petición será mediante post.

En este caso como no especifico la acción a guardar KumbiaPHP por default  buscara y ejecutara la acción post.

Ahora para recibir la información que estoy enviando desde el cliente, simplemente invocamos al método $this->param(); el cual contendrá los datos enviados.

Como observamos empiezo por recorrer los artículos enviados en el carrito y posteriormente los datos de la venta.

Al final le regresare prácticamente la misma información al cliente, pero si observamos ahora el id tiene ya un valor, lo que el cliente interpretara que la inserción fue correcta.

Para regresar lo anterior de la imagen: en cada iteración del carrito y conforme guardaba un artículo en base de datos, también lo almacenaba en un array, para los primeros tres datos solo se sobrescribían (esto se puede optimizar)

La entrada Servicios REST con KumbiaPHP se publicó primero en KumbiaPHP Framework PHP en español.