AttwFramework 文件组件

dev-master 2014-09-28 05:40 UTC

This package is auto-updated.

Last update: 2024-09-16 04:08:23 UTC


README

Total Downloads Latest Unstable Version License

AttwFramework 的文件组件。

##Composer ###下载

{
    "require": {
        "attwframework/file": "dev-master"
    }
}

##如何使用 使用 Attw\File\File 类表示文件。

在构造函数中传递一个包含文件详情(全局变量 $_FILES)的数组。

use Attw\File\File;

//...

$file = new File($_FILES['file']);

Attw\File 命名空间下的所有组件都使用文件类。###上传 要上传文件,使用 Attw\File\Uploader\Uploader 类。

上传文件的方法是 Attw\File\Uploader\Uploader::upload($file, $directory)

use Attw\File\File;
use Attw\File\Uploader\Uploader;

//...

$file = new File($_FILES['file']);
$uploader = new Uploader();
if($uploader->upload($file, 'public/files')){
    //success
}

###文件验证器 还可以验证文件。

验证器有:

  • Attw\File\Validator\MaxSize:不允许文件大小超过指定的最大值
  • 构造函数:Attw\File\Validator\MaxSize::__construct($maxSize)$maxSize 必须是整数,并以 MB 为单位表示
  • Attw\File\Validator\MinSize:不允许文件大小低于指定的最小值
  • 构造函数:Attw\File\Validator\MinSize::__construct($minSize)$minSize 必须是整数,并以 MB 为单位表示
  • Attw\File\Validator\Extension:不允许文件具有无效的扩展名
  • 构造函数:Attw\File\Validator\Extenction::__construct($extensions)$extensions 必须是包含允许扩展名的数组
  • Attw\File\Validator\Type:不允许文件具有无效的类型
  • 构造函数:Attw\File\Validator\Type::__construct($types)$types 必须是包含允许类型的数组
use Attw\File\File;
use Attw\File\Validator\Extension;

//...

$file = new File($_FILES['file']);
$validator = new Extension([ 'jpg', 'png', 'gif' ]);

if($validator->validate($file)){
    //success
}

如果想在验证失败时抛出异常(Attw\File\Validator\Exception\FileValidatorException),请执行方法 Attw\File\Validator\SomeValidator::exception($on = false),并将参数 $on 设置为 true