首页 / PHP / Yii框架官方指南系列17——使用表单：创建模型

Yii框架官方指南系列17——使用表单：创建模型

内容导读

互联网集市收集整理的这篇技术教程文章主要介绍了Yii框架官方指南系列17——使用表单：创建模型，小编现在分享给大家，供广大互联网技能从业者学习和参考。文章包含9433字，纯文字阅读大概需要14分钟。

内容图文

在编写表单所需的 HTML 代码之前，我们应该先确定来自最终用户输入的数据的类型，以及这些数据应符合什么样的规则。模型类可用于记录这些信息。正如模型章节所定义的，模型是保存用户输入和验证这些输入的中心位置。

取决于使用用户所输入数据的方式，我们可以创建两种类型的模型。如果用户输入被收集、使用然后丢弃，我们应该创建一个表单模型; 如果用户的输入被收集后要保存到数据库，我们应使用一个 Active Record 。两种类型的模型共享同样的基类 CModel ，它定义了表单所需的通用接口。

注意: 我们在这一节的示例中主要使用了表单模型。然而，同样的操作也可应用于 Active Record 模型。

1. 定义模型类

下面我们创建了一个 LoginForm 模型类用于在一个登录页中收集用户的输入。由于登录信息只被用于验证用户，并不需要保存，因此我们将 LoginForm 创建为一个表单模型。

class LoginForm extends CFormModel
{
    public $username;
    public $password;
    public $rememberMe=false;
}

LoginForm 中定义了三个属性: $username, $password 和 $rememberMe。他们用于保存用户输入的用户名和密码，还有用户是否想记住他的登录的选项。由于 $rememberMe 有一个默认的值 false，相应的选项在初始化显示在登录表单中时将是未勾选状态。

信息: 我们将这些成员变量称为 特性（attributes） 而不是属性（properties），以区别于普通的属性（properties）。特性（attribute）是一个主要用于存储来自用户输入或数据库数据的属性（propertiy）。

2. 声明验证规则

一旦用户提交了他的输入，模型被填充，我们就需要在使用前确保用户的输入是有效的。这是通过将用户的输入和一系列规则执行验证实现的。我们在 rules() 方法中指定这些验证规则，此方法应返回一个规则配置数组。

class LoginForm extends CFormModel
{
    public $username;
    public $password;
    public $rememberMe=false;

    private $_identity;

    public function rules()
    {
        return array(
            array('username, password', 'required'),
            array('rememberMe', 'boolean'),
            array('password', 'authenticate'),
        );
    }

    public function authenticate($attribute,$params)
    {
        $this->_identity=new UserIdentity($this->username,$this->password);
        if(!$this->_identity->authenticate())
            $this->addError('password','错误的用户名或密码。');
    }
}

上述代码指定：username 和 password 为必填项， password 应被验证（authenticated），rememberMe 应该是一个布尔值。

rules() 返回的每个规则必须是以下格式：

array('AttributeList', 'Validator', 'on'=>'ScenarioList', ...附加选项)

其中 AttributeList（特性列表） 是需要通过此规则验证的特性列表字符串，每个特性名字由逗号分隔;Validator（验证器） 指定要执行验证的种类；on 参数是可选的，它指定此规则应被应用到的场景列表；附加选项是一个名值对数组，用于初始化相应验证器的属性值。

有三种方式可在验证规则中指定 Validator 。

第一， Validator 可以是模型类中一个方法的名字，就像上面示例中的 authenticate 。验证方法必须是下面的结构：

/**
 * @param string 所要验证的特性的名字
 * @param array 验证规则中指定的选项
 */
public function ValidatorName($attribute,$params) { ... }

第二，Validator 可以是一个验证器类的名字，当此规则被应用时，一个验证器类的实例将被创建以执行实际验证。规则中的附加选项用于初始化实例的属性值。验证器类必须继承自 CValidator。

第三，Validator 可以是一个预定义的验证器类的别名。在上面的例子中， required 名字是CRequiredValidator 的别名，它用于确保所验证的特性值不为空。下面是预定义的验证器别名的完整列表：

boolean: CBooleanValidator 的别名，确保特性有一个 CBooleanValidator::trueValue 或CBooleanValidator::falseValue 值。
captcha: CCaptchaValidator 的别名，确保特性值等于 CAPTCHA 中显示的验证码。
compare: CCompareValidator 的别名，确保特性等于另一个特性或常量。
email: CEmailValidator 的别名，确保特性是一个有效的Email地址。
default: CDefaultValueValidator 的别名，指定特性的默认值。
exist: CExistValidator 的别名，确保特性值可以在指定表的列中可以找到。
file: CFileValidator 的别名，确保特性含有一个上传文件的名字。
filter: CFilterValidator 的别名，通过一个过滤器改变此特性。
in: CRangeValidator 的别名，确保数据在一个预先指定的值的范围之内。
length: CStringValidator 的别名，确保数据的长度在一个指定的范围之内。
match: CRegularExpressionValidator 的别名，确保数据可以匹配一个正则表达式。
numerical: CNumberValidator 的别名，确保数据是一个有效的数字。
required: CRequiredValidator 的别名，确保特性不为空。
type: CTypeValidator 的别名，确保特性是指定的数据类型。
unique: CUniqueValidator 的别名，确保数据在数据表的列中是唯一的。
url: CUrlValidator 的别名，确保数据是一个有效的 URL。

下面我们列出了几个只用这些预定义验证器的示例：

// 用户名为必填项
array('username', 'required'),
// 用户名必须在 3 到 12 个字符之间
array('username', 'length', 'min'=>3, 'max'=>12),
// 在注册场景中，密码password必须和password2一致。
array('password', 'compare', 'compareAttribute'=>'password2', 'on'=>'register'),
// 在登录场景中，密码必须接受验证。
array('password', 'authenticate', 'on'=>'login'),

3. 安全的特性赋值

在一个类的实例被创建后，我们通常需要用最终用户提交的数据填充它的特性。这可以通过如下块赋值（massive assignment）方式轻松实现：

$model=new LoginForm;
if(isset($_POST['LoginForm']))
    $model->attributes=$_POST['LoginForm'];

最后的表达式被称作 块赋值（massive assignment），它将 $_POST['LoginForm'] 中的每一项复制到相应的模型特性中。这相当于如下赋值方法：

foreach($_POST['LoginForm'] as $name=>$value)
{
    if($name 是一个安全的特性)
        $model->$name=$value;
}

检测特性的安全非常重要，例如，如果我们以为一个表的主键是安全的而暴露了它，那么攻击者可能就获得了一个修改记录的主键的机会，从而篡改未授权给他的内容。

检测特性安全的策略在版本 1.0 和 1.1 中是不同的，下面我们将分别讲解：

1.1 中的安全特性

在版本 1.1 中，特性如果出现在相应场景的一个验证规则中，即被认为是安全的。例如：

array('username, password', 'required', 'on'=>'login, register'),
array('email', 'required', 'on'=>'register'),

如上所示， username 和 password 特性在 login 场景中是必填项。而 username, password 和 email 特性在register 场景中是必填项。于是，如果我们在 login 场景中执行块赋值，就只有 username 和 password 会被块赋值。因为只有它们出现在 login 的验证规则中。另一方面，如果场景是 register ，这三个特性就都可以被块赋值。

// 在登录场景中
$model=new User('login');
if(isset($_POST['User']))
    $model->attributes=$_POST['User'];

// 在注册场景中
$model=new User('register');
if(isset($_POST['User']))
    $model->attributes=$_POST['User'];

那么为什么我们使用这样一种策略来检测特性是否安全呢？背后的基本原理就是：如果一个特性已经有了一个或多个可检测有效性的验证规则，那我们还担心什么呢？

请记住，验证规则是用于检查用户输入的数据，而不是检查我们在代码中生成的数据（例如时间戳，自动产生的主键）。因此，不要为那些不接受最终用户输入的特性添加验证规则。

有时候，我们想声明一个特性是安全的，即使我们没有为它指定任何规则。例如，一篇文章的内容可以接受用户的任何输入。我们可以使用特殊的 safe 规则实现此目的：

array('content', 'safe')

为了完成起见，还有一个用于声明一个属性为不安全的 unsafe 规则：

array('permission', 'unsafe')

unsafe 规则并不常用，它是我们之前定义的安全特性的一个例外。

1.0 中的安全特性

在版本1.0中,决定一个数据项是否是安全的,基于一个名为 safeAttributes 方法的返回值和数据项被指定的场景. 默认的,这个方法返回所有公共成员变量作为 CFormModel 的安全特性,而它也返回了除了主键外, 表中所有字段名作为 CActiveRecord的安全特性.我们可以根据场景重写这个方法来限制安全特性 .例如, 一个用户模型可以包含很多特性,但是在 login 场景.里,我们只能使用 username 和 password 特性.我们可以按照如下来指定这一限制 :

public function safeAttributes()
{
    return array(
        parent::safeAttributes(),
        'login' => 'username, password',
    );
}

safeAttributes 方法更准确的返回值应该是如下结构的 :

array(
   // these attributes can be massively assigned in any scenario
   // that is not explicitly specified below
   'attr1, attr2, ...',
     *
   // these attributes can be massively assigned only in scenario 1
   'scenario1' => 'attr2, attr3, ...',
     *
   // these attributes can be massively assigned only in scenario 2
   'scenario2' => 'attr1, attr3, ...',
)

如果模型不是场景敏感的(比如,它只在一个场景中使用,或者所有场景共享了一套同样的安全特性),返回值可以是如下那样简单的字符串.

'attr1, attr2, ...'

而那些不安全的数据项,我们需要使用独立的赋值语句来分配它们到相应的特性.如下所示:

$model->permission='admin';
$model->id=1;

4. 触发验证

一旦模型被用户提交的数据填充，我们就可以调用 CModel::validate() 出发数据验证进程。此方法返回一个指示验证是否成功的值。对 CActiveRecord 模型来说，验证也可以在我们调用其 CActiveRecord::save() 方法时自动触发。

我们可以使用 scenario 设置场景属性，这样，相应场景的验证规则就会被应用。

验证是基于场景执行的。 scenario 属性指定了模型当前用于的场景和当前使用的验证规则集。例如，在 login场景中，我们只想验证用户模型中的 username 和 password 输入；而在 register 场景中，我们需要验证更多的输入，例如 email, address, 等。下面的例子演示了如何在 register 场景中执行验证：

// 在注册场景中创建一个  User 模型。等价于：
// $model=new User;
// $model->scenario='register';
$model=new User('register');

// 将输入的值填充到模型
$model->attributes=$_POST['User'];

// 执行验证
if($model->validate())   // if the inputs are valid
    ...
else
    ...

规则关联的场景可以通过规则中的 on 选项指定。如果 on 选项未设置，则此规则会应用于所有场景。例如：

public function rules()
{
    return array(
        array('username, password', 'required'),
        array('password_repeat', 'required', 'on'=>'register'),
        array('password', 'compare', 'on'=>'register'),
    );
}

第一个规则将应用于所有场景，而第二个将只会应用于 register 场景。

5. 提取验证错误

验证完成后，任何可能产生的错误将被存储在模型对象中。我们可以通过调用 CModel::getErrors() 和CModel::getError() 提取这些错误信息。这两个方法的不同点在于第一个方法将返回所有模型特性的错误信息，而第二个将只返回 第一个 错误信息。

6. 特性标签

当设计表单时，我们通常需要为每个表单域显示一个标签。标签告诉用户他应该在此表单域中填写什么样的信息。虽然我们可以在视图中硬编码一个标签，但如果我们在相应的模型中指定（标签），则会更加灵活方便。

默认情况下 CModel 将简单的返回特性的名字作为其标签。这可以通过覆盖 attributeLabels() 方法自定义。正如在接下来的小节中我们将看到的，在模型中指定标签会使我们能够更快的创建出更强大的表单。

以上就是Yii框架官方指南系列17——使用表单：创建模型的内容，更多相关内容请关注PHP中文网（www.gxlcms.com）！

内容总结

以上是互联网集市为您收集整理的Yii框架官方指南系列17——使用表单：创建模型全部内容，希望文章能够帮你解决Yii框架官方指南系列17——使用表单：创建模型所遇到的程序开发问题。如果觉得互联网集市技术教程内容还不错，欢迎将互联网集市网站推荐给程序员好友。

内容备注

版权声明：本文内容由互联网用户自发贡献，该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容，请发送邮件至 gblab@vip.qq.com 举报，一经查实，本站将立刻删除。

内容手机端

扫描二维码推送至手机访问。

本文链接：https://qyyshop.com/info/146990.html

来源：【匿名】

【上一篇】Yii框架官方指南系列38——定义特定状态(Fixtures)【下一篇】PHP 5 数据对象 (PDO) 抽象层与 Oracle

更多 ►

【Yii框架官方指南系列17——使用表单：创建模型】教程文章相关的互联网学习教程文章

PHP Yii框架中使用git进行版本控制的一下知识

Git在Wikipedia上的定义：它是一个免费的、分布式的版本控制工具，或是一个强调了速度快的源代码管理工具。Git最初被Linus Torvalds开发出来用于管理Linux内核的开发。每一个Git的工作目录都是一个完全独立的代码库，并拥有完整的历史记录和版本追踪能力，不依赖于网络和中心服务器。 git版本控制的相关的一些指令和命令。初始化两个基本的命令git init . 就是在当前的目录下建立一个版本库git clone git://github.com/someo...

简介PHP的Yii框架中缓存的一些高级用法

页面缓存页面缓存指的是在服务器端缓存整个页面的内容。随后当同一个页面被请求时，内容将从缓存中取出，而不是重新生成。页面缓存由 yii\filters\PageCache 类提供支持，该类是一个过滤器。它可以像这样在控制器类中使用： public function behaviors() {return [[class => yii\filters\PageCache,only => [index],duration => 60,variations => [\Yii::$app->language,],dependency => [class => yii\caching\DbDependency,sql...

深入解析PHP的Yii框架中的缓存功能

数据缓存是指将一些 PHP 变量存储到缓存中，使用时再从缓存中取回。它也是更高级缓存特性的基础，例如查询缓存和内容缓存。如下代码是一个典型的数据缓存使用模式。其中 $cache 指向缓存组件： // 尝试从缓存中取回 $data $data = $cache->get($key);if ($data === false) {// $data 在缓存中没有找到，则重新计算它的值// 将 $data 存放到缓存供下次使用$cache->set($key, $data); }// 这儿 $data 可以使用了。缓存组件数据缓存...

Yii2框架的csrf验证原理分析及token缓存解决方案

本文主要分三个部分，首先简单介绍csrf，接着对照源码重点分析一下yii框架的验证原理，最后针对页面缓存导致的token被缓存提出一种可行的方案。涉及的知识点会作为附录附于文末。感兴趣的朋友了解一下吧。1.CSRF描述CSRF全称为“Cross-Site Request Forgery”，是在用户合法的SESSION内发起的攻击。黑客通过在网页中嵌入Web恶意请求代码，并诱使受害者访问该页面，当页面被访问后，请求在受害者不知情的情况下以受害者的合法身份发...

深入解析PHP的Yii框架中的缓存功能_PHP

数据缓存是指将一些 PHP 变量存储到缓存中，使用时再从缓存中取回。它也是更高级缓存特性的基础，例如查询缓存和内容缓存。如下代码是一个典型的数据缓存使用模式。其中 $cache 指向缓存组件：// 尝试从缓存中取回 $data $data = $cache->get($key);if ($data === false) {// $data 在缓存中没有找到，则重新计算它的值// 将 $data 存放到缓存供下次使用$cache->set($key, $data); }// 这儿 $data 可以使用了。缓存组件数据缓存...

简介PHP的Yii框架中缓存的一些高级用法_PHP

页面缓存页面缓存指的是在服务器端缓存整个页面的内容。随后当同一个页面被请求时，内容将从缓存中取出，而不是重新生成。页面缓存由 yii\filters\PageCache 类提供支持，该类是一个过滤器。它可以像这样在控制器类中使用：public function behaviors() {return [[class => yii\filters\PageCache,only => [index],duration => 60,variations => [\Yii::$app->language,],dependency => [class => yii\caching\DbDependency,sql ...

深入解析PHP的Yii框架中的缓存功能_php技巧

简介PHP的Yii框架中缓存的一些高级用法_php技巧

yii框架缓存知识总结_PHP教程

yii框架缓存知识总结缓存是用于提升网站性能的一种即简单又有效的途径。稍微有点规模的网站都会通过存储相对静态的数据至缓存以备所需，这样我们可以省去从数据库查询然后生成这些数据的时间，通过减轻数据库的压力从而提升网站的性能。 Yii作为一个强大的php开源框架，再缓存这块，YII对各种流行的缓存都提供了接口，我们可以根据实际的需要使用不同的缓存。 yii的缓存相关组件存放在yii/framework/caching的目录内，通过查看该目...

深入解析PHP的Yii框架中的缓存功能，yii框架_PHP教程

深入解析PHP的Yii框架中的缓存功能，yii框架数据缓存是指将一些 PHP 变量存储到缓存中，使用时再从缓存中取回。它也是更高级缓存特性的基础，例如查询缓存和内容缓存。如下代码是一个典型的数据缓存使用模式。其中 $cache 指向缓存组件： // 尝试从缓存中取回 $data $data = $cache->get($key);if ($data === false) {// $data 在缓存中没有找到，则重新计算它的值// 将 $data 存放到缓存供下次使用$cache->set($key, $data); }/...

简介PHP的Yii框架中缓存的一些高级用法，phpyii框架缓存_PHP教程

简介PHP的Yii框架中缓存的一些高级用法，phpyii框架缓存页面缓存页面缓存指的是在服务器端缓存整个页面的内容。随后当同一个页面被请求时，内容将从缓存中取出，而不是重新生成。页面缓存由 yii\filters\PageCache 类提供支持，该类是一个过滤器。它可以像这样在控制器类中使用： public function behaviors() {return [[class => yii\filters\PageCache,only => [index],duration => 60,variations => [\Yii::$app->language,],...

yii2框架怎么设置缓存【代码】【图】

具体方法如下：（相关推荐：yii）首先来配置组件。方便起见，我们的缓存组件配置在common\config\main.php文件，先来简单配置下文件缓存components => [ cache => [ class => yii\caching\FileCache, cachePath => @runtime/cache2, ], ],默认的缓存路径是@app\runtime\cache目录下，如果你想要修改缓存路径，可以像上面配置一样，配置下cachePath即可我们直接来操作看看$cache = Yii::$app->cache; $data = $cache->get(cache_d...

yii2框架怎么设置缓存【代码】【图】

Yii框架如何正确使用MemCache缓存【代码】【图】

具体操作如下所示：（图文教程推荐：yii）一、配置memcache server 服务器1、下载memcached软件包,下载地址：http://pan.baidu.com/s/1boAnghp解压,把memcached.exe放到随意一个地方,比如:d:/memcached/下（我解压到了我的wampserver的bin目录下与php目录同级）。2、windows+R快捷键输入cmd, 在命令行中输入一下代码，切换到memcache.exe的目录下：3、输入如下代码安装memcache.exe: memcached.exe -d install 4、输入memcached.ex...

Yii框架如何正确使用MemCache缓存【代码】【图】

首页 / PHP / Yii框架官方指南系列17——使用表单：创建模型

Yii框架官方指南系列17——使用表单：创建模型

内容导读

内容图文

1. 定义模型类

2. 声明验证规则

3. 安全的特性赋值

4. 触发验证

5. 提取验证错误

6. 特性标签

内容总结

内容备注

内容手机端

【Yii框架官方指南系列17——使用表单：创建模型】教程文章相关的互联网学习教程文章

框架 - 相关标签

模型 - 相关标签

PHP - 技术教程分类

PHP - 最新教程

PHP - 最热教程