Sauvegarder les Données¶

Insérer des Données¶

Le moyen le plus simple d’insérer des données dans une base de données est de créer une nouvelle entity et de la passer à la méthode save() de la classe Table:

use Cake\ORM\Locator\LocatorAwareTrait;

$articlesTable = $this->getTableLocator()->get('Articles');
$article = $articlesTable->newEmptyEntity();

$article->title = 'Un nouvel Article';
$article->body = 'Ceci est le contenu de cet article';

if ($articlesTable->save($article)) {
    // L'entity $article contient maintenant l'id
    $id = $article->id;
}

Mettre à jour des Données¶

La méthode save() sert également à la mise à jour des données:

use Cake\ORM\Locator\LocatorAwareTrait;

$articlesTable = $this->getTableLocator()->get('Articles');
$article = $articlesTable->get(12); // Retourne l'article avec l'id 12

$article->title = 'Un nouveau titre pour cet article';
$articlesTable->save($article);

CakePHP saura s’il doit faire une insertion ou une mise à jour d’après le résultat de la méthode isNew(). Les entities qui sont récupérées via get() ou find() renverront toujours false lorsqu’on appelle leur méthode isNew().

Enregistrer avec des Associations¶

Par défaut, la méthode save() sauvegardera aussi un seul niveau d’association:

$articlesTable = $this->getTableLocator()->get('Articles');
$author = $articlesTable->Authors->findByUserName('mark')->first();

$article = $articlesTable->newEmptyEntity();
$article->title = 'Un article par mark';
$article->author = $author;

if ($articlesTable->save($article)) {
    // La valeur de la clé étrangère a été ajoutée automatiquement.
    echo $article->author_id;
}

La méthode save() est également capable de créer de nouveaux enregistrements pour les associations:

$firstComment = $articlesTable->Comments->newEmptyEntity();
$firstComment->body = 'Un super article';

$secondComment = $articlesTable->Comments->newEmptyEntity();
$secondComment->body = 'J aime lire ceci!';

$tag1 = $articlesTable->Tags->findByName('cakephp')->first();
$tag2 = $articlesTable->Tags->newEmptyEntity();
$tag2->name = 'Génial';

$article = $articlesTable->get(12);
$article->comments = [$firstComment, $secondComment];
$article->tags = [$tag1, $tag2];

$articlesTable->save($article);

Associer des Enregistrements Many to Many¶

Dans le code ci-dessus il y a déjà un exemple de liaison d’un article vers deux tags. Il y a un autre moyen de faire la même chose en utilisant la méthode link() dans l’association:

$tag1 = $articlesTable->Tags->findByName('cakephp')->first();
$tag2 = $articlesTable->Tags->newEmptyEntity();
$tag2->name = 'Génial';

$articlesTable->Tags->link($article, [$tag1, $tag2]);

Dissocier des Enregistrements Many To Many¶

Pour dissocier des enregistrements many-to-many, utilisez la méthode unlink():

$tags = $articlesTable
    ->Tags
    ->find()
    ->where(['name IN' => ['cakephp', 'awesome']])
    ->toList();

$articlesTable->Tags->unlink($article, $tags);

Lorsque vous modifiez des enregistrements en définissant ou modifiant directement leurs propriétés, il n’y aura pas de validation, ce qui est problématique s’il s’agit d’accepter les données d’un formulaire. La section suivante explique comment convertir efficacement les données de formulaire en entities afin qu’elles puissent être validées et sauvegardées.

Convertir des Données BelongsToMany¶

Si vous sauvegardez des associations belongsToMany, vous pouvez utiliser soit une liste de données d’entity, soit une liste d’ids. Quand vous utilisez une liste de données d’entity, les données de votre requête devraient ressembler à ceci:

$data = [
    'title' => 'Mon titre',
    'body' => 'Le texte',
    'user_id' => 1,
    'tags' => [
        ['name' => 'CakePHP'],
        ['name' => 'Internet'],
    ],
];

Ce code créera 2 nouveaux tags. Si vous voulez créer un lien entre un article et des tags existants, vous pouvez utiliser une liste d’ids. Les données de votre requête doivent ressembler à ceci:

$data = [
    'title' => 'Mon titre',
    'body' => 'Le texte',
    'user_id' => 1,
    'tags' => [
        '_ids' => [1, 2, 3, 4],
    ],
];

Si vous souhaitez lier des entrées belongsToMany existantes et en créer de nouvelles en même temps, vous pouvez utiliser la forme étendue:

$data = [
    'title' => 'Mon titre',
    'body' => 'Le texte',
    'user_id' => 1,
    'tags' => [
        ['name' => 'Un nouveau tag'],
        ['name' => 'Un autre nouveau tag'],
        ['id' => 5],
        ['id' => 21],
    ],
];

Quand ces données seront converties en entities, il y aura 4 tags. Les deux premiers seront de nouveaux objets, et les deux autres seront des références à des tags existants.

Quand vous convertissez des données de belongsToMany, vous pouvez désactiver la création d’une nouvelle entity en utilisant l’option onlyIds:

$result = $articles->patchEntity($entity, $data, [
    'associated' => ['Tags' => ['onlyIds' => true]],
]);

Quand elle est activée, cette option restreint la conversion des données de belongsToMany pour utiliser uniquement la clé _ids.

Convertir des Données HasMany¶

Si vous souhaitez mettre à jour des associations hasMany existantes et mettre à jour leurs propriétés, vous devez d’abord vous assurer que votre entity est chargée avec les données hasMany associées. Vous pouvez ensuite utiliser une requête avec des données structurées de la façon suivante:

$data = [
    'title' => 'Mon titre',
    'body' => 'Le texte',
    'comments' => [
        ['id' => 1, 'comment' => 'Mettre à jour le premier commentaire'],
        ['id' => 2, 'comment' => 'Mettre à jour le deuxième commentaire'],
        ['comment' => 'Créer un nouveau commentaire'],
    ],
];

Si vous sauvegardez des associations hasMany et que voulez lier des enregistrements existants à un nouveau parent, vous pouvez utiliser le format _ids:

$data = [
    'title' => 'Mon nouvel article',
    'body' => 'Le texte',
    'user_id' => 1,
    'comments' => [
        '_ids' => [1, 2, 3, 4],
    ],
];

Quand vous convertissez des données de hasMany, vous pouvez désactiver la création d’une nouvelle entity en utilisant l’option onlyIds. Quand elle est activée, cette option restreint la conversion des données hasMany pour utiliser uniquement la clé _ids et ignorer toutes les autres données.

Convertir des Enregistrements Multiples¶

Lorsque vous créez des formulaires de création/mise à jour de plusiseurs enregistrements en une seule opération, vous pouvez utiliser newEntities():

// Dans un controller.

$articles = $this->getTableLocator()->get('Articles');
$entities = $articles->newEntities($this->request->getData());

Dans cette situation, les données de la requête pour plusieurs articles doivent ressembler à ceci:

$data = [
    [
        'title' => 'Premier post',
        'published' => 1,
    ],
    [
        'title' => 'Second post',
        'published' => 1,
    ],
];

Une fois que vous avez converti les données de la requête en entities, vous pouvez sauvegarder:

// Dans un controller.
foreach ($entities as $entity) {
    // Sauvegarder l'entity
    $articles->save($entity);
}

Ce code va lancer séparément une transaction pour chaque entity sauvegardée. Si vous voulez traiter toutes les entities en transaction unique, vous pouvez utiliser saveMany() ou saveManyOrFail():

// Renvoie un booléen pour indiquer si l'opération a réussi
$articles->saveMany($entities);

// Lève une PersistenceFailedException si l'un des enregistrements échoue
$articles->saveManyOrFail($entities);

Changer les Champs Accessibles¶

Il est également possible d’autoriser newEntity() à écrire dans des champs non accessibles. Par exemple, id est généralement absent de la propriété _accessible. Dans un tel cas, vous pouvez utiliser l’option accessibleFields. Il pourrait être utile de conserver les ids des entities associées:

// Dans un controller.

$articles = $this->getTableLocator()->get('Articles');
$entity = $articles->newEntity($this->request->getData(), [
    'associated' => [
        'Tags', 'Comments' => [
            'associated' => [
                'Users' => [
                    'accessibleFields' => ['id' => true],
                ],
            ],
        ],
    ],
]);

Le code ci-dessus permet de conserver l’association entre Comments et Users pour l’entity concernée.

Fusionner les Données de la Requête dans les Entities¶

Pour mettre à jour des entities, vous pouvez choisir d’appliquer les données de la requête directement sur une entity existante. Cela a l’avantage que seuls les champs réellement modifiés seront sauvegardés, au lieu d’envoyer tous les champs à la base de données, même ceux qui sont inchangés. Vous pouvez fusionner un tableau de données brutes dans une entity existante en utilisant la méthode patchEntity():

// Dans un controller.

$articles = $this->getTableLocator()->get('Articles');
$article = $articles->get(1);
$articles->patchEntity($article, $this->request->getData());
$articles->save($article);

// Dans un controller.

$articles = $this->getTableLocator()->get('Articles');
$article = $articles->get(1);
$articles->patchEntity($article, $data, ['validate' => false]);

$articles->patchEntity($article, $this->request->getData(), [
    'validate' => 'custom',
    'associated' => ['Tags', 'Comments.Users' => ['validate' => 'signup']]
]);

// Dans un controller.
$associated = ['Tags', 'Comments.Users'];
$article = $articles->get(1, ['contain' => $associated]);
$articles->patchEntity($article, $this->request->getData(), [
    'associated' => $associated,
]);
$articles->save($article);

$data = [
    'title' => 'Mon titre',
    'user' => [
        'username' => 'mark',
    ],
];

// Dans un controller.
$entity = $articles->patchEntity(new Article, $data);
echo $entity->user->username; // Affiche 'mark'

// Dans l'entity Product
protected $_accessible = [
    // .. autres propriétés
   'tags' => true,
];

$data = [
    'title' => 'Mon titre',
    'body' => 'Le text',
    'comments' => [
        ['body' => 'Premier commentaire', 'id' => 1],
        ['body' => 'Second commentaire', 'id' => 2],
    ],
];
$entity = $articles->newEntity($data);
$articles->save($entity);

$newData = [
    'comments' => [
        ['body' => 'Commentaire modifié', 'id' => 1],
        ['body' => 'Un nouveau commentaire'],
    ],
];
$articles->patchEntity($entity, $newData);
$articles->save($entity);

[
    'title' => 'Mon titre',
    'body' => 'Le text',
    'comments' => [
        ['body' => 'Commentaire modifié', 'id' => 1],
        ['body' => 'Un nouveau commentaire'],
    ]
];

// Dans un controller.
use Cake\Collection\Collection;

$comments = $this->getTableLocator()->get('Comments');
$present = (new Collection($entity->comments))->extract('id')->filter()->toList();
$comments->deleteAll([
    'article_id' => $article->id,
    'id NOT IN' => $present,
]);

// Dans un controller.

$articles = $this->getTableLocator()->get('Articles');
$list = $articles->find('popular')->toList();
$patched = $articles->patchEntities($list, $this->request->getData());
foreach ($patched as $entity) {
    $articles->save($entity);
}

// Dans un controller.
$patched = $articles->patchEntities(
    $list,
    $this->request->getData(),
    ['associated' => ['Tags', 'Comments.Users']]
);

Modifier les Données de la Requête Avant de Construire les Entities¶

Si vous devez modifier les données de la requête avant de les convertir en entities, vous pouvez utiliser l’event Model.beforeMarshal. Cet event vous permet de manipuler les données de la requête juste avant la création des entities:

// Ajoutez les instructions use au début de votre fichier.
use Cake\Event\EventInterface;
use ArrayObject;

// Dans une classe de table ou un behavior
public function beforeMarshal(EventInterface $event, ArrayObject $data, ArrayObject $options)
{
    if (isset($data['username'])) {
        $data['username'] = mb_strtolower($data['username']);
    }
}

Le paramètre $data est une instance ArrayObject, donc vous n’avez pas besoin de la renvoyer pour changer les données qui seront utilisées pour créer les entities.

Le but principal de beforeMarshal est d’aider les utilisateurs à passer le process de validation lorsque des erreurs simples peuvent être résolues automatiquement, ou lorsque les données doivent être restructurées pour être placées dans les bons champs.

L’event Model.beforeMarshal est lancé juste au début du process de validation. Une des raisons à cela est que beforeMarshal est autorisé à modifier les règles de validation et les options d’enregistrement, telles que la liste blanche des champs. La validation est lancée juste après la fin de l’exécution de cet événement. Un exemple classique de modification des données avant leur validation est la suppression des espaces superflus dans tous les champs avant leur enregistrement:

// Ajoutez les instructions use au début de votre fichier.
use Cake\Event\EventInterface;
use ArrayObject;

// Dans une table ou un behavior
public function beforeMarshal(EventInterface $event, ArrayObject $data, ArrayObject $options)
{
    foreach ($data as $key => $value) {
        if (is_string($value)) {
            $data[$key] = trim($value);
        }
    }
}

Du fait du mode de fonctionnement du marshalling, si un champ ne passe pas la validation il sera automatiquement supprimé du tableau de données et ne sera pas copié dans l’entity. Cela évite d’avoir des données incohérentes dans l’objet entity.

De plus, les données fournies à la méthode beforeMarshal sont une copie des données passées. La raison à cela est qu’il est important de préserver les données saisies à l’origine par l’utilisateur, car elles sont susceptibles de servir autre part.

Modifier les Entités Après leur Mise À Jour À Partir de la Requête¶

L’événement Model.afterMarshal vous permet de modifier les entités après qu’elles auront été créées ou modifiées à partir des données de la requête. Cela peut vous servir à appliquer une logique de validation supplémentaire qui ne peut pas être exprimée de manière simple à travers les méthodes du Validator:

// Ajoutez les instructions use au début de votre fichier.
use Cake\Event\EventInterface;
use Cake\ORM\EntityInterface;
use ArrayObject;

// Dans une classe de table ou de behavior
public function afterMarshal(
    EventInterface $event,
    EntityInterface $entity,
    ArrayObject $data,
    ArrayObject $options
) {
    // Ne pas accepter les personnes dont le nom commence par J le 20 de
    // chaque mois.
    if (mb_substr($entity->name, 1) === 'J' && (int)date('d') === 20) {
        $entity->setError('name', 'Pas de noms en J aujourd\'hui. Désolé.');
    }
}

Valider les Données Avant de Construire les Entities¶

Le chapitre Valider des Données vous fournira plus d’informations sur les fonctionnalités de validation de CakePHP pour garantir l’exactitude et la cohérence de vos données.

Éviter les Attaques d’Assignement en Masse de Propriétés¶

Lors de la création ou la fusion des entities à partir de données de la requête, vous devez être attentif aux ajouts ou modifications que vous permettez à vos utilisateurs dans les entities. Par exemple, en envoyant dans la requpete un tableau contenant user_id, un pirate pourrait changer le propriétaire d’un article, ce qui entraînerait des effets indésirables:

// Contient ['user_id' => 100, 'title' => 'Piraté !'];
$data = $this->request->getData();
$entity = $this->patchEntity($entity, $data);
$this->save($entity);

Il y a deux façons de se protéger contre ce problème. La première est de définir les colonnes par défaut qui peuvent être définies en toute sécurité à partir d’une requête en utilisant la fonctionnalité d”Assignement de Masse dans les entities.

La deuxième façon est d’utiliser l’option fields lors de la création ou la fusion de données dans une entity:

// Contient ['user_id' => 100, 'title' => 'Piraté !'];
$data = $this->request->getData();

// Permet seulement de changer le title
$entity = $this->patchEntity($entity, $data, [
    'fields' => ['title']
]);
$this->save($entity);

Vous pouvez aussi contrôler les propriétés qui peuvent être assignées pour les associations:

// Permet seulement de modifier le titre et les tags
// et le nom du tag est la seule colonne qui puisse être définie
$entity = $this->patchEntity($entity, $data, [
    'fields' => ['title', 'tags'],
    'associated' => ['Tags' => ['fields' => ['name']]]
]);
$this->save($entity);

Cette fonctionnalité est pratique quand vos utilisateurs ont accès plusieurs fonctions et que vous voulez leur permettre de modifier différentes données en fonction de leurs privilèges.

Sauvegarder les Associations¶

Quand vous sauvegardez une entity, vous pouvez aussi choisir de sauvegarder tout ou partie des entities associées. Par défaut, toutes les entities de premier niveau seront sauvegardées. Par exemple, sauvegarder un Article va aussi mettre à jour automatiquement toute entity modifiée directement liée à la table des articles.

Vous pouvez accéder à un réglage plus fin des associations qui sont sauvegardées en utilisant l’option associated:

// Dans un controller.

// Sauvegarde seulement l'association avec les commentaires
$articles->save($entity, ['associated' => ['Comments']]);

Vous pouvez définir une sauvegarde d’associations imbriquées sur plusieurs niveaux en utilisant la notation par point:

// Sauvegarde la société, les employés et les adresses liées à chacun d'eux.
$companies->save($entity, ['associated' => ['Employees.Addresses']]);

De plus, vous pouvez combiner la notation par point pour les associations avec le tableau d’options:

$companies->save($entity, [
  'associated' => [
    'Employees',
    'Employees.Addresses'
  ]
]);

Vos entities doivent être structurées de la même façon qu’elles l’étaient quand elles ont été chargées à partir de la base de données. Consultez la documentation du helper Form pour savoir comment Créer des Inputs pour les Données Associées.

Si vous construisez ou modifiez des données associées après avoir construit vos entities, vous devrez marquer la propriété d’association comme étant modifiée en utilisant setDirty():

$company->author->name = 'Master Chef';
$company->setDirty('author', true);

Sauvegarder les Associations BelongsTo¶

Lors de la sauvegarde des associations belongsTo, l’ORM attend une entity imbriquée unique avec le nom de l’association au singulier et des underscores. Par exemple:

// Dans un controller.
$data = [
    'title' => 'Premier Post',
    'user' => [
        'id' => 1,
        'username' => 'mark'
    ]
];

$articles = $this->getTableLocator()->get('Articles');
$article = $articles->newEntity($data, [
    'associated' => ['Users']
]);

$articles->save($article);

Sauvegarder les Associations HasOne¶

Lors de la sauvegarde d’associations hasOne, l’ORM attend une entity imbriquée unique avec le nom de l’association au singulier et des underscores underscore. Par exemple:

// Dans un controller.
$data = [
    'id' => 1,
    'username' => 'cakephp',
    'profile' => [
        'twitter' => '@cakephp'
    ]
];

$users = $this->getTableLocator()->get('Users');
$user = $users->newEntity($data, [
    'associated' => ['Profiles']
]);
$users->save($user);

Sauvegarder les Associations HasMany¶

Lors de la sauvegarde d’associations hasMany, l’ORM attend un tableau d’entities avec le nom de l’association au pluriel et des underscores. Par exemple:

// Dans un controller.
$data = [
    'title' => 'Premier Post',
    'comments' => [
        ['body' => 'Le meilleur post de ma vie'],
        ['body' => 'Celui-là, je l\'aime vraiment bien.']
    ]
];

$articles = $this->getTableLocator()->get('Articles');
$article = $articles->newEntity($data, [
    'associated' => ['Comments']
]);
$articles->save($article);

Lors de la sauvegarde d’associations hasMany, les enregistrements associés seront soit mis à jour, soit insérés. Dans les cas où l’enregistrement a déjà des enregistrements associés dans la base de données, vous avez le choix entre deux stratégies de sauvegarde:

append

Les enregistrements associés sont mis à jour dans la base de données ou, s’ils ne correspondent à aucun enregistrement existant, sont insérés.

replace

Tout enregistrement existant qui ne correspond pas aux enregistrements fournis sera supprimé de la base de données. Seuls les enregistrements fournis resteront (ou seront insérés).

Par défaut, l’ORM utilise la stratégie de sauvegarde append. Consultez Associations HasMany pour plus de détails sur la définition de saveStrategy.

Quel que soit le moment où vous ajoutez de nouveaux enregistrements dans une association existante, vous devez toujours marquer la propriété de l’association comme “dirty”. Cela fait savoir à l’ORM que la propriété de cette association doit être persistée:

$article->comments[] = $comment;
$article->setDirty('comments', true);

Sans l’appel à setDirty(), les commentaires mis à jour ne seront pas sauvegardés.

Si vous créez une entité et voulez y attacher des enregistrements existants dans une association hasMany ou belongsToMany, vous devez d’abord initialiser la propriété de l’association:

$article->comments = [];

Sans l’initialisation, l’appel à $article->comments[] = $comment; sera sans effet.

Sauvegarder les Associations BelongsToMany¶

Lors de la sauvegarde d’associations hasMany, l’ORM attend un tableau d’entities avec le nom de l’association au pluriel et des underscores. Par exemple:

// Dans un controller.
$data = [
    'title' => 'Premier Post',
    'tags' => [
        ['tag' => 'CakePHP'],
        ['tag' => 'Framework']
    ]
];

$articles = $this->getTableLocator()->get('Articles');
$article = $articles->newEntity($data, [
    'associated' => ['Tags']
]);
$articles->save($article);

Quand vous convertissez les données de la requête en entities, les méthodes newEntity() et newEntities() traiteront les deux tableaux de propriétés, ainsi qu’une liste d’ids sous la clé _ids. L’utilisation de la clé _ids permet de construire des contrôles de formulaire basés sur une liste déroulante ou une liste de cases à cocher pour les associations belongsToMany. Consultez la section Convertir les Données Requêtées en Entities pour plus d’informations.

Lors de la sauvegarde des associations belongsToMany, vous avez le choix entre deux stratégies de sauvegarde:

append

Seuls les nouveaux liens seront créés de chaque côté de cette association. Cette stratégie détruira pas les liens existants même s’ils sont absents du tableau d’entities à sauvegarder.

replace

Lors de la sauvegarde, les liens existants seront supprimés et les nouveaux liens seront créés dans la table de jointure. S’il y a des liens existants dans la base de données vers certaines des entities que l’on souhaite sauvegarder, ces liens seront mis à jour, et non supprimés et re-sauvegardés.

Consultez Associations BelongsToMany pour plus de détails sur la façon de définir saveStrategy.

Par défaut, l’ORM utilise la stratégie replace. Si vous ajoutez à quelque moment que ce soit de nouveaux enregistrements dans une association existante, vous devez toujours marquer la propriété de l’association comme “dirty”. Cela fait savoir à l’ORM que la propriété de l’association doit être persistée:

$article->tags[] = $tag;
$article->setDirty('tags', true);

Sans appel à setDirty(), les tags modifiés ne seront pas sauvegardés.

Vous vous retrouverez souvent à vouloir créer une association entre deux entities existantes, par exemple un utilisateur co-auteur d’un article. Pour cela, utilisez la méthode link():

$article = $this->Articles->get($articleId);
$user = $this->Users->get($userId);

$this->Articles->Users->link($article, [$user]);

Lors de la sauvegarde d’associations belongsToMany, il peut être pertinent de sauvegarder des données supplémentaires dans la table de jointure. Dans l’exemple précédent des tags, on pourrait imaginer le type de vote vote_type de la personne qui a voté sur cet article. Le vote_type peut être soit upvote, soit downvote, et il est représenté par une chaîne de caractères. La relation est entre Users et Articles.

La sauvegarde de cette association et du vote_type est réalisée en ajoutant tout d’abord des données à _joinData et en sauvegardant ensuite l’association avec link(), par exemple:

$article = $this->Articles->get($articleId);
$user = $this->Users->get($userId);

$user->_joinData = new Entity(['vote_type' => $voteType], ['markNew' => true]);
$this->Articles->Users->link($article, [$user]);

Sauvegarder des Données Supplémentaires dans la Table de Jointure¶

Dans certaines situations, vous aurez des colonnes supplémentaires dans la table de jointure de l’association BelongsToMany. Avec CakePHP, il est facile d’y sauvegarder des propriétés. Chaque entity d’une association belongsToMany a une propriété _joinData qui contient les colonnes supplémentaires de la table de jointure. Ces données peuvent être soit un tableau, soit une instance Entity. Par exemple, si les Students BelongsToMany Courses, nous pourrions avoir une table de jointure qui ressemble à ceci:

id | student_id | course_id | days_attended | grade

Lors de la sauvegarde de données, vous pouvez remplir les colonnes supplémentaires de la table de jointure en définissant les données dans la propriété _joinData:

$student->courses[0]->_joinData->grade = 80.12;
$student->courses[0]->_joinData->days_attended = 30;

$studentsTable->save($student);

La propriété _joinData peut être soit une entity, soit un tableau de données si vous sauvegardez des entities construites à partir de données de la requête. Lorsque vous sauvegardez des données de la table de jointure à partir de données de la requête, vos données POST doivent ressembler à ceci:

$data = [
    'first_name' => 'Sally',
    'last_name' => 'Parker',
    'courses' => [
        [
            'id' => 10,
            '_joinData' => [
                'grade' => 80.12,
                'days_attended' => 30
            ]
        ],
        // d'autres cours (courses).
    ]
];
$student = $this->Students->newEntity($data, [
    'associated' => ['Courses._joinData']
]);

Consultez le chapitre sur les inputs pour les données associées pour savoir comment construire correctement des inputs avec le FormHelper.

Sauvegarder les Types Complexes¶

Les tables peuvent stocker des données représentées dans des types basiques, comme des chaînes, integers, floats, booleans, etc… Mais elles peuvent aussi être étendues pour accepter des types plus complexes comme des tableaux ou des objets et sérialiser ces données en types plus simples qui peuvent être sauvegardés dans la base de données.

Pour cela, vous devez utiliser le système de types personnalisés. Consulter la section Ajouter des Types Personnalisés pour savoir comment construire des Types de colonnes personnalisés:

use Cake\Database\TypeFactory;

TypeFactory::map('json', 'Cake\Database\Type\JsonType');

// Dans src/Model/Table/UsersTable.php

class UsersTable extends Table
{

    public function initialize(): void
    {
        $this->getSchema()->setColumnType('preferences', 'json');
    }

}

Le code ci-dessus fait correspondre la colonne preferences au type personnalisé json. Cela signifie que lorsque vous récupérez des données de cette colonne, les chaînes JSON de la base de données seront désérialisées et insérées dans une entity sous forme de tableau.

De même, lors de la sauvegarde, le tableau sera à nouveau transformé au format JSON:

$user = new User([
    'preferences' => [
        'sports' => ['football', 'baseball'],
        'books' => ['Maîtriser le PHP', 'Hamlet']
    ]
]);
$usersTable->save($user);

Quand vous utilisez des types complexes, il est important de vérifier que les données que vous recevez de l’utilisateur final correspondent au bon type. Sinon, en ne traitant pas correctement les données complexes, vous vous exposez à ce que des utilisateurs malveillants puissent stocker des données qu’ils n’auraient normalement pas le droit de stocker.