Beta2 CRUD en KumbiaPHP Framework

De KumbiaPHP Framework Wiki
{{#if:Information icon4.png |}}

{{#if:

|}}


{{#if: |}}

{{#if:

|}}


Introducción

Este ejemplo 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) y un manejo correcto del MVC en KumbiaPHP.

El CRUD de la beta1 sigue funcionando igual en la beta2, pero queda desaconsejado. En la versión 1.0 se podrá usar de las 2 maneras. Y la 1.2 que saldrá junto a la 1.0 sólo se usará lo nuevo y se eliminará lo desaconsejado.

Configurando database.ini

Configurar el archivo databases.ini, con los datos y motor de Base de Datos a utilizar.

Modelo

Crear el Modelo el cual esta viene dado por la definición de una tabla en la BD, para efecto del ejemplo creamos la siguiente tabla.

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");
    }
}

Controller

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 Objetos

[app]/controllers/menus_controller.php:

<?php
/**
 * Carga del modelo Menus...
 */
Load::models('menus');

class MenusController extends ApplicationController {
    /**
     * Obtiene una lista para paginar los menus
     */
    public function index($page=1) 
    {
        $menu = new Menus();
        $this->listMenus = $menu->getMenus($page);
    }
    
    /**
     * Crea un Registro
     */
    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(Input::hasPost('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(Input::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 = Input::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
                 */
            }else{
                Flash::valid('Operación exitosa');
            }
        }
    }

    /**
     * Edita un Registro
     */
    public function edit($id = null)
    {
        $menu = new Menus();
    	if($id != null){
    	    //Aplicando la autocarga de objeto, para comenzar la edición
            $this->menus = $menu->find($id);
    	}
        //se verifica si se ha enviado el formulario (submit)
        if(Input::hasPost('menus')){
            
            if(!$menus->update(Input::post('menus'))){
                Flash::error('Falló Operación');
                //se hacen persistente los datos en el formulario
                $this->menus = Input::post('menus');
            } else {
                Flash::valid('Operación exitosa');
                //enrutando por defecto al index del controller
                return Router::redirect();
            }
        }
    }

    /**
     * Eliminar un menu
     * 
     * @param int $id
     */
    public function del($id = null)
    {
        if ($id) {
            $menu = new Menus();
            if (!$menu->delete($id)) {
                Flash::error('Falló Operación');
            }else{
                Flash::valid('Operación exitosa');
            }
        }
        //enrutando por defecto al index del controller
        return Router::redirect();
    }
}
?>

Vistas

Agregamos las vistas...

[apps]/views/menus/index.phtml

<div class="content">
    <?php echo View::content(); ?>
    <h3>Menus</h3>
    <ul>
    <?php foreach ($listMenus->items as $item) : ?>
    <li>
        <?php echo Html::link("menus/edit/$item->id/", 'Editar') ?>
        <?php echo Html::link("menus/del/$item->id/", 'Borrar') ?>
        <strong><?php echo $item->nombre ?> - <?php echo $item->titulo ?></strong>
    </li>
    <?php endforeach; ?>
    </ul>
    
     // ejemplo manual de paginador, hay partial listos en formato digg, clasic,....
    <?php if($listMenus->prev) echo Html::link("menus/index/$listMenus->prev/", '<< Anterior |'); ?>
    <?php if($listMenus->next) echo Html::link("menus/index/$listMenus->next/", 'Próximo >>'); ?>
</div>


[apps]/views/menus/create.phtml

<?php View::content(); ?>
<h3>Crear menu<h3>

<?php echo Form::open(); // por defecto llama a la misma url ?>
        
        <label for="menus.nombre">Nombre</label>
        <?php echo Form::text('menus.nombre') ?>
        
        <label for="menus.titulo">Título</label>
        <?php echo Form::text('menus.titulo') ?>

        <?php echo Form::submit('Agregar') ?>

<?php echo Form::close() ?>


[apps]/views/menus/edit.phtml

<?php View::content(); ?>
<h3>Editar menu<h3>

<?php echo Form::open(); // por defecto llama a la misma url ?>

        <label for="menus.nombre">Nombre</label>
        <?php echo Form::text('menus.nombre') ?>

        <label for="menus.titulo">Título</label>
        <?php echo Form::text('menus.titulo') ?>

        <?php echo Form::hidden('menus.id') ?>
        <?php echo Form::submit('Actualizar') ?>

<?php echo Form::close() ?>

Probando el CRUD

Ahora solo resta probar todo el código que hemos generado, en este punto es importante conocer el comportamiento de las URL's en KumbiaPHP.

 NOTA: index/ se puede pasar de forma implícita o no KumbiaPHP en caso que no se le pase una acción 

buscara por defecto un index, es decir si colocamos

 http://localhost/menus/
  • create crea un menu en la Base de Datos http://localhost/menus/create/
  • Las acciones del y edit a ambas se debe entrar desde el index, ya que reciben el parámetros a editar o borrar según el caso.