Одной из самых мощных особенностей CakePHP является способность создавать реляционные связи, предоставляемая моделью. В CakePHP, связи между моделями осуществляются с помощью ассоциаций.
Определение связей между различными объектами в вашем приложении должно быть естественным процессом. Например: рецепт может иметь много оценок, оценки принадлежат (поставлены) авторами, и авторы могут иметь много рецептов. Определив каким образом эти связи будут работать, вы легко сможете получить доступ к вашим данным.
Цель этого раздела – показать как определять и использовать ассоциации между моделями в CakePHP.
Данные могут получаться из разных источников. Наиболее распространенная форма хранения в веб-приложениях – это реляционная база данных. Об этом и пойдет речь в этом разделе.
В CakePHP существует четыре типа ассоциаций: hasOne, hasMany, belongsTo, hasAndBelongsToMany (HABTM).
| Связь | Тип ассоциации | Пример |
| один к одному | hasOne | Пользователь имеет один профиль |
| один ко многим | hasMany | Пользователь имеет много рецептов |
| многие к одному | belongsTo | Рецепты принадлежат пользователю |
| многие ко многим | hasAndBelongsToMany | Рецепты имеют и принадлежат множеству тегов |
Ассоциации определяются созданием переменной класса, имя которой совпадает с названием, определяемой вами, ассоциации. Эта переменная может быть простой, как строка, а может быть сложной, как многомерный массив, используемый для определения особенностей ассоциации.
<?php
class User extends AppModel {
var $name = 'User';
var $hasOne = 'Profile';
var $hasMany = array(
'Recipe' => array(
'className' => 'Recipe',
'conditions' => array('Recipe.approved' => '1'),
'order' => 'Recipe.created DESC'
)
);
}
?>
В приведенном примере в строке 'className' => 'Recipe', 'Recipe' – это алиас. Это идентификатор для связи и может быть любым. Обычно, вы будете выбирать такое же имя, которое имеет класс, на который ссылается данный класс. Алиасы должны быть уникальными как для отдельных моделей, так и с двух сторон связей belongsTo/hasMany или belongTo/hasOne. Выбор не уникальных имен для алиасов моделей, может стать причиной непредсказуемого поведения.
CakePHP будет автоматически создавать связи между ассоциируемыми объектами моделей. Таким образом, например, в вашей модели User вы можете получить доступ к модели Recipe:
<? $this->Recipe->someFunction(); ?>
Подобным образом, в вашем контроллере вы можете получить доступ к ассоциируемым моделям, без добавления их в массив $uses:
<? $this->User->Recipe->someFunction(); ?>
Помните, что ассоциации, определяются в одну сторону. Если вы определили User hasMany Recipe,
то это ничего не дает модели Recipe. Вам необходимо определить Recipe belongsTo User для того,
чтобы можно было обращаться к модели User из модели Recipe.
Давайте создадим hasOne ассоциацию модели User с моделью Profile.
Во-первых, ваши таблицы БД должны иметь корректные ключи. Для того, чтобы связь hasOne работала, одна таблица должна содержать внешний (вторичный) ключ, который указывает на запись другой таблицы. В данном случае таблица profiles будет содержать поле с именем user_id.
hasOne: другая модель содержит внешний ключ.
| Связь | Схема данных |
| Apple hasOne Banana | bananas.apple_id |
| User hasOne Profile | profiles.user_id |
| Doctor hasOne Mentor | mentors.doctor_id |
Файл модели User будет сохранен в /app/models/user.php. Для определения ассоциации 'User hasOne Profile', добавьте свойство $hasOne в класс модели. Не забудьте создать модель Profile в /app/models/profile.php, иначе ассоциация не будет работать.
<?php
class User extends AppModel {
var $name = 'User';
var $hasOne = 'Profile';
}
?>
Существует два способа для описания этой связи в вашем файле модели. Самый простой – это присвоить переменной $hasOne строку, содержащую имя класса ассоциируемой модели (как мы сделали выше).
Если вам надо больше управления, то вы можете определить вашу ассоциацию, используя синтаксис массива. Например, вы можете захотеть ограничить ассоциацию, включая, только определенные записи.
<?php
class User extends AppModel {
var $name = 'User';
var $hasOne = array(
'Profile' => array(
'className' => 'Profile',
'conditions' => array('Profile.published' => '1'),
'dependent' => true
)
);
}
?>
Возможные индексы для hasOne ассоциации:
После того, как эта ассоциация определена, find методы модели User будут также выбирать данные ассоциированной модели Profile, если они существуют:
//Образец результатов после вызова $this->User->find().
Array
(
[User] => Array
(
[id] => 121
[name] => Gwoo the Kungwoo
[created] => 2007-05-01 10:31:01
)
[Profile] => Array
(
[id] => 12
[user_id] => 121
[skill] => Baking Cakes
[created] => 2007-05-01 10:31:01
)
)
Теперь у нас есть доступ к модели Profile из модели User, давайте определим ассоциацию belongsTo в модели Profile для того, чтобы получить доступ к данным модели User. Ассоциация belongsTo – естественное дополнение к hasOne и hasMany: она позволяет нам видеть данные в обратном направлении.
При создании ключей таблиц БД для ассоциации belongsTo следуйте следующему соглашению:
| Связь | Схема данных |
| Banana belongsTo Apple | bananas.apple_id |
| Profile belongsTo User | profiles.user_id |
| Mentor belongsTo Doctor | mentors.doctor_id |
Если модель (таблица) содержит внешний ключ, то она belongsTo другой модели (таблице).
Мы можем определить belongsTo ассоциацию в нашей модели Profile в /app/models/profile.php, используя строковый синтаксис:
<?php
class Profile extends AppModel {
var $name = 'Profile';
var $belongsTo = 'User';
}
?>
Мы так же можем определить и более специфическую связь, используя синтаксис массива:
<?php
class Profile extends AppModel {
var $name = 'Profile';
var $belongsTo = array(
'User' => array(
'className' => 'User',
'foreignKey' => 'user_id'
)
);
}
?>
Возможные индексы для массивов belongsTo ассоциации:
После того, как данная ассоциация определена, find операции модели Profile будут также выбирать данные из модели User, если таковые имеются:
//Образец результатов после вызова $this->Profile->find().
Array
(
[Profile] => Array
(
[id] => 12
[user_id] => 121
[skill] => Baking Cakes
[created] => 2007-05-01 10:31:01
)
[User] => Array
(
[id] => 121
[name] => Gwoo the Kungwoo
[created] => 2007-05-01 10:31:01
)
)
Следующий шаг: определение ассоциации “User hasMany Comment”. Ассоциация hasMany позволит нам получать все комментарии пользователя, когда мы выбираем этого пользователя.
При создании ключей таблиц БД для ассоциации hasMany следуйте следующему соглашению:
| Связь | Схема данных |
| User hasMany Comment | Comment.user_id |
| Cake hasMany Virtue | Virtue.cake_id |
| Product hasMany Option | Option.product_id |
Мы можем определить ассоциацию hasMany в нашей модели User в /app/models/user.php, используя строковый синтаксис:
<?php
class User extends AppModel {
var $name = 'User';
var $hasMany = 'Comment';
}
?>
Мы так же можем определить и более специфическую связь, используя синтаксис массива:
<?php
class User extends AppModel {
var $name = 'User';
var $hasMany = array(
'Comment' => array(
'className' => 'Comment',
'foreignKey' => 'user_id',
'conditions' => array('Comment.status' => '1'),
'order' => 'Comment.created DESC',
'limit' => '5',
'dependent'=> true
)
);
}
?>
Возможные индексы для массивов hasMany ассоциации:
Второй параметр метода Model->delete() должен быть установлен в true
для включения рекурсивного удаления.
Когда данная ассоциация определена, то find операции в модели User будут также выбирать записи связанной модели Comment, если таковые имеются:
//Образец результата после вызова $this->User->find().
Array
(
[User] => Array
(
[id] => 121
[name] => Gwoo the Kungwoo
[created] => 2007-05-01 10:31:01
)
[Comment] => Array
(
[0] => Array
(
[id] => 123
[user_id] => 121
[title] => On Gwoo the Kungwoo
[body] => The Kungwooness is not so Gwooish
[created] => 2006-05-01 10:31:01
)
[1] => Array
(
[id] => 123
[user_id] => 121
[title] => More on Gwoo
[body] => But what of the ‘Nut?
[created] => 2006-05-01 10:41:01
)
)
)
Помните, что вам надо определить ассоциацию 'Comment belongsTo User' для того, чтобы получать данные в обоих направлениях.
На данный момент вы можете называть себя профессионалом ассоциирования моделей в CakePHP. Вы уже хорошо разбираетесь в трех видах ассоциаций, который охватывают основную массу отношений объектов.
Давайте рассмотрим последний тип отношений: hasAndBelongsToMany, или HABTM. Эта ассоциация используется, когда у вас есть две модели, которые должны быть связаны многократно, множеством различных способов.
Главное отличие между hasMany и HABTM – это то, что связь между моделями не исключающая. Например, мы соединяем нашу модель Recipe с моделью Tag, используя HABTM. Прикрепление тега «украинский» к бабушкиному рецепту борща, не «израсходует» этот тег. При необходимости, я могу прикрепить этот тег и к другим рецептам.
Связи между объектами, ассоциированными через hasMany, – исключающие. Если User hasMany Comments, то комментарии принадлежит только определенному пользователю и не может быть привязан к другому.
Идем дальше. Нам необходимо создать дополнительную таблицу в базе данных, для управления HABTM ассоциацией. Имя этой новой соединяющей таблицы должно состоять из имен двух используемых моделей (в алфавитном порядке), разделенных символом подчеркивания ( _ ). Таблица должна содержать два поля, внешние ключи (типа integer), указывающие на первичные ключи, используемых моделей. Чтобы избежать конфликтных ситуаций – не определяйте комбинированные первичные ключи для этих двух полей. Если это, все же, необходимо, то вы можете определить уникальный индекс. Если вы планируете добавить другую дополнительную информацию в эту таблицу, то добавьте поле с первичным ключом (по соглашению 'id'), чтобы вы могли работать с этой таблицей также легко, как с другими моделями.
HABTM требует отдельную связывающую таблицу, которая содержит имена обоих моделей.
| Связь | Схема данных |
| Recipe HABTM Tag | id, recipes_tags.recipe_id, recipes_tags.tag_id |
| Cake HABTM Fan | id, cakes_fans.cake_id, cakes_fans.fan_id |
| Foo HABTM Bar | id, bars_foos.foo_id, bars_foos.bar_id |
Имя таблицы, по соглашению, в алфавитном порядке.
После того, как эта новая таблица создана, мы можем определить HABTM ассоциацию в файлах моделей. В этот раз мы пропустим строковый синтаксис и перейдем сразу к определению ассоциации с помощью массива:
<?php
class Recipe extends AppModel {
var $name = 'Recipe';
var $hasAndBelongsToMany = array(
'Tag' =>
array(
'className' => 'Tag',
'joinTable' => 'recipes_tags',
'with' => '',
'foreignKey' => 'recipe_id',
'associationForeignKey' => 'tag_id',
'unique' => true,
'conditions' => '',
'fields' => '',
'order' => '',
'limit' => '',
'offset' => '',
'finderQuery' => '',
'deleteQuery' => '',
'insertQuery' => ''
)
);
}
?>