mirror of
https://github.com/yiisoft/yii.git
synced 2026-03-06 16:16:53 +01:00
101 lines
3.0 KiB
PHP
101 lines
3.0 KiB
PHP
<?php
|
|
/**
|
|
* CFormModel class file.
|
|
*
|
|
* @author Qiang Xue <qiang.xue@gmail.com>
|
|
* @link http://www.yiiframework.com/
|
|
* @copyright Copyright © 2008-2009 Yii Software LLC
|
|
* @license http://www.yiiframework.com/license/
|
|
*/
|
|
|
|
/**
|
|
* CFormModel represents a data model that collects HTML form inputs.
|
|
*
|
|
* Unlike {@link CActiveRecord}, the data collected by CFormModel are stored
|
|
* in memory only, instead of database.
|
|
*
|
|
* To collect user inputs, you may extend CFormModel and define the attributes
|
|
* whose values are to be collected from user inputs. You may override
|
|
* {@link rules()} to declare validation rules that should be applied to
|
|
* the attributes.
|
|
*
|
|
* @author Qiang Xue <qiang.xue@gmail.com>
|
|
* @version $Id$
|
|
* @package system.web
|
|
* @since 1.0
|
|
*/
|
|
class CFormModel extends CModel
|
|
{
|
|
/**
|
|
* Constructor.
|
|
* @param array initial attributes (name => value). The attributes
|
|
* are subject to filtering via {@link setAttributes}.
|
|
*/
|
|
public function __construct($attributes=array())
|
|
{
|
|
if($attributes!==array())
|
|
$this->setAttributes($attributes);
|
|
}
|
|
|
|
/**
|
|
* Returns the list of attribute names.
|
|
* By default, this method returns all public properties of the class.
|
|
* You may override this method to change the default.
|
|
* @return array list of attribute names. Defaults to all public properties of the class.
|
|
*/
|
|
public function attributeNames()
|
|
{
|
|
$class=new ReflectionClass(get_class($this));
|
|
$names=array();
|
|
foreach($class->getProperties() as $property)
|
|
{
|
|
$name=$property->getName();
|
|
if($property->isPublic() && !$property->isStatic())
|
|
$names[]=$name;
|
|
}
|
|
return $names;
|
|
}
|
|
|
|
/**
|
|
* @return array all attribute values (name=>value).
|
|
* The attributes returned are those listed in {@link attributeNames}.
|
|
*/
|
|
public function getAttributes()
|
|
{
|
|
$values=array();
|
|
foreach($this->attributeNames() as $name)
|
|
$values[$name]=$this->$name;
|
|
return $values;
|
|
}
|
|
|
|
/**
|
|
* Sets the attribute values in a massive way.
|
|
* Only safe attributes will be assigned by this method.
|
|
* An attribute is safe if it meets both of the following conditions:
|
|
* <ul>
|
|
* <li>The attribute appears in the attribute list of some validation rule
|
|
* whose "on" property is either empty or contains the specified scenario.</li>
|
|
* <li>The attribute is listed in {@link attributeNames}.</li>
|
|
* </ul>
|
|
*
|
|
* @param array attribute values (name=>value) to be set.
|
|
* @param string scenario name. Defaults to empty string, meaning only attributes
|
|
* listed in those validation rules with empty "on" property can be massively assigned.
|
|
* If this is false, all attributes listed in {@link attributeNames} can be massively assigned.
|
|
*/
|
|
public function setAttributes($values,$scenario='')
|
|
{
|
|
if(is_array($values))
|
|
{
|
|
if($scenario===false)
|
|
$attributes=array_flip($this->attributeNames());
|
|
else
|
|
$attributes=$this->getSafeAttributeNames($scenario);
|
|
foreach($values as $name=>$value)
|
|
{
|
|
if(isset($attributes[$name]))
|
|
$this->$name=$value;
|
|
}
|
|
}
|
|
}
|
|
} |