Camera360 Effect API SDK for PHP

SDK介绍

PHP版本：cURL extension, 5.3.2+

利用Camera360最先进的图像处理技术，给图片添加上百款滤镜，支持的滤镜参考滤镜列表。

特别声明：所有上传的图片和特效图都只会在服务器保存 1天，1天 后自动删除没有备份。

安装

通过 Composer，这是推荐的方式。SDK 包已经放到这里 pinguo/effectapi-php-sdk。

Composer 是PHP的依赖管理工具，你在项目中声明所依赖的东西，Composer 会找出哪个版本的包需要安装，并安装它们（将它们下载到你的项目中）。

Composer官网：https://getcomposer.org/ 中文网址：https://docs.phpcomposer.com/

安装Composer

局部安装，在项目根目录下执行命令

curl -sS https://getcomposer.org/installer | php

composer.phar 将下载到你的项目中。

全局安装，继续执行命令

mv composer.phar /usr/local/bin/composer

安装最新稳定版本SDK

composer require pinguo/effectapi-php-sdk

自动加载

Composer 准备了一个自动加载文件，可以加载 Composer 下载的库中所有的类文件。只需将下面的代码添加到项目引导文件中。

require 'vendor/autoload.php';

快速接入

在开始使用 SDK 之前，首先需要联系商务注册一个账号，并获得一对有效的密钥对 AccessKey 和 SecretKey，请妥善保管密钥对，切勿泄露。

示例：

use Camera360Authorization; use Camera360EffectManager; // 用于签名的公钥和私钥 $accessKey = 'Access_Key'; $secretKey = 'Secret_Key'; // 1.构造授权类 $authorization = new Authorization($accessKey, $secretKey); // 2.构造特效处理类 $effectManager = new EffectManager($authorization); // 3.上传图片二进制流 $uploadRet = $effectManager->upload($image); /** * 调用上传接口的其他方式 * 参数 $filter 是滤镜对应的枚举值 */ // 上传图片二进制流，并自动触发特效处理流程 // $uploadRet = $effectManager->upload($image, $filter); // 上传图片文件 // $uploadRet = $effectManager->uploadFile($filePath); // 上传图片文件，并自动触发特效处理流程 // $uploadRet = $effectManager->uploadFile($filePath, $filter); // 4.调用特效处理类的增加特效滤镜接口 $effectPicUrl = $effectManager->addFilter($uploadRet['key'], $filter);

说明：字段 $filter 参考滤镜列表。

常见问题

内部发生错误，都将抛出异常，请根据实际处理场景来捕获异常。 API 的使用 demo 可以参考 单元测试。

联系我们

如果需要帮助，请直接向 zhanglu@camera360.com 发送邮件 更详细的文档，见官方文档站 如果发现了bug， 欢迎提交 issue 如果有功能需求，欢迎提交 issue 如果要提交代码，欢迎提交 pull request

商务合作

申请地址 QQ: 2851258253 在线技术支持
周一到周五：北京时间 9:00 - 18:00

代码许可

The MIT License (MIT).详情见 License文件.