Extend description

Help users understand the concept of massive assignment without relying on the Guide by extending the description for this type.
This commit is contained in:
Luke Briner
2015-05-17 13:21:29 +01:00
parent 294dc4b278
commit 271a86aff3

View File

@ -10,6 +10,14 @@ namespace yii\validators;
/**
* SafeValidator serves as a dummy validator whose main purpose is to mark the attributes to be safe for massive assignment.
*
* This class is required because of the way in which Yii determines whether a property is safe for massive assignment, that is,
* when a user submits form data to be loaded into a model directly from the POST data, is it ok for a property to be copied.
* In many cases, this is required but because sometimes properties are internal and you do not want the POST data to be able to
* override these internal values (especially things like database row ids), Yii assumes all values are unsafe for massive assignment
* unless a rule exists for the property, which in most cases it will. Sometimes, however, an item is safe for massive assigment but
* does not have a rule associated with it - for instance, due to no validation being performed, in which case, you use this class
* as a rule for that property. Although it has no functionality, it allows Yii to determine that the property is safe to copy.
*
* @author Qiang Xue <qiang.xue@gmail.com>
* @since 2.0
*/