Yii многостраничный мастер формы лучшие практики

Question

Я пытаюсь создать многостраничную форму с помощью Yii, но я довольно новичок в PHP и Yii и мне интересно, как лучше всего написать многостраничную форму. Пока что я планирую добавить скрытое поле с именем «step», которое содержит текущий шаг, на котором находится пользователь в форме (форма разбита на 3 шага / страницы). Итак, помня об этом, я планирую обрабатывать нажатия пользователем кнопок «предыдущий / следующий» в контроллере:

public function actionCreate()
 {
  $userModel = new User;

  $data['activityModel'] = $activityModel; 
  $data['userModel'] = $userModel; 

  if (!empty($_POST['step']))
  {
   switch $_POST['step']:
    case '1':
     $this->render('create_step1', $data);
     break;

    case '2':
     $this->render('create_step2', $data);
     break;

  }else
  {
   $this->render('create_step1', $data);
  }
 }

Имеет ли этот подход смысл? Или я далеко от базы, и есть гораздо лучший и более оптимизированный способ сделать это в Yii / PHP?

Спасибо!

Answer 1

Есть несколько способов подойти к этому. Я вижу, что вы размещены на форуме Yii, поэтому я предполагаю, что вы тоже искали там, но если вы этого не сделали:

• http://www.yiiframework.com/forum/index.php?/topic/6203-stateful-forms-and-wizards-howto/
• http://www.yiiframework.com/forum/index.php?/topic/8413-wizard-forms/

Что я сделал (просто для простой двухэтапной формы ActiveRecord), выполнил одно действие и разделил его на условные блоки, основанные на имени кнопки, которые Yii POST при отправке формы (примечание: не работает с ajax отправляет). Затем, в зависимости от того, какая кнопка была нажата, я отображаю правильную форму и устанавливаю правильный сценарий на моей модели для проверки.

Скрытое поле "шаг", как у вас, может служить той же цели, что и проверка имени submitButton. Возможно, я бы сохранил «шаг» в состояние формы вместо добавления скрытого поля, но все было бы хорошо.

Некоторые люди используют атрибут activeful activeForm для сохранения данных из одного шага в мастере, или вы можете использовать сеанс или даже сохранить во временной таблице базы данных. В моем полностью непроверенном примере ниже я использую функциональность с сохранением формы.

Вот пример того, что я в основном сделал для формы ActiveRecord. Это идет в "actionCreate":

<?php if (isset($_POST['cancel'])) {
  $this->redirect(array('home'));
} elseif (isset($_POST['step2'])) {
  $this->setPageState('step1',$_POST['Model']); // save step1 into form state
  $model=new Model('step1');
  $model->attributes = $_POST['Model'];
  if($model->validate())
    $this->render('form2',array('model'=>$model));
  else {
    $this->render('form1',array('model'=>$model));
  }
} elseif (isset($_POST['finish'])) {
  $model=new Model('finish');
  $model->attributes = $this->getPageState('step1',array()); //get the info from step 1
  $model->attributes = $_POST['Model']; // then the info from step2
  if ($model->save())
    $this->redirect(array('home'));
  else {
    $this->render('form2',array('model'=>$model));
} else { // this is the default, first time (step1)
  $model=new Model('new');
  $this->render('form1',array('model'=>$model));
} ?>

Формы будут выглядеть примерно так:

Form1:

<?php $form=$this->beginWidget('CActiveForm', array(
    'enableAjaxValidation'=>false,
    'id'=>'model-form',
    'stateful'=>true,
));
<!-- form1 fields go here -->
echo CHtml::submitButton("Cancel",array('name'=>'cancel');
echo CHtml::submitButton("On to Step 2 >",array('name'=>'step2');
$this->endWidget(); ?>

Форма 2:

<?php $form=$this->beginWidget('CActiveForm', array(
    'enableAjaxValidation'=>false,
    'id'=>'model-form',
    'stateful'=>true,
));
<!-- form2 fields go here -->
echo CHtml::submitButton("Back to Step 1",array('name'=>'step1');
echo CHtml::submitButton("Finish",array('name'=>'finish');
$this->endWidget(); ?>

Надеюсь, это полезно!

Answer 2

Yii предоставляет функцию, называемую состояниями страницы, для реализации таких вещей, как мастер многоэтапной / многостраничной формы.

Давайте сначала посмотрим на документы Yii:

СтраницаСостояние - это переменная, которая является постоянной в запросах POST той же страницы.Чтобы использовать постоянные состояния страницы, формы должны быть с состоянием, которые генерируются с помощью {@link CHtml :: statefulForm}.

Таким образом, формы каждого шага / страницы должны быть с состояниемформы.Чтобы отобразить форму с сохранением состояния, вам просто нужно установить свойство CActiveForm::stateful в true при запуске виджета ActiveForm.В вашем контроллере вы можете получить и установить состояния вашей страницы с помощью CController::getPageState() или CController::setPageState().

Так что это основные принципы, которые работают достаточно хорошо, если реализация вашего мастера создания многостраничных форм выполнена в традиционном стилебез запросов AJAX.

Если, однако, вы хотите использовать вызовы AJAX для отправки данных шага и отображения следующего шага, состояния страниц Yii не будут использоваться.

Почему?Все состояния страницы передаются через HTTP-POST в скрытом поле ввода.Поле ввода заполняется Yii во время так называемой обработки вывода.Обработка вывода начинается после рендеринга и заменяет части вывода.Так что Функция состояний страниц Yii требует обработки вывода .Ответы AJAX, с другой стороны, могут быть искажены из-за того, что обработка вывода также может добавлять теги <link> или <script> в начале вывода для загрузки требуемых файлов JS и CSS.

В конце Iреализовал мою собственную версию форм с сохранением состояния.Я могу получать данные с состоянием с помощью статического вызова функции ActiveFormWidget::getRequestMultiStepData() каждый раз, когда мне это нужно.

Примечание: в моей реализации есть один недостаток: все данные с состоянием должны быть собраны до того, как виджет формы будетбыть инициализирован.Но у меня никогда не было проблем с этим до сих пор.Однако вот код:

class ActiveFormWidget extends CActiveForm
{
    public static $inputNameMultiStepData = '_multiStepData';

    public $multiStep = false;
    public $multiStepData = array();

    public function init()
    {
        parent::init();

        # Hidden-Fields
        if ($this->multiStep) {
            echo Html::hiddenField(static::$inputNameMultiStepData, static::encodeInputData($this->multiStepData));
        }
    }

    /**
     * Gets all multi step data sent.
     * @return array|mixed
     */
    public static function getRequestMultiStepData()
    {
        return isset($_REQUEST[static::$inputNameMultiStepData]) ? static::decodeInputData($_REQUEST[static::$inputNameMultiStepData]) : array();
    }


    /**
     * Encodes form data like Yii does for stateful forms.
     * @param $data
     * @return string
     */
    public static function encodeInputData($data)
    {
        $data = Yii::app()->getSecurityManager()->hashData(serialize($data));

        return base64_encode($data);
    }

    /**
     * Decodes form data like Yii does for stateful forms.
     * @param $data
     * @return bool|mixed
     */
    public static function decodeInputData($data)
    {
        $data = base64_decode($data);
        $data = Yii::app()->getSecurityManager()->validateData($data);
        if ($data !== false) {
            return unserialize($data);
        } else {
            return false;
        }
    }
}