Edición de «Como hacer un CRUD en KumbiaPHP Framework»

{{cleanupbox
|image=[[Archivo:Information_icon4.png|45px]]
|texto ='''Este Artículo cumple con todos los requererimientos de los Kumbieros.'''<br />
}}
{{cleanupbox
|texto ='''Este ejemplo es funcional para la [[KumbiaPHP_Framework_Versión_1.0_Spirit | Versión Beta1]]'''<br />
}}
== Texto de titular ==
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 (<s>StandardForm</s>) y un manejo correcto del MVC en KumbiaPHP.

== Configurando database.ini ==
Configurar el archivo [[KumbiaPHP_Framework_Versión_1.0_Spirit#databases.ini|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 (la misma del ejemplo de [[AutoCarga_de_Objetos_KumbiaPHP | Auto Carga de Objetos]])

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

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

'''''[app]/models/menus.php:'''''
<source lang="php" line>
<?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");
    }
}
</source>

== 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 [[AutoCarga_de_Objetos_KumbiaPHP | Tutorial de Auto Carga de Objetos]]

'''''[app]/controllers/menus_controller.php:'''''

<source lang="php" line>
<?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 los menus
     */
    public function index($page=1) 
    {
        $this->listMenus = $this->Menus->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($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
                 */
            }else{
                Flash::success('Operación exitosa');
            }
        }
    }

    /**
     * Edita un Registro
     */
    public function edit($id = null)
    {
    	if($id != null){
    	    //Aplicando la autocarga de objeto, para comenzar la edición
            $this->menus = $this->Menus->find((int)$id);
    	}
        //se verifica si se ha enviado el formulario (submit)
        if($this->has_post('menus')){
            
            if(!$this->Menus->update($this->post('menus'))){
                Flash::error('Falló Operación');
                //se hacen persistente los datos en el formulario
                $this->menus = $this->post('menus');
            } else {
                Router::route_to('action: index');
            }
        }
    }

    /**
     * Eliminar un menu
     * 
     * @param int $id
     */
    public function del($id = null)
    {
        if ($id) {
            if (!$this->Menus->delete((int)$id)) {
                Flash::error('Falló Operación');
            }
        }
        //enrutando al index para listar los menus
        Router::route_to('action: index');
    }
}
?>
</source>

== Vistas ==
Agregamos las vistas...

'''''[apps]/views/menus/index.phtml'''''
<source lang="php" line>
<div class="content">
    <?php echo View::content(); ?>
    <h3>Menus</h3>
    <ul>
    <?php foreach ($listMenus->items as $item) : ?>
    <li>
        <?php echo link_to("menus/create",'Agregar'); ?>
        <?php echo link_to(array("menus/edit/$item->id/", 'Editar')) ?>
        <?php echo link_to(array("menus/del/$item->id/", 'Borrar')) ?><br/>
        <strong><?php echo $item->nombre ?> - <?php echo $item->titulo ?></strong>
    </li>
    <?php endforeach; ?>
    </ul>
    
    <?php if($listMenus->prev) echo link_to(array("menus/index/$listMenus->prev/", '<< Anterior |')); ?>
    <?php if($listMenus->next) echo link_to(array("menus/index/$listMenus->next/", 'Próximo >>')); ?>
</div>
</source>


'''''[apps]/views/menus/create.phtml'''''
<source lang="php" line>
<?php View::content(); ?>
<?php echo form_tag('menus/create/') ?>
<table>
    <tr>
        <td>Nombre</td>
        <td><?php echo text_field_tag(array('menus.nombre')) ?></td>
    </tr>
    <tr>
        <td>Titulo</td>
        <td><?php echo text_field_tag(array('menus.titulo')) ?></td>
    </tr>   
    <tr>
        <td>&nbsp;</td>
        <td><?php echo submit_tag('Agregar') ?></td>
    </tr>
</table>
<?php echo end_form_tag() ?>
</source>


'''''[apps]/views/menus/edit.phtml'''''
<source lang="php" line>
<?php View::content(); ?>
<?php echo form_tag('menus/edit/') ?>
<table>
    <tr>
        <td>Nombre</td>
        <td><?php echo text_field_tag(array('menus.nombre')) ?></td>
    </tr>
    <tr>
        <td>Titulo</td>
        <td><?php echo text_field_tag(array('menus.titulo')) ?></td>
    </tr>   
    <tr>
        <td>&nbsp;</td>
        <?php echo hidden_field_tag(array('menus.id')) ?>
        <td><?php echo submit_tag('Actualizar') ?></td>
    </tr>
</table>
<?php echo end_form_tag() ?>
</source>

== Probando el CRUD ==
Ahora solo resta probar todo el código que hemos generado, en este punto es importante conocer el comportamiento de las [[Hola_Mundo_KumbiaPHP_Framework#KumbiaPHP_URLS|URL's en KumbiaPHP]].

* '''index''' es la acción para listar http://localhost/menus/index/ 
  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.
[[Categoría:Tutoriales KumbiaPHP]]

== Descarga ==
Descarga: [http://dl.dropbox.com/u/2807704/kumbiaPHP/v1_b1/app_crud.zip app_crud] para el '''core''' de Spirit v1.0 '''beta1'''.

Este ejemplo de descarga esta apuntado a la base de datos '''test''', usuario '''root''' y clave '''123'''.