Como hacer un CRUD en KumbiaPHP Framework

De KumbiaPHP Framework Wiki

Este manual nos permitirá de manera sencilla conocer y entender la implementación de un CRUD (Create, Read, Update y Delete en inglés) sin la necesidad de un Scaffold (StandardForm).

Paso 1

Crear el Modelo el cual esta viene dado por la difinición de una tabla en la BD, para efecto del ejemplo creamos la siguiente tabla en la BD (la misma del ejemplo de Auto Carga de Obejtos)

CREATE TABLE menus
(
 id           int            unique not null auto_increment,
 nombre       varchar(100),
 titulo       varchar(100)   not null,
 primary key(id),
)

Vamos ahora a definir el modelo el cual nos permite interactuar con la BD.

[app]/models/menus.php:

<?php
class Menus extends ActiveRecord
{
    /**
     * Retorna los menu para ser paginados
     *
    /*
    public function getMenus($page, $ppage=20)
    {
        return $this->paginate("page: $page", "per_page: $ppage");
    }
}

Paso 2

El controlador es encargado de atender las peticiones del cliente (ej. browser) y a su vez de darle una respuesta. En este controller vamos a definir todas las operaciones CRUD que necesitamos.

En esta parte es importante que se haya visto el Tutorial de Auto Carga de Obejtos

[app]/controllers/menus_controller.php:

<?php
class MenusController extends ApplicationController {
    //Carga del modelo Menus, porque tenemos la autocarga de modelos desactivada (off)
    public $models = array('menus');   

    /**
     * Obtiene una lista para paginar de los menus
     */
    public function index($page=1) 
    {
        $this->listMenus = $this->Menus->getMenus($pages);
    }
    
    /**
     * Función que muestra la información
     * partes de máquina. Se consulta a través de su identificador
     */
    public function show($id) {

        //Si id tiene valor se hace la busqueda
        if($id){
            $this->obj = $this->ParteMaquina->find($id);
        } else {
            //enrutamiento porque no se coloco un ID
            return Router::route_to('action: index');
        }
    }
    
    /**
     * Crea un Controlador para el menu
     *
     */
    public function create ()
    {
        /**
         * Se verifica si el usuario envio el form (submit) y si ademas 
         * dentro del array POST existe uno llamado "menus"
         * el cual aplica la autocarga de objeto para guardar los 
         * datos enviado por POST utilizando autocarga de objeto
         */
        if($this->has_post('menus')){
            /**
             * se le pasa al modelo por constructor los datos del form y ActiveRecord recoge esos datos
             * y los asocia al campo correspondiente siempre y cuando se utilice la convención
             * model.campo
             */
            $menu = new Menus($this->post('menus'));
            //En caso que falle la operación de guardar
            if(!$menu->save()){
                Flash::error('Falló Operación');
                //se hacen persistente los datos en el formulario
                $this->menus = $this->post('menus');
                /**
                 * NOTA: para que la autocarga aplique de forma correcta, es necesario que llame a la variable de instancia
                 * igual como esta el model de la vista, en este caso el model es "menus" y quedaria $this->menus
                 */
            }
        }
    }

    /**
     * Edita un registro
     */
    public function edit($id=null) {
        
        if ($this->has_post('parte_maquina')) {
            $obj = new ParteMaquina($this->post('parte_maquina'));
            //$obj->version=  $this->ciudad->version+1;
            if ($obj->update()) {
                Flash::notice('Operación Exitosa');
                Router::route_to('controller: parte_maquina','action: index','id: 1');
            } else {
                Flash::error('No se Guardo!');
                $this->render('edit');
            }
        }else {
            $this->obj = $this->ParteMaquina->find($id);
        }
    }

    public function delete($id=0) {
        $obj  = $this->ParteMaquina->find($id);

        if($obj->delete()) {
            Flash::notice('Operación Exitosa');
        }else{
            Flash::error('No se Eliminó!');
        }

        Router::route_to('controller: parte_maquina','action: index','id: 1');
    }
}
?>

Las vistas

create.phtml

<h1>Crear parte de máquina</h1>
<?php View::content() ?>

<?php echo form_tag("parte_maquina/create")?>

<label for="parte_maquina_nombre">Nombre:</label>
        
<?php echo textupper_field_tag('parte_maquina.nombre') ?>
        
<?php echo submit_tag('Guardar') ?>
<?php echo end_form_tag(); ?>