Scenario: Need help? You can email me at scriptbaker@gmail.com or Skype chat Lengthy Approach: Better to follow code reuse Approach: esaverelatedbehavior developed by sluderitz for saving related models, you can download it here Table Structure: Child Model: Father Controller: Create Father Form: Child form: This solution uses esaverelatedbehavior developed by sluderitz for saving related models, you can download it hereHow to save multiple related models in Yii [Complete Solution]
Last modified
You are in a situation where you have two related tables a Parent and a child table. You need to create a user experience in which user presses Save button only once, meaning by, user enters all the data in parent model fields, then enters data in all child model fields, optionally generates more child model fields and then presses the save button.
To save multiple related models, you need to start a transaction and save child models inside loop. After saving all data of parent and all its child you commit the transaction. This technique is good but not the best, as you have to repeat this procedure every time come across saving multiple related models in your Yii application.
There are a lot of Yii extensions available out there that solves common problems. Why not use some available extension and save both time and effort? There is a good extension available that saves multiple related models for you, no need to start transactions and iterate through loops. This makes your code easy to read and also reduce redundancy.
http://www.yiiframework.com/extension/esaverelatedbehavior/
CREATE TABLE IF NOT EXISTS `fathers` (
`id` int(11) NOT NULL AUTO_INCREMENT,
`name` varchar(255) NOT NULL,
PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=latin1 AUTO_INCREMENT=1 ;
CREATE TABLE IF NOT EXISTS `children` (
`id` int(11) NOT NULL AUTO_INCREMENT,
`father_id` int(11) NOT NULL,
`name` varchar(255) NOT NULL,
`age` int(11) NOT NULL,
PRIMARY KEY (`id`),
KEY `father_id` (`father_id`)
) ENGINE=InnoDB DEFAULT CHARSET=latin1 AUTO_INCREMENT=1 ;
ALTER TABLE `children`
ADD CONSTRAINT `children_ibfk_1` FOREIGN KEY (`father_id`) REFERENCES `fathers` (`id`) ON DELETE CASCADE;
Father Model:
/**
* This is the model class for table "fathers".
*
* The followings are the available columns in table 'fathers':
* @property integer $id
* @property string $name
*
* The followings are the available model relations:
* @property Children[] $childrens
*/
class Father extends CActiveRecord
{
/**
* Returns the static model of the specified AR class.
* @param string $className active record class name.
* @return Father the static model class
*/
public static function model($className=__CLASS__)
{
return parent::model($className);
}
/**
* @return string the associated database table name
*/
public function tableName()
{
return 'fathers';
}
/**
* @return array validation rules for model attributes.
*/
public function rules()
{
// NOTE: you should only define rules for those attributes that
// will receive user inputs.
return array(
array('name', 'required'),
array('name', 'length', 'max' => 255),
// The following rule is used by search().
// Please remove those attributes that should not be searched.
array('id, name', 'safe', 'on' => 'search'),
);
}
/**
* @return array relational rules.
*/
public function relations()
{
// NOTE: you may need to adjust the relation name and the related
// class name for the relations automatically generated below.
return array(
'children' => array(self::HAS_MANY, 'Child', 'father_id'),
);
}
/**
* @return array customized attribute labels (name=>label)
*/
public function attributeLabels()
{
return array(
'id' => 'ID',
'name' => 'Name',
);
}
/**
* Retrieves a list of models based on the current search/filter conditions.
* @return CActiveDataProvider the data provider that can return the models based on the search/filter conditions.
*/
public function search()
{
// Warning: Please modify the following code to remove attributes that
// should not be searched.
$criteria = new CDbCriteria;
$criteria->compare('id', $this->id);
$criteria->compare('name', $this->name, true);
return new CActiveDataProvider($this, array(
'criteria' => $criteria,
));
}
public function behaviors()
{
return array('ESaveRelatedBehavior' => array(
'class' => 'application.components.ESaveRelatedBehavior')
);
}
}
<?php
/**
* This is the model class for table "children".
*
* The followings are the available columns in table 'children':
* @property integer $id
* @property integer $father_id
* @property string $name
* @property integer $age
*
* The followings are the available model relations:
* @property Fathers $father
*/
class Child extends CActiveRecord
{
/**
* Returns the static model of the specified AR class.
* @param string $className active record class name.
* @return Child the static model class
*/
public static function model($className=__CLASS__)
{
return parent::model($className);
}
/**
* @return string the associated database table name
*/
public function tableName()
{
return 'children';
}
/**
* @return array validation rules for model attributes.
*/
public function rules()
{
// NOTE: you should only define rules for those attributes that
// will receive user inputs.
return array(
array('father_id, name, age', 'required'),
array('father_id, age', 'numerical', 'integerOnly' => true),
array('name', 'length', 'max' => 255),
// The following rule is used by search().
// Please remove those attributes that should not be searched.
array('id, father_id, name, age', 'safe', 'on' => 'search'),
);
}
/**
* @return array relational rules.
*/
public function relations()
{
// NOTE: you may need to adjust the relation name and the related
// class name for the relations automatically generated below.
return array(
'father' => array(self::BELONGS_TO, 'Father', 'father_id'),
);
}
/**
* @return array customized attribute labels (name=>label)
*/
public function attributeLabels()
{
return array(
'id' => 'ID',
'father_id' => 'Father',
'name' => 'Name',
'age' => 'Age',
);
}
/**
* Retrieves a list of models based on the current search/filter conditions.
* @return CActiveDataProvider the data provider that can return the models based on the search/filter conditions.
*/
public function search()
{
// Warning: Please modify the following code to remove attributes that
// should not be searched.
$criteria = new CDbCriteria;
$criteria->compare('id', $this->id);
$criteria->compare('father_id', $this->father_id);
$criteria->compare('name', $this->name, true);
$criteria->compare('age', $this->age);
return new CActiveDataProvider($this, array(
'criteria' => $criteria,
));
}
}
<?php
class FatherController extends Controller
{
/**
* @var string the default layout for the views. Defaults to '//layouts/column2', meaning
* using two-column layout. See 'protected/views/layouts/column2.php'.
*/
public $layout = '//layouts/column2';
/**
* @return array action filters
*/
public function filters()
{
return array(
'accessControl', // perform access control for CRUD operations
'postOnly + delete', // we only allow deletion via POST request
);
}
/**
* Specifies the access control rules.
* This method is used by the 'accessControl' filter.
* @return array access control rules
*/
public function accessRules()
{
return array(
array('allow', // allow all users to perform 'index' and 'view' actions
'actions' => array('index', 'view'),
'users' => array('*'),
),
array('allow', // allow authenticated user to perform 'create' and 'update' actions
'actions' => array('create', 'update', 'loadChildByAjax'),
'users' => array('@'),
),
array('allow', // allow admin user to perform 'admin' and 'delete' actions
'actions' => array('admin', 'delete'),
'users' => array('admin'),
),
array('deny', // deny all users
'users' => array('*'),
),
);
}
/**
* Displays a particular model.
* @param integer $id the ID of the model to be displayed
*/
public function actionView($id)
{
$this->render('view', array(
'model' => $this->loadModel($id),
));
}
/**
* Creates a new model.
* If creation is successful, the browser will be redirected to the 'view' page.
*/
public function actionCreate()
{
$model = new Father;
// Uncomment the following line if AJAX validation is needed
$this->performAjaxValidation($model);
if (isset($_POST['Father']))
{
$model->attributes = $_POST['Father'];
if (isset($_POST['Child']))
{
$model->children = $_POST['Child'];
}
if ($model->saveWithRelated('children'))
$this->redirect(array('view', 'id' => $model->id));
else
$model->addError('children', 'Error occured while saving children.');
}
$this->render('create', array(
'model' => $model,
));
}
/**
* Updates a particular model.
* If update is successful, the browser will be redirected to the 'view' page.
* @param integer $id the ID of the model to be updated
*/
public function actionUpdate($id)
{
$model = $this->loadModel($id);
// Uncomment the following line if AJAX validation is needed
// $this->performAjaxValidation($model);
if (isset($_POST['Father']))
{
$model->attributes = $_POST['Father'];
if (isset($_POST['Child']))
{
$model->children = $_POST['Child'];
}
if ($model->saveWithRelated('children'))
$this->redirect(array('view', 'id' => $model->id));
else
$model->addError('children', 'Error occured while saving children.');
}
$this->render('update', array(
'model' => $model,
));
}
/**
* Deletes a particular model.
* If deletion is successful, the browser will be redirected to the 'admin' page.
* @param integer $id the ID of the model to be deleted
*/
public function actionDelete($id)
{
$this->loadModel($id)->delete();
// if AJAX request (triggered by deletion via admin grid view), we should not redirect the browser
if (!isset($_GET['ajax']))
$this->redirect(isset($_POST['returnUrl']) ? $_POST['returnUrl'] : array('admin'));
}
/**
* Lists all models.
*/
public function actionIndex()
{
$dataProvider = new CActiveDataProvider('Father');
$this->render('index', array(
'dataProvider' => $dataProvider,
));
}
/**
* Manages all models.
*/
public function actionAdmin()
{
$model = new Father('search');
$model->unsetAttributes(); // clear any default values
if (isset($_GET['Father']))
$model->attributes = $_GET['Father'];
$this->render('admin', array(
'model' => $model,
));
}
/**
* Returns the data model based on the primary key given in the GET variable.
* If the data model is not found, an HTTP exception will be raised.
* @param integer the ID of the model to be loaded
*/
public function loadModel($id)
{
$model = Father::model()->findByPk($id);
if ($model === null)
throw new CHttpException(404, 'The requested page does not exist.');
return $model;
}
/**
* Performs the AJAX validation.
* @param CModel the model to be validated
*/
protected function performAjaxValidation($model)
{
if (isset($_POST['ajax']) && $_POST['ajax'] === 'father-form')
{
echo CActiveForm::validate($model);
Yii::app()->end();
}
}
public function actionLoadChildByAjax($index)
{
$model = new Child;
$this->renderPartial('child/_form', array(
'model' => $model,
'index' => $index,
// 'display' => 'block',
), false, true);
}
}
<?php
/* @var $this FatherController */
/* @var $model Father */
/* @var $form CActiveForm */
?>
<div class="form">
<?php
$form = $this->beginWidget('CActiveForm', array(
'id' => 'father-form',
'focus' => array($model, 'name'),
'enableClientValidation' => true,
'enableAjaxValidation' => true,
));
?>
<p class="note">Fields with <span class="required">*</span> are required.</p>
<?php echo $form->errorSummary($model); ?>
<div class="row">
<?php echo $form->labelEx($model, 'name'); ?>
<?php echo $form->textField($model, 'name', array('size' => 60, 'maxlength' => 255)); ?>
<?php echo $form->error($model, 'name'); ?>
</div>
<?php
echo CHtml::link('Add Child', '#', array('id' => 'loadChildByAjax'));
?>
<div id="children">
<?php
$index = 0;
foreach ($model->children as $id => $child):
$this->renderPartial('child/_form', array(
'model' => $child,
'index' => $id,
'display' => 'block'
));
$index++;
endforeach;
?>
</div>
<div style="clear:both;"></div>
<div class="row buttons">
<?php echo CHtml::submitButton($model->isNewRecord ? 'Create' : 'Save'); ?>
</div>
<?php $this->endWidget(); ?>
</div><!-- form -->
<?php
Yii::app()->clientScript->registerCoreScript('jquery');
Yii::app()->clientScript->registerScript('loadchild', '
var _index = ' . $index . ';
$("#loadChildByAjax").click(function(e){
e.preventDefault();
var _url = "' . Yii::app()->controller->createUrl("loadChildByAjax", array("load_for" => $this->action->id)) . '&index="+_index;
$.ajax({
url: _url,
success:function(response){
$("#children").append(response);
$("#children .crow").last().animate({
opacity : 1,
left: "+50",
height: "toggle"
});
}
});
_index++;
});
', CClientScript::POS_END);
?>
views\father\child\_form.php
<div style="margin-bottom: 20px; display: <?php echo!empty($display) ? $display : 'none'; ?>; width:100%; clear:left;" class="crow">
<div class="row" style="width:200px;float: left;">
<?php echo CHtml::activeLabelEx($model, '[' . $index . ']name'); ?>
<?php echo CHtml::activeTextField($model, '[' . $index . ']name', array('size' => 20, 'maxlength' => 255)); ?>
<?php echo CHtml::error($model, '[' . $index . ']name'); ?>
</div>
<div class="row" style="width:200px;float: left;">
<?php echo CHtml::activeLabelEx($model, '[' . $index . ']age'); ?>
<?php echo CHtml::activeTextField($model, '[' . $index . ']age'); ?>
<?php echo CHtml::error($model, '[' . $index . ']age'); ?>
</div>
<div class="row" style="width:100px;float: left;">
<br />
<?php echo CHtml::link('Delete', '#', array('onclick' => 'deleteChild(this, ' . $index . '); return false;'));
?>
</div>
</div>
<?php
Yii::app()->clientScript->registerScript('deleteChild', "
function deleteChild(elm, index)
{
element=$(elm).parent().parent();
/* animate div */
$(element).animate(
{
opacity: 0.25,
left: '+=50',
height: 'toggle'
}, 500,
function() {
/* remove div */
$(element).remove();
});
}", CClientScript::POS_END);
http://www.yiiframework.com/extension/esaverelatedbehavior/
5 min read