CakePHP делает сохранение данных модели в один щелчок. Данные, готовые к сохранению, должны быть переданы в метод save(), используя базовый формат:
Array
(
[ModelName] => Array
(
[fieldname1] => 'value'
[fieldname2] => 'value'
)
)
В большинстве случаев вам даже не надо будет беспокоится о формате: хелперы HtmlHelper, FormHelper, и find-методы все пакуют данные в этот формат. Если вы используете любой из хелперов, данные также удобно доступны в $this->data для быстрого использования.
Здесь пример действия контроллера, который использует модель CakePHP для сохранения данных в таблицу базы данных:
<?
function edit($id) {
//Есть ли данные из формы для сохранения?
if(!empty($this->data)) {
//Если данные из формы прошли валидацию и сохранены ...
if($this->Recipe->save($this->data)) {
//Вывести flash-сообщение и перенаправить в '/recipes'.
$this->Session->setFlash("Рецепт сохранен!");
$this->redirect('/recipes');
}
}
//Если нет данных из формы, то найти рецепт для редактирования
//и передать его в отображение.
$this->set('recipe', $this->Recipe->findById($id));
}
?>
Одно дополнительно замечание: когда save() вызван, то данные, переданные в него первым параметром, проходят проверку через механизм валидации CakePHP (смотрите главу «Валидация данных»). Если по каким-то причинам ваши данные не сохраняются, то убедитесь не нарушаются ли правила валидации.
В модели есть несколько методов, касающихся сохранения данных:
Этот метод сохраняет данные из массивов. Второй параметр позволяет вам отклонить валидацию, и с помощью третьего параметра вы можете передать перечень полей модели для сохранения. Для дополнительной безопасности вы можете ограничить сохраняемые поля в этом списке $fieldList.
Метод save также имеет альтернативный синтаксис:
Массив $params может иметь любые, из следующих опций, в качестве индекса массива:
<?
array(
'validate' => true,
'fieldList' => array(),
'callbacks' => true //other possible values are false, 'before', 'after'
)
?>
Дополнительная информация о колбэках модели доступна здесь.
После того, как сохранение завершено, ID для объекта может быть найдено в переменной $id объекта модели – это особенно удобно, когда создаете новые объекты.
<?
$this->Ingredient->save($newData);
$newIngredientId = $this->Ingredient->id;
?>
Этот метод возвращает модель в исходное состояние для сохранения новой информации.
Если параметр $data (используя формат массива, приведенный выше) передан, экземпляр модели будет готов сохранить с этим данные (доступные через $this->data).
Используется для сохранения значений отдельных полей. Просто установите ID ($this->ModelName->id = $id) перед вызовом saveField(). Когда используете этот метод, то $fieldName должно содержать только имя поля, а не имя модели и поля.
Например, для обновления заголовка поста блога, вызов saveField из контроллера может выглядить так:
<? this->Post->saveField('title', 'A New Title for a New Day'); ?>
Обновляет много записей за один вызов. Записи, которые следует обновить определяются массивом $conditions, а поля для обновления, вместе с их значениями, – массивом $fields .
Например, для поощрения всех пекарей, которые работают больше года, update-вызов может выглядеть так:
<?
$this_year = date('Y-m-d h:i:s', strtotime('-1 year'));
$this->Baker->updateAll(
array('Baker.approved' => true),
array('Baker.created <=' => "$this_year")
);
?>
Например, для бронирования всех билетов для конкретного заказчика можно написать такой код:
<?
$this->Ticket->updateAll(
array('Ticket.status' => "'closed'"),
array('Ticket.customer_id' => 453)
);
?>
Исользуется для сохранения
– многочисленных записей для одной модели
– текущей записи со всеми ассоциированными записями
Следующие опции могут быть использованы:
validate: Установите в false для отключения проверки валидности, true – для проверки валидности каждой записи перед сохранением, 'first' – для проверки *all* записей перед началом сохранения, или 'only' – только для проверки, но без их последующего сохранения.
atomic: Если true (по умолчанию), то попытается сохранить все записи в одной транзакции. Должен быть установлен в false, если база данных/таблица не поддерживает транзакции. Если false, то будет возвращен массив, похожий на переданный массив $data, но значения будут установлены в true/false, в зависимости от того успешно была сохранена данная запись или нет.
fieldList: Эквивалент параметра $fieldList в Model::save()
Для сохранения множества записей одной модели, $data должен быть численно проиндексирован:
Array
(
[0] => Array
(
[title] => title 1
)
[1] => Array
(
[title] => title 2
)
)
Команда для сохранения данных, приведенных выше, будет выглядеть так:
<? $this->Article->saveAll($data['Article']); ?>
Для сохранения записи вместе со связанной записью, имеющей ассоциации hasOne или belongsTo, массив данных должен выглядеть так:
Array
(
[User] => Array
(
[username] => billy
)
[Profile] => Array
(
[sex] => Male
[occupation] => Programmer
)
)
Команда для сохранения этих данных будет выглядеть так:
<? $this->Article->saveAll($data); ?>
Для сохранения записи вместе с связанными записями, имеющих hasMany ассоциацию, массив данных должен выглядеть так:
Array
(
[Article] => Array
(
[title] => My first article
)
[Comment] => Array
(
[0] => Array
(
[comment] => Comment 1
[user_id] => 1
)
[1] => Array
(
[comment] => Comment 2
[user_id] => 2
)
)
)
Команда для сохранения этого массива $data будет выглядеть так:
<? $this->Article->saveAll($data); ?>
Когда работаете с ассоциированными моделями, то важно осознавать, что сохранение данных модели должно быть сделано соответствующей моделью. Если вы сохраняете новый пост (Post) и ассоциированные ему комментарии (Comments), то вы будете использовать обе модели Post и Comment.
Если ни одна запись ассоциированных моделей еще не существует (например, вы хотите сохранить нового пользователя (User) и его записи профиля (Profile) в одно и то же время), то вам надо сначала сохранить первичную, или родительскую модель.
Для того, чтобы представить, как это работает, предположим, что у нас есть действие в нашем UsersController, которое управляет сохранением нового пользователя (User) и относящегося к нему профиля (Profile). Пример действия, представленный ниже, предполагает, что вы внесли достаточно данных (используюя FormHelper) для создания пользователя и профиля.
<?php
function add() {
if (!empty($this->data)) {
// Мы можем сохранить данные о пользователе:
// они будут в $this->data['User']
$user = $this->User->save($this->data);
// Если пользователь был сохранен, то мы добавляем эту информацию
// в данные и сохраняем профиль.
if (!empty($user)) {
// ID только что созданного пользователя хранится
// в $this->User->id.
$this->data['Profile']['user_id'] = $this->User->id;
// Поскольку наш пользователь имеет один (hasOne) профиль , то
// у нас есть доступ к модели Profile через модель User:
$this->User->Profile->save($this->data);
}
}
}
?>
Основная идея при сохранении данных ассоциированных моделей заключается в том, чтобы получить значение первичного ключа одной модели и поместить его в качестве значения вторичного (внешнего) ключа в другую модель. Иногда, это включает использование переменной модели $id после save(). В других случаях можно получить ID из скрытого инпута в форме, значение которого передается в действие контроллера.
В дополнение к базовому подходу CakePHP также предлагает очень удобный метод saveAll(), который позволяет вам проверить валидность и сохранить множество моделей за раз. Также, saveAll() поддерживает транзакции для обеспечения целостности данных в
вашей БД (например, если одна модель не сохранилась, то другие модели тоже не будут сохраняться.)
Для того, чтобы транзакции корректно работали в MySQL, ваши таблицы должны использовать механизм InnoDB.
Помните, что MyISAM таблицы не поддерживают транзакции.
Давайте посмотрим, как мы можем использовать saveAll() для сохранения моделей Company и Account одновременно.
Во-первых, вам необходимо создать формы для этих моделей (мы предполагаем, что Company hasMany Account).
<?
echo $form->create('Company', array('action'=>'add'));
echo $form->input('Company.name', array('label'=>'Имя компании'));
echo $form->input('Company.description');
echo $form->input('Company.location');
echo $form->input('Account.0.name', array('label'=>'Имя счета'));
echo $form->input('Account.0.username');
echo $form->input('Account.0.email');
echo $form->end('Add');
?>
Обратите внимание на способ названия полей формы для модели Account. Если Company – это наша главная модель, то saveAll() будет ожидать данные связанной модели в особом формате. И Account.0.fieldName – это то, что нужно.
Именование полей, приведенное выше, требуется для ассоциаций hasMany.
Если ассоциация между моделями - hasOne, то вы должны использовать нотацию ModelName.fieldName для этих моделей.
Теперь в нашем файле companies_controller мы можем создать действие add():
<?
function add() {
if(!empty($this->data)) {
$this->Company->saveAll($this->data, array('validate'=>'first'));
}
}
?>
Это все. Теперь наши модели Company и Account будут проверены на валидность данных и одновременно сохранены. Опция array('validate'=>'first') гарантирует, что обе модели проверены на валидность перед началом сохранения.
Эта функция помогает вам кэшировать count связанных данных. Вместо подсчета количества записей вручную с помощью find('count'), модель сама отслеживает все вставки/удаления в ассоциированной через $hasMany модели и увеличивает/уменьшает значение специально выделенного поля типа integer.
Название поля состоит из имени модели в единственном числе, символа подчеркивания и слова “count”.
Допустим, у вас есть модель ImageAlbum и модель Image, тогда вам надо добавить INT-поле в таблицу “image_album” и назвать его “image_count”. Или, если ваши имена более сложные, тогда – другой пример: модели BlogEntry и BlogEntryComment, имя поля будет “blog_entry_comment_count” и должно быть добавлено в таблицу “blog_entries”.
После того, как вы добавили поле для подсчета записей, вы можете активировать эту функциональность, добавив индекс “counterCache” в ассоциативный массив "$belongsTo”, и присвоив ему значение “true”.
<?
class ImageAlbum extends AppModel {
var $hasMany = array(
'Image'
);
}
class Image extends AppModel {
var $belongsTo = array(
'ImageAlbum' => array('counterCache' => true)
);
}
?>
Теперь каждый раз, когда вы будете добавлять новое изображение Image в ImageAlbum число “image_count” будет увеличиваться (или уменьшаться, если вы делаете удаление).
Сохранить модели, которые ассоциированы с помощью hasOne, belongsTo, и hasMany довольно просто: вы просто заполняете значение внешнего ключа значением ID ассоциированной модели и вызываете метод модели save(), и все корректно связывается.
Когда же используете ассоциацию HABTM, то необходимо установить ID ассоциированной модели в массив данных. Мы создадим форму, которая создает новый тег и ассоциирует его с некоторым рецептом..
Самая простая форма может выглядеть так (мы предполагаем, что $recipe_id уже имеет какое-то значение):
<?
<?php echo $form->create('Tag');?>
<?php echo $form->input(
'Recipe.id',
array('type'=>'hidden', 'value' => $recipe_id)); ?>
<?php echo $form->input('Tag.name'); ?>
<?php echo $form->end('Add Tag'); ?>
?>
В этом примере вы можете увидеть скрытое поле Recipe.id, значение которого равно ID рецепта, с которым мы хотим связать тег.
Когда метод save() будет вызван из контроллера, то он автоматически сохранит данные HABTM в базу данных.
<?
function add() {
//Сохранение ассоциации
if ($this->Tag->save($this->data)) {
//действия в случае успешного сохранения
}
}
?>
В предыдущем коде наш новый Tag создан и ассоциирован с рецептом Recipe, ID которого находится в $this->data['Recipe']['id'].
В других случаях, для отображения наших ассоциированных данных мы можем применить выпадающий список. Данные могут быть извлечены из модели с помощью метода find('list') и переданы в переменную отображения. Input с таким же именем автоматически поместит данные в <select>.
<?
// в контроллере:
$this->set('tags', $this->Recipe->Tag->find('list'));
// в отображении:
$form->input('tags');
?>
Более желательный вариант со связью HABTM будет включать <select>, позволяющий делать множественный выбор. Например, рецепт может иметь много тегов. В этом случае данные из модели извлекаются тем же путем, но форма input определяется по другому. Имя тега записывается в виде ModelName.ModelName.
<?
// в контроллере:
$this->set('tags', $this->Recipe->Tag->find('list'));
// в отображении:
$form->input('Tag.Tag');
?>
Используя код выше, можно создать множественные выпадающие списки, значения которых будут автоматически сохранены в модель Recipe, при добавлении или сохранении записей в базу данных.
<< Получение данных | Удаление данных >>