Welcome to Le Cookbook

Quand on travaille avec des modèles associés, il est important de réaliser que sauvegarder les données d'un modèle doit toujours se faire depuis le modèle CakePHP correspondant. Si vous sauvegardez un nouveau Post et ses Commentaires associés, vous devrez alors utiliser à la fois les modèles Post et Commentaire durant l'opération de sauvegarde.

Si aucun enregistrement des modèles associés n'existe dans le système à ce moment là (par exemple si vous souhaitez sauvegarder un nouvel Utilisateur et ses enregistrements de Profil liés en même temps), vous devrez d'abord sauvegarder le modèle primaire (ou parent).

Pour avoir une idée de comment cela fonctionne, imaginons que nous ayons une action dans notre contrôleur UtilisateurController qui permette de sauvegarder un nouvel Utilisateur et un Profil lié. L'exemple d'action ci-dessous supposera que vous ayez POSTé suffisamment de données (en utilisant le FormHelper) pour créer un Utilisateur et un Profil.

<?php
function add() {
    if (!empty($this->data)) {
        // On peut sauvegarder les données Utilisateur
        // elles devraient être dans $this->data['Utilisateur']

        $this->Utilisateur->save($this->data);

        // Maintenant ajouton cette information aux données à sauvegarder
        // et sauvegardons le Profil

        // L'ID de l'Utilisateur nouvellement créé a été stockée dans
        // $this->User->id.

        $this->data['Profil']['utilisateur_id'] = $this->Utilisateur->id;

        // Car Utilisateur hasOne Profil, nous pouvons accéder
        // au modèle Profil à travers le modèle Utilisateur :

        $this->Utilisateur->Profil->save($this->data);
    }
}

?>

1. <?php
2. function add() {
3. if (!empty($this->data)) {
4. // On peut sauvegarder les données Utilisateur
5. // elles devraient être dans $this->data['Utilisateur']
6. $this->Utilisateur->save($this->data);
7. // Maintenant ajouton cette information aux données à sauvegarder
8. // et sauvegardons le Profil
9. // L'ID de l'Utilisateur nouvellement créé a été stockée dans
10. // $this->User->id.
11. $this->data['Profil']['utilisateur_id'] = $this->Utilisateur->id;
12. // Car Utilisateur hasOne Profil, nous pouvons accéder
13. // au modèle Profil à travers le modèle Utilisateur :
14. $this->Utilisateur->Profil->save($this->data);
15. }
16. }
17. ?>

Une règle lorsque l'on travaille avec les associations hasOne, hasMany et belongsTo : tout n'est que manipulation de clés. L'idée de base est de prendre la clé d'un modèle et de la placer dans le champ de clé étrangère de l'autre. Quelquefois, cela peut impliquer l'utilisation de l'attribut $id de la classe de modèle après une sauvegarde (save()), mais dans d'autres cas cela peut simplement être la récupération d'un ID depuis le champ caché du formulaire qui a été POSTé vers une action de contrôleur.

Cette fonction vous aide à garder le compte du nombre de données reliées. Au lieu de compter en effectuant un SELECT (i.e en utilisant find('count')), le modèle repère lui-même tous les ajouts/suppressions qui ont lieu pour un modèle référencé dans $hasMany et incrémente/décrémente un champ entier dans sa table (table du modèle parent).

Le nom de ce champ est le nom au singulier du nom du modèle suivi d'un underscore et du mot "counter".

Imaginons que vous ayez un modèle nommé "AlbumDimage" et un modèle nommé "Image", vous devriez ajouter un champ de type "INT" à la table "album_dimage" et le nommer "image_count". Si vos noms sont plus complexes, voici un autre exemple : Avec "MessageBlog" et "CommentaireMessageBlog", le nom du champ serait "commentaire_message_blog_count" et devrait être ajouté à la table "message_blogs".

Une fois que vous avez ajouté le champ de compteur vous pouvez activer cette fonctionnalité en ajoutant la clé "counterCache" au tableau d'association "$belongsTo" et fixer sa valeur à "true".

class AlbumDimage extends AppModel {
    var $hasMany = array(
        'Image'
    )
}

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

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

Maintenant, à chaque fois que vous ajouterez une nouvelle "Image" à "AlbumDimage", le nombre contenu dans "image_count" augmentera (ou diminuera si vous effectuez une suppression).

Sauvegarder des modèles qui sont associés par un hasOne, belongsTo et hasMany est relativement simple : vous n'avez qu'à renseigner la clé étrangère avec l'ID du modèle associé. Une fois que ceci est fait, il vous suffit d'appeler la méthode save() sur le modèle et tout se reliera correctement.

Avec les relations HABTM, vous devez fixer l'ID du modèle associé dans votre tableau de données. Nous allons construire un formulaire qui crée un nouveau tag et l'associe à la volée à une recette.

Le formulaire le plus simpliste ressemblerait à quelque chose comme ceci (nous supposerons que $recette_id contient déjà une valeur) :

<?php echo $form->create('Tag');?>
    <?php echo $form->input(
        'Recette.id', 
        array('type'=>'hidden', 'value' => $recette_id)); ?>
    <?php echo $form->input('Tag.nom'); ?>
    <?php echo $form->end('Ajouter le tag'); ?>

1. <?php echo $form->create('Tag');?>
2. <?php echo $form->input(
3. 'Recette.id',
4. array('type'=>'hidden', 'value' => $recette_id)); ?>
5. <?php echo $form->input('Tag.nom'); ?>
6. <?php echo $form->end('Ajouter le tag'); ?>

Dans cet exemple, vous pouvez remarquer le champ caché "Recette.id" dont la valeur est l'ID de la recette à laquelle nous voulons relier le tag. L'action du contrôleur qui se charge de sauvegarder le formulaire est très simple :

function add() {
    // Sauvegarde l'association
    if ($this->Tag->save($this->data)) {
        // Faire quelque chose en cas d'enregistrement réussi
    }
}

1. function add() {
2. // Sauvegarde l'association
3. if ($this->Tag->save($this->data)) {
4. // Faire quelque chose en cas d'enregistrement réussi
5. }
6. }

De cette manière, notre nouveau Tag est créé et associé avec une Recette, dont l'ID était défini dans $this->data['Recette']['id'].