PHP 개발 프레임워크 Yii 프레임워크 튜토리얼(8) FormModel 사용
- 黄舟원래의
- 2017-01-21 09:54:571098검색
이전 연구를 통해 Yii 웹 애플리케이션의 기본 구성 요소를 이해했으며 행맨 단어 추측 게임과 같은 간단한 애플리케이션도 작성할 수 있습니다. 첫 번째 예에서는 Yii 프레임워크 개발 개요 튜토리얼(1) 첫 번째 애플리케이션 Hello World에서 Yii 웹 애플리케이션에 채택된 MVC 모델을 소개했으며, 또한 이 튜토리얼의 목적은 다양한 관점(주로 Windows 애플리케이션 C++ 개발을 통해)을 통해 설명되었습니다. , C# 프로그래머의 관점)은 Windows 데스크톱 응용 프로그램 또는 ASP.Net 프로그래머가 PHP Yii Framework 응용 프로그램 프레임워크를 빠르게 익히는 데 도움이 됩니다.
앞서 CHtml을 통해 View(페이지 보기 양식)를 생성하고 CController를 통해 사용자 제출 이벤트를 처리하는 방법을 소개했습니다. Windows 데스크톱 애플리케이션이나 ASP.Net과 유사하게 Yii 중간 보기 보기(HTML Form)는 WinForm과 유사합니다. 또는 Asp.Net 페이지. Control 클래스 Controller는 Windows 데스크톱 응용 프로그램 또는 Asp.Net의 이벤트 처리(Code-Behind) 클래스와 유사합니다. 차이점은 Asp.Net 및 Windows 데스크톱 응용 프로그램이 텍스트 상자 및 버튼과 같은 UI의 각 UI 구성 요소에 대한 ID를 정의한 다음 다양한 UI 구성 요소에 대한 이벤트 처리를 추가할 수 있다는 것입니다. HTML 양식에 정의된 UI 구성 요소에 대한 ID를 정의하고 UI 구성 요소에 대한 이벤트 처리를 정의하는 PHP 응용 프로그램 또는 Yii 응용 프로그램에 해당하는 메커니즘이 없습니다. 그러나 Yii 프레임워크는 유사한 기능을 지원하기 위해 CFormModel을 제공합니다. 간단히 말해 CFormModel을 통해 HTML Form의 UI 위젯에 대한 변수를 정의할 수 있으며 이러한 변수는 컨트롤 클래스 Controller에서 액세스할 수 있습니다. 각 Yii 보기(양식)는 일반적으로 "제출 버튼"을 제공하여 CController 개체에 해당하는 actionXXX 메서드를 트리거합니다. actionXXX 메서드에서는 CFormModel을 통해 HTML 양식의 UI 구성 요소에 액세스할 수 있습니다. . 값.
이전 튜토리얼에서 언급했듯이 Yii의 모델은 CModel 또는 그 하위 클래스의 인스턴스입니다. 모델은 데이터 및 관련 비즈니스 로직을 유지하는 데 사용됩니다.
Yii는 양식 모델과 Active Record라는 두 가지 모델을 구현합니다. 둘 다 동일한 기본 클래스 CModel에서 상속됩니다.
양식 모델은 CFormModel의 인스턴스입니다. 양식 모델은 사용자 입력에서 얻은 데이터를 보유하는 데 사용됩니다. 이 데이터는 종종 획득, 사용 및 폐기됩니다. 예를 들어 로그인 페이지에서 양식 모델을 사용하여 최종 사용자가 제공한 사용자 이름과 비밀번호 정보를 나타낼 수 있습니다. 자세한 사항은 이용양식을 참고해주세요. 이 글에서는 CFormModel의 사용법을 소개합니다.
액티브 레코드(AR)는 객체 지향 스타일을 통해 데이터베이스 액세스를 추상화하는 데 사용되는 디자인 패턴입니다. 각 AR 개체는 CActiveRecord의 인스턴스 또는 해당 하위 클래스 중 하나입니다. 데이터 테이블의 행을 나타냅니다. 행의 필드는 AR 개체의 속성에 해당합니다. AR에 대한 자세한 내용은 Active Record를 참고해주세요. 나중에 데이터베이스 활용에 대해 소개할 때 소개하겠습니다.
이 기사에서는 간단한 로그인 인터페이스를 사용하여 FormModel의 사용법을 소개합니다.
1. 모델 클래스 정의
아래에서는 로그인 페이지에서 사용자 입력을 수집하기 위한 LoginForm(protected/models/LoginForm.php) 모델 클래스를 생성합니다. 로그인 정보는 사용자 인증에만 사용되며 저장할 필요가 없으므로 양식 모델로 LoginForm을 생성합니다.
class LoginForm extends
CFormModel
{
public $username;
public $password;
public $rememberMe=false;
} 2. 유효성 검사 규칙 선언
사용자가 입력을 제출하고 모델이 채워지면 사용하기 전에 사용자의 입력이 유효한지 확인해야 합니다. 이는 일련의 규칙에 대해 사용자 입력을 검증함으로써 달성됩니다. 규칙 구성 배열을 반환해야 하는 규칙() 메서드에 이러한 유효성 검사 규칙을 지정합니다.
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','错误的用户名或密码。');
}
}위 코드는 사용자 이름과 비밀번호가 필요하고, 비밀번호가 인증되어야 하며, RememberMe는 부울 값이어야 함을 지정합니다.
rules()에서 반환된 각 규칙은 다음 형식이어야 합니다.
array('AttributeList', 'Validator', 'on'=>'ScenarioList', ...附加选项)
여기서 AttributeList(속성 목록)는 확인해야 하는 속성 목록 문자열입니다. 이 규칙은 각 속성 이름을 쉼표로 구분합니다. 유효성 검사기(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() 方法自定义。 正如在 接下来的小节中我们将看到的，在模型中指定标签会使我们能够更快的创建出更强大的表单。
7. 创建动作Action方法
创建好LoginForm 表单Model后，我们就可以为它编写用户提交后的处理代码(对应到Controller中的某个Action方法） 。本例使用缺省的SiteController，对应的action为actionLogin.
public function actionLogin()
{
$model=new LoginForm;
// collect user input data
if(isset($_POST['LoginForm']))
{
$model->attributes=$_POST['LoginForm'];
// validate user input and redirect to the previous page if valid
if($model->validate() && $model->login()){
$this->render('index');
return;
}
}
// display the login form
$this->render('login',array('model'=>$model));
}如上所示，我们首先创建了一个 LoginForm 模型示例； 如果请求是一个 POST 请求（意味着这个登录表单被提交了 ），我们则使用提交的数据 $_POST['LoginForm'] 填充 $model ；然后我们验证此输入，如果验证成功，则显示index 页面。 如果验证失败，或者此动作被初次访问，我们则渲染 login 视图。
注意的我们修改了SiteController 的缺省 action为login.
/** * @var string sets the default action to be 'login' */ public $defaultAction='login';
因此用户见到的第一个页面为login页面而非index页面，只有在用户输入正确的用 户名，本例使用固定的用户名和密码，参见UserIdentity类定义，实际应用可以读取数据库或是LDAP服务器。
/**
* UserIdentity represents the data needed to identity a user.
* It contains the authentication method that checks if the provided
* data can identity the user.
*/
class UserIdentity extends CUserIdentity
{
/**
* Authenticates a user.
* The example implementation makes sure if the username and password
* are both 'demo'.
* In practical applications, this should be changed to authenticate
* against some persistent user identity storage (e.g. database).
* @return boolean whether authentication succeeds.
*/
public function authenticate()
{
$users=array(
// username => password
'demo'=>'demo',
'admin'=>'admin',
);
if(!isset($users[$this->username]))
$this->errorCode=self::ERROR_USERNAME_INVALID;
else if($users[$this->username]!==$this->password)
$this->errorCode=self::ERROR_PASSWORD_INVALID;
else
$this->errorCode=self::ERROR_NONE;
return !$this->errorCode;
}
}让我们特别留意一下 login 动作中出现的下面的 PHP 语句：
$model->attributes=$_POST ['LoginForm'];
正如我们在 安全的特性赋值 中所讲的， 这行代码使用用户提交的数据填充模型。 attributes 属性由 CModel定义，它接受一个名值对数组并将其中的每个值赋给相应的模型特性。 因此如果 $_POST ['LoginForm'] 给了我们这样的一个数组，上面的那段代码也就等同于下面冗长的这段 (假设数组中存在所有所需的特 性):
$model->username=$_POST['LoginForm']['username']; $model->password=$_POST ['LoginForm']['password']; $model->rememberMe=$_POST['LoginForm'] ['rememberMe'];
8. 构建视图
编写 login 视图是很简单的，我们以一个 form 标记开始，它的 action 属性应该是前面讲述的 login 动作的URL。 然后我们需要为 LoginForm 类中声明的属性插入标签和表单域。最后， 我们插入 一个可由用户点击提交此表单的提交按钮。所有这些都可以用纯HTML代码完成。
Yii 提供了几个助手（helper）类简化 视图编写。例如， 要创建一个文本输入域，我们可以调用 CHtml::textField()； 要创建一个下拉列表，则调用 CHtml::dropDownList()。
信息: 你可能想知道使用助手的好处，如果它们所需的代码量和直接写纯HTML的代码量相当的 话。 答案就是助手可以提供比 HTML 代码更多的功能。例如， 如下代码将生成一个文本输入域，它可以在用户修改了其值时触 发表单提交动作。
CHtml::textField($name,$value,array('submit'=>''));
不然的话你就 需要写一大堆 JavaScript 。
下面，我们使用 CHtml 创建一个登录表单。我们假设变量 $model 是 LoginForm 的实例 。
<center class="form">
<?php echo CHtml::beginForm(); ?>
<?php echo CHtml::errorSummary($model); ?>
<center class="row">
<?php echo CHtml::activeLabel($model,'username'); ?>
<?php echo CHtml::activeTextField($model,'username') ?>
</center>
<center class="row">
<?php echo CHtml::activeLabel($model,'password'); ?>
<?php echo CHtml::activePasswordField($model,'password') ?>
</center>
<center class="row rememberMe">
<?php echo CHtml::activeCheckBox($model,'rememberMe'); ?>
<?php echo CHtml::activeLabel($model,'rememberMe'); ?>
</center>
<center class="row submit">
<?php echo CHtml::submitButton('Login'); ?>
</center>
<?php echo CHtml::endForm(); ?>
</center><!-- form -->上述代码生成了一个更加动态的表单，例如， CHtml::activeLabel() 生成一个与 指定模型的特性相关的标签。 如果此特性有一个输入错误，此标签的CSS class 将变为 error，通过 CSS 样式改变了标签的外 观。 相似的，CHtml::activeTextField() 为指定模型的特性生成一个文本输入域，并会在错误发生时改变它的 CSS class。
如果我们使用由 yiic 脚本生提供的 CSS 样式文件，生成的表单就会像下面这样：
CSS 样式定义在css目录下，本例使用的为Yii缺省的样式。
从版本 1.1.1 开始，提供了一个新的小物件 CActiveForm 以简化表单创建。 这个小物件可同时提供客户端及服务器端无缝的、一致的验证。使用 CActiveForm, 上面的代 码可重写为：
<center class="form">
<?php $form=$this->beginWidget('CActiveForm'); ?>
<?php echo $form->errorSummary($model); ?>
<center class="row">
<?php echo $form->label($model,'username'); ?>
<?php echo $form->textField($model,'username') ?>
</center>
<center class="row">
<?php echo $form->label($model,'password'); ?>
<?php echo $form->passwordField($model,'password') ?>
</center>
<center class="row rememberMe">
<?php echo $form->checkBox($model,'rememberMe'); ?>
<?php echo $form->label($model,'rememberMe'); ?>
</center>
<center class="row submit">
<?php echo CHtml::submitButton('Login'); ?>
</center>
<?php $this->endWidget(); ?>
</center><!-- form -->从下篇开始将逐个介绍Yii框架支持的UI组件包括CActiveForm的用法。
以上就是PHP开发框架Yii Framework教程(8) 使用FormModel的内容，更多相关内容请关注PHP中文网（www.php.cn）！