多模型的复合表单

当需要处理复杂数据，很可能你需要使用多个不同的模型来收集用户提交的数据。
举例来说，假设用户登录信息保存在 user 表，但是用户基本信息保存在 profile 表，
你可能需要同时使用 User 模型和 Profile 模型来获取用户登录信息和基本信息。
使用 Yii 提供的模型和表单支持，解决这样的问题和处理单一模型并不会有太大的区别。

下面，我们将为你展示怎样创建一个表单并同时处理 User 和 Profile 这两个模型。

首先，控制器中收集用户提交数据的动作(action)可以按照下面写的这样，

  1. namespace app\controllers;
  3. use Yii;
  4. use yii\base\Model;
  5. use yii\web\Controller;
  6. use yii\web\NotFoundHttpException;
  7. use app\models\User;
  8. use app\models\Profile;
  10. class UserController extends Controller
  11. {
  12.     public function actionUpdate($id)
  13.     {
  14.         $user = User::findOne($id);
  15.         if (!$user) {
  16.             throw new NotFoundHttpException("没有找到用户登录信息。");
  17.         }
  19.         $profile = Profile::findOne($user->profile_id);
  21.         if (!$profile) {
  22.             throw new NotFoundHttpException("没有找到用户基本信息。");
  23.         }
  25.         $user->scenario = 'update';
  26.         $profile->scenario = 'update';
  28.         if ($user->load(Yii::$app->request->post()) && $profile->load(Yii::$app->request->post())) {
  29.             $isValid = $user->validate();
  30.             $isValid = $profile->validate() && $isValid;
  31.             if ($isValid) {
  32.                 $user->save(false);
  33.                 $profile->save(false);
  34.                 return $this->redirect(['user/view', 'id' => $id]);
  35.             }
  36.         }
  38.         return $this->render('update', [
  39.             'user' => $user,
  40.             'profile' => $profile,
  41.         ]);
  42.     }
  43. }

在 update 动作中，我们首先从数据库中获取需要更新的 $user 和 $profile 这两个模型。
我们可以调用 [[yii\base\Model::load()]] 方法把用户提交数据填充到两个模型中。
如果加载成功，验证两个表单并保存 — 请注意我们使用了 save(false) 方法用来忽略内部保存时的二次验证，
因为用户输入的数据已经手动验证过了。
如果填充数据失败，直接显示下面的 update 视图内容：

  1. <?php
  2. use yii\helpers\Html;
  3. use yii\widgets\ActiveForm;
  5. $form = ActiveForm::begin([
  6.     'id' => 'user-update-form',
  7.     'options' => ['class' => 'form-horizontal'],
  8. ]) ?>
  9.     <?= $form->field($user, 'username') ?>
  11.     ...other input fields...
  13.     <?= $form->field($profile, 'website') ?>
  15.     <?= Html::submitButton('更新数据', ['class' => 'btn btn-primary']) ?>
  16. <?php ActiveForm::end() ?>

你可以看到，在 update 视图中，我们同时显示了两个模型 $user 和 $profile 的属性的输入栏。