CFileValidator

 foreach($models as $i=>$model)
    $model->attribute = CUploadedFile::getInstance($model, "[$i]attribute");

 if($model->save())
 {
    // single upload
    $model->attribute->saveAs($path);
    // multiple upload
    foreach($model->attribute as $file)
       $file->saveAs($path);
 }

Property Details

whether the attribute requires a file to be uploaded or not. Defaults to false, meaning a file is required to be uploaded.

the maximum file count the given attribute can hold. It defaults to 1, meaning single file upload. By defining a higher number, multiple uploads become possible.

the maximum number of bytes required for the uploaded file. Defaults to null, meaning no limit. Note, the size limit is also affected by 'upload_max_filesize' INI setting and the 'MAX_FILE_SIZE' hidden field value.

the minimum number of bytes required for the uploaded file. Defaults to null, meaning no limit.

Returns the maximum size allowed for uploaded files. This is determined based on three factors:

• 'upload_max_filesize' in php.ini
• 'MAX_FILE_SIZE' hidden field
• maxSize

the error message used when the uploaded file is too large.

the error message used if the count of multiple uploads exceeds limit.

the error message used when the uploaded file is too small.

a list of file name extensions that are allowed to be uploaded. This can be either an array or a string consisting of file extension names separated by space or comma (e.g. "gif, jpg"). Extension names are case-insensitive. Defaults to null, meaning all file name extensions are allowed.

the error message used when the uploaded file has an extension name that is not listed among extensions.

Method Details

Raises an error to inform end user about blank attribute.

Returns the maximum size allowed for uploaded files. This is determined based on three factors:

• 'upload_max_filesize' in php.ini
• 'MAX_FILE_SIZE' hidden field
• maxSize

Set the attribute and then validates using validateFile. If there is any error, the error message is added to the object.

Internally validates a file object.

array('image', 'file', 'types'=>'jpg,gif,png', 'maxSize'=>'204800', 'allowEmpty'=>true, 'maxFiles'=>4),

public function rules()
{
    return array(
        array('file', 'files', 'types'=>'pdf')
       );
}
 
public function files($attribute,$params)
{
    $validator= CValidator::createValidator('file', $this, $attribute, $params);
    foreach(CUploadedFile::getInstances($this,$attribute) as $file)
    {
        $this->$attribute= $file;
        $validator->validate($this, $attribute);
    }
}

public function rules() {
        // NOTE: you should only define rules for those attributes that
        // will receive user inputs.
        return array(
            array('title', 'required'),
            array('title', 'length', 'max'=>125),
            array('description', 'safe'),
            array('pdf', 'file','on'=>'insert',
                'types'=> 'pdf',
                'maxSize' => 1024 * 1024 * 10, // 10MB                
                'tooLarge' => 'The file was larger than 10MB. Please upload a smaller file.',                
            ),
            array('pdf', 'file','on'=>'update',
                'allowEmpty' => true,
                'types'=> 'pdf',
                'maxSize' => 1024 * 1024 * 10, // 10MB                
                'tooLarge' => 'The file was larger than 10MB. Please upload a smaller file.',                
            ),
        );
    }