README

说明

http 请求使用 Guzzle 三方库（v6.3），具体文档可参考：Guzzle v6.3 Doc

安装

composer require jufeng/phpsdk

图片各个环境服务接口

• 线上环境 https://imgserver-api.deenet.cn/v1
• 测试环境 https://test-imgserver-api.deenet.cn/v1 需要绑定 host

使用方法

<?php

require 'vendor/autoload.php';

// 实例化客户端，最后的参数为加密算法，不传则默认为 sha256
$client = new JF\FileManager('ak', 'sk', 'https://imgserver-api.deenet.cn/v1/', 'md5');

// 设置上传策略，无特殊需求可省略。参考：参考：http://git.20hn.cn/developer/img-server/wikis/api-des
// $client->setPolicy(['deadline' => time() + 3600, 'autoCompress' => 1, 'autoWatermark' => 1]);
// 获取token值
// echo $client->getToken();

try {
    // 文件上传
    $response = $client->upload($filePath = '/tmp/test.jpeg');
    // 远程图片采集
    // $response = $client->collect('http://9.pic.pc6.com/thumb/up/2015-4/14301352575151701_600_0.jpg');

    // http 请求返回内容
    echo $response->getBody();
    // http 响应状态码
    echo $response->getStatusCode();
} catch (GuzzleHttp\Exception\BadResponseException $e) {
    // 4xx 或 5xx 错误
    $response = $e->getResponse();
    echo $response->getStatusCode();
} catch (Exception $e) {
    echo $e->getMessage();
}

JF图片服务 JS SDK

推荐使用的三方上传组件：uploadify、plupload。相对于uploadify，plupload功能更为全面，支持html5、flash、silverlight等多种上传方式。上传组件的具体使用请参考其官方文档。

相对于传统的上传方式，使用图片服务的不同之处在于上传之前需要到服务端获取token，然后上传文件时带上token参数即可。以uploadify为例，代码如下所示：

$('#file_upload').uploadify({
    'swf'      : 'uploadify.swf',
    'uploader' : '/file/upload', // 图片服务url
    'buttonText':'点击上传',
    'buttonImage':'btnbg.png',
    'multi'    : false,
    'formData' : {token: 'upload_token'}, // 从服务端获取的token值
    'onUploadSuccess': function (file, data, response) {
        // 上传成功回调
    },
});

plupload的使用方法类似：

var uploader = new plupload.Uploader({
    runtimes : 'html5,flash,silverlight,html4',
    flash_swf_url : 'plupload-2.3.1/js/Moxie.swf',
    silverlight_xap_url : 'plupload-2.3.1/js/Moxie.xap',
    filters : {
        max_file_size : '2mb', //文件上传大小
        mime_types: [
            {title : "Image files", extensions : "jpg,jpeg,gif,png"},
        ], // 文件上传类型
    },
    drop_element : 'dropElementId', // 拖拽上传
    browse_button : 'browseButtonId', // 浏览上传
    url : 'file/upload', // 图片服务url
    multipart_params : {token: 'upload_token'} // 从服务端获取的token值
});

uploader.init();

uploader.bind('FilesAdded', function(up, files) {});
uploader.bind('UploadProgress', function(up, file) {});
uploader.bind('Error', function(up, err) {});