boa框架开发手册v5.2

download类
版本 1.0+
命名空间 boa
文件 boa/download.php
说明 下载类,继承base类,配置:'DOWNLOAD' => [],
配置
配置项 默认值 类型 说明
header [] array 附加的HTTP请求头
expire 0 int HTTP请求执行时长(秒),0=不限
size 2 float 允许的文件大小(MB),0=不限
exts jpg,png,gif string 允许的文件后缀
path BS_WWW .'file/' string 文件保存位置
name null mixed 自定义文件保存名称,支持单个(string)或多个(array),名称可以包含目录
目录
方法 说明
__construct() 初始化
cfg() 获取或设置配置信息
get_file() 获取单个下载文件
get_files() 获取全部下载文件,常用于multiple()
single() 单文件下载
multiple() 多文件下载
extract() 从HTML中提取文件地址
方法

__construct()

说明
初始化
参数 必须 默认值 类型 说明
$cfg [] array 配置数据

cfg()

说明
获取或设置配置信息
参数 必须 默认值 类型 说明
$k null string
$v null string
返回值
如果设定$k和$v:则设置配置中$k项,返回$this(object);
如果只设定$k:则返回配置中$k值(string);
如果都未设定:则返回整个配置数据(array);

get_file()

说明
获取单个下载文件
参数 必须 默认值 类型 说明
$i 0 int 文件索引
返回值
返回文件信息(array)

get_files()

说明
获取全部下载文件,常用于multiple()
返回值
返回文件信息(array)

single()

说明
单文件下载
参数 必须 默认值 类型 说明
$file Y string 远程文件地址
$save string 自定义保存名称
返回值
成功返回true(bool),失败返回false(bool)
示例
$dn = boa::download();
$res = $dn->single('http://boasoft.top/logo.gif');
$file = $dn->get_file();
if($res){
	echo $file['file'];
}else{
	echo $file['error'];
}

multiple()

说明
多文件下载
参数 必须 默认值 类型 说明
$arr Y array 多个远程文件
$save [] array 自定义保存名称
返回值
成功返回true(bool),失败返回false(bool)
示例
boa::download();
$dn->multiple([...]);
print_r($dn->get_files());

extract()

说明
从HTML中提取文件地址
参数 必须 默认值 类型 说明
$str Y string HTML代码
$type 0 int 标签类型;0=<img>,1=<a>,-1=<img>和<a>
$self false bool 是否包含本域名下文件
返回值
返回文件信息(array)