Yii 框架使用Forms操作详解


Posted in PHP onMay 18, 2020

本文实例讲述了Yii 框架使用Forms操作。分享给大家供大家参考,具体如下:

创建模型

模型类 EntryForm 代表从用户那请求的数据, 该类如下所示并存储在 models/EntryForm.php 文件中。 请参考类自动加载章节获取更多关于类命名约定的介绍。

<?php
 
namespace app\models;
 
use Yii;
use yii\base\Model;
 
class EntryForm extends Model
{
  public $name;
  public $email;
 
  public function rules()
  {
    return [
      [['name', 'email'], 'required'],
      ['email', 'email'],
    ];
  }
}

该类继承自Yii 提供的一个基类 yii\base\Model, 该基类通常用来表示数据。

EntryForm 类包含 nameemail 两个公共成员, 用来储存用户输入的数据。它还包含一个名为 rules() 的方法, 用来返回数据验证规则的集合。上面声明的验证规则表示:

  • nameemail 值都是必须的
  • email 的值必须满足email规则验证

如果你有一个处理用户提交数据的 EntryForm 对象, 你可以调用它的 validate() 方法触发数据验证。 如果有数据验证失败,将把 hasErrors 属性设为 ture, 想要知道具体发生什么错误就调用 getErrors。

<?php
$model = new EntryForm();
$model->name = 'Qiang';
$model->email = 'bad';
if ($model->validate()) {
  // 验证成功!
} else {
  // 失败!
  // 使用 $model->getErrors() 获取错误详情
}

创建动作

下面你得在 site 控制器中创建一个 entry 操作用于新建的模型。 操作的创建和使用已经在说一声你好小节中解释了。

<?php
 
namespace app\controllers;
 
use Yii;
use yii\web\Controller;
use app\models\EntryForm;
 
class SiteController extends Controller
{
  // ...现存的代码...
 
  public function actionEntry()
  {
    $model = new EntryForm;
 
    if ($model->load(Yii::$app->request->post()) && $model->validate()) {
      // 验证 $model 收到的数据
 
      // 做些有意义的事 ...
 
      return $this->render('entry-confirm', ['model' => $model]);
    } else {
      // 无论是初始化显示还是数据验证错误
      return $this->render('entry', ['model' => $model]);
    }
  }
}

该操作首先创建了一个 EntryForm 对象。然后尝试从 $_POST 搜集用户提交的数据, 由 Yii 的 yii\web\Request::post() 方法负责搜集。 如果模型被成功填充数据(也就是说用户已经提交了 HTML 表单), 操作将调用 validate() 去确保用户提交的是有效数据。

信息: 表达式 Yii::$app 代表应用实例,它是一个全局可访问的单例。 同时它也是一个服务定位器, 能提供 requestresponsedb 等等特定功能的组件。 在上面的代码里就是使用 request 组件来访问应用实例收到的 $_POST 数据。

用户提交表单后,操作将会渲染一个名为 entry-confirm 的视图去确认用户输入的数据。 如果没填表单就提交,或数据包含错误(译者:如 email 格式不对), entry 视图将会渲染输出,连同表单一起输出的还有验证错误的详细信息。

创建视图

最后创建两个视图文件 entry-confirmentry。 他们会被刚才创建的 entry 操作渲染。

entry-confirm 视图简单地显示提交的 name 和 email 数据。视图文件应该保存在 views/site/entry-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>Email</label>: <?= Html::encode($model->email) ?></li>
</ul>

entry 视图显示一个 HTML 表单。视图文件应该保存在 views/site/entry.php

<?php
use yii\helpers\Html;
use yii\widgets\ActiveForm;
?>
<?php $form = ActiveForm::begin(); ?>
 
  <?= $form->field($model, 'name') ?>
 
  <?= $form->field($model, 'email') ?>
 
  <div class="form-group">
    <?= Html::submitButton('Submit', ['class' => 'btn btn-primary']) ?>
  </div>
 
<?php ActiveForm::end(); ?>

视图使用了一个功能强大的小部件 ActiveForm 去生成 HTML 表单。 其中的 begin()end() 分别用来渲染表单的开始和关闭标签。 在这两个方法之间使用了 field() 方法去创建输入框。 第一个输入框用于 “name”,第二个输入框用于 “email”。 之后使用 yii\helpers\Html::submitButton() 方法生成提交按钮。

用浏览器访问下面的 URL 看它能否工作:

http://hostname/index.php?r=site/entry

Yii 框架使用Forms操作详解

Yii 框架使用Forms操作详解

数据首先由客户端 JavaScript 脚本验证,然后才会提交给服务器通过 PHP 验证。 yii\widgets\ActiveForm 足够智能到把你在 EntryForm 模型中声明的验证规则转化成客户端 JavaScript 脚本去执行验证。 如果用户浏览器禁用了 JavaScript, 服务器端仍然会像 actionEntry() 方法里这样验证一遍数据。这保证了任何情况下用户提交的数据都是有效的。

警告: 客户端验证是提高用户体验的手段。 无论它是否正常启用,服务端验证则都是必须的,请不要忽略它。

输入框的文字标签是 field() 方法生成的,内容就是模型中该数据的属性名。 例如模型中的 name 属性生成的标签就是 Name

你可以在视图中自定义标签 按如下方法:

<?= $form->field($model, 'name')->label('自定义 Name') ?>
<?= $form->field($model, 'email')->label('自定义 Email') ?>

信息: Yii 提供了相当多类似的小部件去帮你生成复杂且动态的视图。 在后面你还会了解到自己写小部件是多么简单。 你可能会把自己的很多视图代码转化成小部件以提高重用,加快开发效率。

希望本文所述对大家基于Yii框架的PHP程序设计有所帮助。

PHP 相关文章推荐
IIS+PHP+MySQL+Zend配置 (视频教程)
Dec 13 PHP
解析CodeIgniter自定义配置文件
Jun 18 PHP
PHP中error_log()函数的使用方法
Jan 20 PHP
浅谈PHP中单引号和双引号到底有啥区别呢?
Mar 04 PHP
laravel自定义分页效果
Jul 23 PHP
PHP开发之用微信远程遥控服务器
Jan 25 PHP
PHP实现生成数据字典功能示例
May 24 PHP
PHP程序员学习使用Swoole的理由
Jun 24 PHP
Laravel的Auth验证Token验证使用自定义Redis的例子
Sep 30 PHP
Yii框架模拟组件调用注入示例
Nov 11 PHP
PHP使用PDO 连接与连接管理操作实例分析
Apr 21 PHP
PhpStorm2020.1 安装 debug - Postman 调用的详细教程
Aug 17 PHP
thinkphp 框架数据库切换实现方法分析
May 18 #PHP
PHP接口类(interface)的定义、特点和应用示例
May 18 #PHP
php + ajax 实现的写入数据库操作简单示例
May 16 #PHP
PHP date_default_timezone_set()设置时区操作实例分析
May 16 #PHP
Yii框架应用组件用法实例分析
May 15 #PHP
Yii框架小部件(Widgets)用法实例详解
May 15 #PHP
Yii框架安装简明教程
May 15 #PHP
You might like
PHP数组交集的优化代码分析
2011/03/06 PHP
php实现的一段简单概率相关代码
2016/05/30 PHP
全面解析PHP操作Memcache基本函数
2016/07/14 PHP
php数组指针操作详解
2017/02/14 PHP
php微信公众号开发之关键词回复
2018/10/20 PHP
jQuery 入门级学习笔记及源码
2010/01/22 Javascript
javascript中onmouse事件在div中失效问题的解决方法
2012/01/09 Javascript
用jquery方法操作radio使其默认选项是否
2013/09/10 Javascript
JS实现简单的顶部定时关闭层效果
2014/06/15 Javascript
基于AngularJS前端云组件最佳实践
2016/10/20 Javascript
纯JS实现图片验证码功能并兼容IE6-8(推荐)
2017/04/19 Javascript
JS实现获取毫秒值及转换成年月日时分秒的方法
2018/08/15 Javascript
JS使用Prim算法和Kruskal算法实现最小生成树
2019/01/17 Javascript
详解如何模拟实现node中的Events模块(通俗易懂版)
2019/04/15 Javascript
vue权限问题的完美解决方案
2019/05/08 Javascript
Vue中props的详解
2019/05/16 Javascript
layer扩展打开/关闭动画的方法
2019/09/23 Javascript
Vue的Eslint配置文件eslintrc.js说明与规则介绍
2020/02/03 Javascript
js实现鼠标切换图片(无定时器)
2021/01/27 Javascript
Python MySQL数据库连接池组件pymysqlpool详解
2017/07/07 Python
对numpy和pandas中数组的合并和拆分详解
2018/04/11 Python
对Python中type打开文件的方式介绍
2018/04/28 Python
详解django的serializer序列化model几种方法
2018/10/16 Python
Pytorch中.new()的作用详解
2020/02/18 Python
详解python logging日志传输
2020/07/01 Python
Hawes & Curtis官网:英国经典品牌
2019/07/27 全球购物
入团者的自我评价分享
2013/12/02 职场文书
高中校园广播稿
2014/01/11 职场文书
管理学院毕业生自荐信范文
2014/03/10 职场文书
啤酒节策划方案
2014/05/28 职场文书
大学专科自荐信
2014/06/17 职场文书
幼儿园秋季开学寄语
2014/08/02 职场文书
违规违纪检讨书范文
2015/05/06 职场文书
Python list去重且保持原顺序不变的方法
2021/04/03 Python
python opencv旋转图片的使用方法
2021/06/04 Python
Python OpenCV超详细讲解调整大小与图像操作的实现
2022/04/02 Python