创建表单

17 Mar 2025 | 阅读 2 分钟

我们将创建一个表单来从用户那里获取数据。

在我们的表单中，我们将为姓名、联系方式、课程和电子邮件创建四个输入字段。页面会将输入的值显示回来。

步骤 1 创建模型文件 UserForm.php

在这里，我们将创建一个模型文件来从用户那里请求数据，位于 models/UserForm.php。

<?php 

	namespace frontend\models; 

	use Yii; 
	use yii\base\Model; 

	class UserForm extends Model 
	{ 
    	public $name; 
    	public $contact; 
    	public $course; 
    	public $email; 

    	public function rules() 
    	{ 
        	return [ 
            	[['name', 'contact', 'course', 'email'], 'required'], 
            	['email', 'email'], 
       	]; 
    	} 
	} 

查看上面的代码，函数 rules() 设置为验证来自用户的数据。

步骤 2 创建 Action

在 controllers/SiteController.php 中，我们将创建一个 action user。

<?php 
	namespace frontend\controllers; 

	use Yii; 
	use yii\base\InvalidParamException; 
	use yii\web\BadRequestHttpException; 
	use yii\web\Controller; 
	use yii\filters\VerbFilter; 
	use yii\filters\AccessControl; 
	use common\models\LoginForm; 
	use frontend\models\PasswordResetRequestForm; 
	use frontend\models\ResetPasswordForm; 
	use frontend\models\SignupForm; 
	use frontend\models\ContactForm; 
	use frontend\models\UserForm; 
	/** 
 	* Site controller 
 	*/ 
	class SiteController extends Controller 
	{ 
    	/** 
     	* @inheritdoc 
     	*/ 
	public function actionUser() 
    	{ 
        	$model = new UserForm(); 

        	if ($model->load(Yii::$app->request->post()) && $model->validate()) { 
            	// valid data received in $model 

            	// do something meaningful here about $model ... 

            	return $this->render('user-confirm', ['model' => $model]); 
        	} else { 
            	// either the page is initially displayed or there is some validation error 
            	return $this->render('user', ['model' => $model]); 
        	} 
    	} 

查看上面的代码，action 从用户提供的 $_POST 方法接收数据。 action validate() 将确保输入的数据有效。

如果数据有效，则 action 将渲染到视图页面 user-confirm 以确认提交。否则，它将转到 else 部分，声明验证错误。

步骤 3 创建视图

将在视图目录中创建两个文件。

一个是 user-confirm.php 文件，位于 views/site/user-confirm.php。

<?php 
	use yii\helpers\Html; 
	?> 
	<p>You have entered the following information:</p> 
	<ul> 
    	<li><label>Name</label>: <?= Html::encode($model->name) ?></li> 
    	<li><label>Contact</label>: <?= Html::encode($model->contact) ?></li> 
    	<li><label>Course</label>: <?= Html::encode($model->course) ?></li> 
   	 <li><label>Email</label>: <?= Html::encode($model->email) ?></li> 
	</ul>

另一个是 user.php 文件，位于 views/site/user.php。

<?php 
	use yii\helpers\Html; 
	use yii\widgets\ActiveForm; 
	?> 
	<?php $form = ActiveForm::begin(); ?> 

    	<?= $form->field($model, 'name') ?> 

    	<?= $form->field($model, 'contact') ?> 

     	<?= $form->field($model, 'course') ?> 

      	<?= $form->field($model, 'email') ?> 

    	<div class="form-group"> 
        	<?= Html::submitButton('Submit', ['class' => 'btn btn-primary']) ?> 
    	</div> 

	<?php ActiveForm::end(); ?>

查看上面的代码，ActiveForm widget 用于创建 HTML 表单。 begin() 和 end() widgets 分别表示 HTML 表单的开始和结束标签。

步骤 4 在浏览器上运行

在您的浏览器中键入以下 URL 来运行表单，

https:///form/frontend/web/index.php?r=site%2Fuser