图片服务

更新时间:2015/09/18 访问次数:14914

创建图片服务, 本地默认写到代码路径中

	$picService = new Alibaba::Pic()

API

/**
   * 上传图片,指定图片全路径,会自动创建相应目录,如果存在同名图片会报错
   * 图片大小限制是3M
   * @param dirpath 目录路径,例如: "/a/b/" 可以为空,如果为空表示根目录
   * @param filename 文件名称,例如: "c.jpg" 可以为空,如果为空系统生成随机文件名
   * @param content 文件内容
   * @return
   */
$response=$picService->savePic($dirpath,$filename,$content);
调用response对象的isSuccess()判定上传是否成功。
调用response对象的getStatus()得到上传的状态码。
调用response对象的getResult()得到Img类型的图片信息,包含图片的名字,图片路径,URL等。
/**
   * 根据图片全路径获取图片信息,如果目录不存在或图片不存在,返回response的sucess为false
   * @param $dirpath 图片全路径
   * @param filename 文件名称
   * @return
   */
$response=$picService->getPic($dirpath,$filename);
/**
   * 根据图片全路径删除图片,如果目录不存在或图片不存在,返回response的sucess为false
   * @param $dirpath 图片全路径
   * @param filename 文件名称
   * @return
   */
$response=$picService->deletePic($dirpath,$filename) ;
/**
   * 获取某个目录路径获取图片列表,如果目录不存在、返回response的sucess为false
   *
   * @param $dirpath 目录路径
   * @return
   */
$response=$picService->getPicList($dirpath)
/**
   * 翻页查询:根据目录id获取图片列表,如果目录不存在、返回response的sucess为false
   * @param $dirpath 目录路径 例如 "/a/b/" ,为空表示根目录
   * @param $currentPage 页码 从1开始
   * @param $pageSize 每页记录数 最小1 最大100
   * @return
   */
$response=$picService->getPicList($dirpath, $currentPage,$pageSize)
/**
   * 删除目录,非空目录不能删除,不能删除根目录
   * @param $dirpath图片路径
   * @return
   */
$response=$picService->deleteDir($dirpath);
/**
   * 创建目录
   * @param $dirpath图片全路径,例如:"/a/b/",不能为空
   * @return
   */
$response=$picService->createDir($dirpath);
/**
   * 获取某个目录的子目录列表,如果目录不存在,返回response的sucess为false
   *
   * @param dirpath 目录路径 例如 "/a/b/",为空表示根目录
   * @return
   */
$response=$picService->getDirList($dirpath)
/**
   * 判断文件是否存在
   * @param $dirpath 目录 ,为空表示根目录
   * @param $filename 文件名称
   * @return
   */
$response=$picService->isFileExist($dirpath,$filename);
/**
   * 判断目录是否存在
   * @param $path 文件全路径
   * @return
   */
$response=$picService->isDirExist($dirpath);
	

返回值类型:

	public class Response {
	private Integer status = 200; //状态码
	private boolean success = false; //方法调用是否成功、是否按预期执行
	private Img result; //返回值,调用成功才有返回值
	private String errorMsg; //调用失败有错误信息
	}
	状态码列表:
	200:请求成功
	400:参数错误
	404:图片不存在
	405:目录不存在
	408:图片大小超限
	406:目录非空不能删除
	406:存在同名目录或文件
	408:请求超时
	500:系统错误

Pic类型

	public class Pic{
/**
   * 文件名
   */
public String filename;
/**
   * 所属目录
   */
public String dirpath;
/**
   * 文件大小
   */
public Long size;
/**
   * 文件类型,0:jpg,1:gif,2:png,3:bmp
   */
public Integer type;
/**
   * 文件内容修改时间
   */
public Date fileModified;
/**
   * 删除标识,0代表正常,1代表已经删除,3代表在回收站中
   */
public Integer deleted;
/**
   * md5加密
   */
public String md5;
/**
* 图片绝对地址, 使用这个地址, 可直接访问图片
* 例如:http://img03.taobaocdn.com/imgextra/i3/436168931/T2Q1UWXFpaXXXXXXXX_!!436168931-2-sitemanager.png
*/
public String fullUrl;
/**
   * 获取不同尺寸的图片绝对地址
   * 例如60x60:http://img03.taobaocdn.com/imgextra/i3/436168931/T2Q1UWXFpaXXXXXXXX_!!436168931-2-sitemanager.png_60x60.jpg
   */
public String getCDNFullUrl($width,$height);
}

FAQ

关于此文档暂时还没有FAQ
返回
顶部