Bienvenido a El Cookbook

Cuando estamos trabajando con modelos asociados, es importante tener en cuenta que al guardar los datos de un modelo hay que hacerlo con el correspondiente modelo de CakePHP. Si estás guardando una nueva Entrada y sus Comentarios asociados, entonces deberías usar ambos modelos, Entrada y Comentario, durante la operación de guardado.

Si ninguno de los registros de los modelos asociados existe aún (por ejemplo, quieres guardar registros de un nuevo Usuario y su Perfil relacionado a la vez ), primero necesitarás guardar el modelo primario o padre.

Para tener una idea de cómo funciona esto, imaginemos que tenemos una acción en nuestro controlador de usuarios UsersController que maneja el guardado de un nuevo usuario y su perfil correspondiente. En la acción de ejemplo mostrada abajo se asumirá que has POSTeado sufientes datos (usando el FormHelper) para crear un solo Usuario y un solo Perfil.

<?php
function add() {
    if (!empty($this->data)) {
        // Podemos guardar los datos de Usuario
        // deberían estar en: $this->data['Usuario']
        $this->Usuario->save($this->data);

        // El ID del nuevo Usuario está ahora en $this->User->id, así que lo
        // añadimos a los datos a grabar y grabamos el Perfil
        $this->data['Perfil']['usuario_id'] = $this->Usuario->id;

        // Como nuestro "Usuario hasOne Perfil", podemos acceder
        // al modelo Perfil a través del modelo Usuario
        $this->Usuario->Perfil->save($this->data);
    }
}
?>

1. <?php
2. function add() {
3. if (!empty($this->data)) {
4. // Podemos guardar los datos de Usuario
5. // deberían estar en: $this->data['Usuario']
6. $this->Usuario->save($this->data);
7. // El ID del nuevo Usuario está ahora en $this->User->id, así que lo
8. // añadimos a los datos a grabar y grabamos el Perfil
9. $this->data['Perfil']['usuario_id'] = $this->Usuario->id;
10. // Como nuestro "Usuario hasOne Perfil", podemos acceder
11. // al modelo Perfil a través del modelo Usuario
12. $this->Usuario->Perfil->save($this->data);
13. }
14. }
15. ?>

Como norma general, cuando trabajamos con asociaciones hasOne, hasMany y belongsTo ('tiene un', 'tiene varios', y 'pertenece a'), todo es cuestión de las claves. La idea básica es coger la clave de un modelo y ponerla en el campo de clave foránea en el otro. A veces esto puede implica usar el atributo $id de la clase del modelo después de save(), pero otras veces podría simplemente implicar obtener el ID desde un campo oculto de un formulario POSTeado a una acción del controlador.

Para complementar el enfoque básico usado arriba, CakePHP también ofrece el método muy útil saveAll, el cual te permite validar y grabar múltiples modelos de golpe. Además, saveAll provee de soporte transaccional para asegurar la integridad de los datos en tu base de datos (p.ej. si un modelo falla en la grabación, los otros modelos tampoco serán grabados).

Para que las transacciones funcionen correctametne en MySQL, tus tablas han de usar el mecanismo InnoDB. Recuerda que las tablas MyISAM no soportan transacciones.

Veamos cómo podemos usar saveAll() para grabar modelos de Compañía (utilizamos este nombre incorrecto por motivos didácticos) y Cuenta al mismo tiempo.

Primero, necesitas construir tu formulario tanto para el modelo Compañía como el modelo Cuenta (asumismo que Compañía hasMany Cuenta).

echo $form->create(Compañía, array('action'=>'añadir'));
echo $form->input('Compañía.nombre', array('label'=>'Nombre de compañía'));
echo $form->input('Compañía.descripción');
echo $form->input('Compañía.localización');

echo $form->input('Cuenta.0.nombre', array('label'=>'Nombre de cuenta'));
echo $form->input('Cuenta.0.nombreusuario');
echo $form->input('Cuenta.0.email');

echo $form->end('Añadir');

1. echo $form->create(Compañía, array('action'=>'añadir'));
2. echo $form->input('Compañía.nombre', array('label'=>'Nombre de compañía'));
3. echo $form->input('Compañía.descripción');
4. echo $form->input('Compañía.localización');
5. echo $form->input('Cuenta.0.nombre', array('label'=>'Nombre de cuenta'));
6. echo $form->input('Cuenta.0.nombreusuario');
7. echo $form->input('Cuenta.0.email');
8. echo $form->end('Añadir');

Echemos un vistazo a la manera en que hemos nombrado los campos del formulario para el modelo Cuenta. Si Compañía es nuestro modelo principal, saveAll esperará que los datos de los modelos relacionados (en este caso, Cuenta) llegue en un formado específico, y teniendo Cuenta.0.nombreCampo es exactamente lo que necesitamos.

El nombrado de campos de arriba es necesario para la asociación hasMany. Si la asociación entre los modelos es hasOne, necesitarás usar la notación NombreModelo.nombreCampo para el modelo asociado.

Ahora, en nuestro compañias_controler.php podemos crear una acción add():

function add() {
   if(!empty($this->data)) {
      $this->Compañia->saveAll($this->data, array('validate'=>'first'));
   }
}

1. function add() {
2. if(!empty($this->data)) {
3. $this->Compañia->saveAll($this->data, array('validate'=>'first'));
4. }
5. }

Esto es todo para ello. Ahora nuestros modelos Compañía y Cuenta serán validados y grabados al mismo tiempo. Una cosa rápida que comentar aquí es el uso de array('validate'=>'first'): esa opción asegurará que ambos modelos son validados.

Esta función te ayuda a cachear el contador de datos relacionados. En vez de contar los registros manualmente mediante find('count'), el modelo mismo monitoriza cualquier inserción/borrado al modelo '$hasMany' asociado, e incrementa/decrementa un campo entero dedicado dentro de la tabla del modelo padre.

El nombre del campo consiste en el nombre del modelo en singular seguido de un guión de subrayado (_) y la palabra "count".

Supongamos que tienes un modelo llamado "ImagenAlbum" y un modelo llamado "Imagen", entonces añadirías un campo INT a la tabla "imagenes_albumes" llamado "imagen_count". Si tus nombres son más complejos, aquí está otro ejemplo: Con "EntradaBlog" y "ComentarioEntradaBlog", el nombre del campo debería ser "comentario_entrada_blog_count" y necesita ser añadido a "entradas_blog".

Una vez que has añadido el campo contador, estará bien que actives esta funcionalidad añadiendo la clave "counterCache" al array de asociaciones $belongsTo y establecer el valor a true.

class AlbumImagen extends AppModel {
    var $hasMany = array(
        'Imagen'
    );
}

class Imagen extends AppModel {
    var $belongsTo = array(
        'AlbumImagen' => array('counterCache' => true)
    );
}

1. class AlbumImagen extends AppModel {
2. var $hasMany = array(
3. 'Imagen'
4. );
5. }
6. class Imagen extends AppModel {
7. var $belongsTo = array(
8. 'AlbumImagen' => array('counterCache' => true)
9. );
10. }

Ahora, todas las veces que añadar una nueva "Imagen" a "AlbumImagen" el número en "imagen_count" se incremetnará (o decrementará si realizas un borrado).

Grabar modelos que están asociados por hasOne,belongsTo y hasMany es bastante simple: simplemente rellenas el campo de clave foránea con el ID del modelo asociado. Una vez que está hecho, simplemente llamas al método save() del modelo y todo queda enlazado correctamente.

Con HABTM (Has And Belongs To Many), necesitas establecer el ID del modelo asociado en tu array de datos. Construiremos un formulario que crea una nueva etiqueta y la asocia al vuelo con alguna receta.

El formulario más simple debería parecerse al algo como esto (asumimos que $receta_id ya está establecido a algo):

<?php
    echo $form->create('Etiqueta');
    echo $form->input('Receta.id', array('type'=>'hidden', 'value' => $receta_id));
    echo $form->input('Etiqueta.nombre');
    echo $form->end('Añadir etiqueta');
?>

1. <?php
2. echo $form->create('Etiqueta');
3. echo $form->input('Receta.id', array('type'=>'hidden', 'value' => $receta_id));
4. echo $form->input('Etiqueta.nombre');
5. echo $form->end('Añadir etiqueta');
6. ?>

En este ejemplo, puedes ver el campo oculto Receta.id cuyo valor se establece al ID de la receta a la que queremos enlazar la etiqueta. La acción del controlador que se encarga de guardar este formulario es muy simple:

function add() {
    // Graba la asociación
    if ($this->Etiqueta->save($this->data)) {
        // Hacer algo si todo fue bien
    }
}

1. function add() {
2. // Graba la asociación
3. if ($this->Etiqueta->save($this->data)) {
4. // Hacer algo si todo fue bien
5. }
6. }

Y de esa manera, nuestra nueva Etiqueta es creada y asociada con Receta, cuyo ID estaba en $this->data['Receta']['id'].