Como Usar los Modelos en KumbiaPHP

Introducción

Los Modelos representan la lógica de la aplicación y son parte fundamental para el momento que se desarrolla una aplicación, un buen uso de estos nos permiten un gran poder al momento que se necesita escalar, mantener y rehusar código en una aplicación.

Por lo general un mal uso de los modelos es solo dejar el archivo con la declaración de la clase y toda la lógica se genera en el controlador. Esta práctica trae como consecuencia que en primer lugar el controlador sea entendible por alguien que intente agregar y/o modificar algo en esa funcionalidad, en segundo lugar lo poco que puedes rehusar el código en otros controladores y lo hace es repetirse el código que hace lo mismo en otro controlador.

Partiendo de este principio los controladores NO deberían contener ningún tipo de lógica solo se encargan de atender las peticiones del usuarios y solicitar dicha información a los modelos con esto garantizamos un buen uso del MVC.

El Modelo extiende el ActiveRecord

KumbiaPHP usa POO (Programación orientada a objetos), así que ActiveRecord es una clase que ya lleva métodos listos para usar. Que facilitan al usuario el manejo de las tablas de las bases de datos, métodos como: find, find_all, save, update,...

El Modelo extiende la clase ActiveRecord para que el usuario pueda añadir sus métodos, y asi encapsular la lógica.

Un Buen Modelo

A continuación una muestra de un buen modelo en KumbiaPHP

<?php

class Articulos extends ActiveRecord {
	
	public function ver($page=1,$ppage=10){
		
		return $this->paginate('order: creat_at desc',
					"page: $page",
					"per_page: $ppage");	
	}
	
	public function ultimos($limit=10) {
		$today = date('now');
		return $this->find('order: creat_at desc',
				   "conditions: data <= $today",
				   "limit: $limit");
		
	}
	
	public function buscar($busqueda){
		$busqueda = filter_var($busqueda, FILTER_SANITIZE_STRING);
		return $this->find_all_by_sql("SELECT * FROM copa.articulos a WHERE MATCH (titulo,texto) 
                                               AGAINST('\"$busqueda\"' IN BOOLEAN MODE) ORDER BY creat_at DESC");
		
	}
}

Normalmente este código muchos usuarios lo colocan en el controller quedando el mismo ilegible, colocandolo como se muestra arriba queda muy limpia la implementación de los mismo en nuestros modelos en los controller.

Implementando mis modelos en los controladores

A continuación se muestra un controller donde se puede apreciar lo legible que queda nuestro controller si delegamos las funciones que corresponden a sus responsables dentro del Patrón MVC que promueve KumbiaPHP.

<?php
class MiController extends ApplicationController
{
    public function index ($id = 1)
    {
        $this->noticias = $this->Articulos->ver($id);
    }
    public function ver ($slug)
    {
        if ($slug) {
            $this->noticia = $this->Articulos->buscar($slug);
        }
    }
    public function rss ()
    {
        $this->noticias = $this->Articulos->ultimos();
        $this->set_response("view");
    }
}

Lo que mencionamos arriba sobre la re-utilización de código y característica fundamental de la POO, si vemos el método ultimos() del modelo Articulos nos sirve para crear un RSS, un Partial (widget) con los artículos recientes, etc. es decir donde necesitemos los últimos artículos.