PHPackages                             pinguo/effectapi-php-sdk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Search &amp; Filtering](/categories/search)
4. /
5. pinguo/effectapi-php-sdk

ActiveLibrary[Search &amp; Filtering](/categories/search)

pinguo/effectapi-php-sdk
========================

Camera360 Effect Api SDK for PHP

v0.1.1(8y ago)2292MITPHPPHP &gt;=5.3.3

Since Jul 26Pushed 8y ago1 watchersCompare

[ Source](https://github.com/pinguo/effectapi-php-sdk)[ Packagist](https://packagist.org/packages/pinguo/effectapi-php-sdk)[ Docs](https://sdk.camera360.com/)[ RSS](/packages/pinguo-effectapi-php-sdk/feed)WikiDiscussions master Synced 4d ago

READMEChangelog (2)Dependencies (3)Versions (3)Used By (0)

Camera360 Effect API SDK for PHP
================================

[](#camera360-effect-api-sdk-for-php)

[![Software License](https://camo.githubusercontent.com/074b89bca64d3edc93a1db6c7e3b1636b874540ba91d66367c0e5e354c56d0ea/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e737667)](LICENSE)

SDK介绍
-----

[](#sdk介绍)

PHP版本：cURL extension, 5.3.2+

利用Camera360最先进的图像处理技术，给图片添加上百款滤镜，支持的滤镜参考[滤镜列表](https://github.com/pinguo/effectapi-php-sdk/blob/master/%E6%BB%A4%E9%95%9C%E5%88%97%E8%A1%A8.md)。

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

安装
--

[](#安装)

通过 [Composer](https://getcomposer.org/)，这是推荐的方式。SDK 包已经放到这里 [`pinguo/effectapi-php-sdk`](https://packagist.org/packages/pinguo/effectapi-php-sdk)。

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

- Composer官网：[https://getcomposer.org/](Composer)
- 中文网址：[https://docs.phpcomposer.com/](Composer_cn)

1. 安装Composer

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

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

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

    全局安装，继续执行命令

    ```
    mv composer.phar /usr/local/bin/composer
    ```
2. 安装最新稳定版本SDK

    ```
    composer require pinguo/effectapi-php-sdk
    ```
3. 自动加载

    [Composer](https://getcomposer.org/) 准备了一个自动加载文件，可以加载 [Composer](https://getcomposer.org/) 下载的库中所有的类文件。只需将下面的代码添加到项目引导文件中。

    ```
    require 'vendor/autoload.php';
    ```

快速接入
----

[](#快速接入)

在开始使用 SDK 之前，首先需要[联系商务](#%E5%95%86%E5%8A%A1%E5%90%88%E4%BD%9C)注册一个账号，并获得一对有效的密钥对 `AccessKey` 和 `SecretKey`，请妥善保管密钥对，**切勿泄露**。

示例：

```
use Camera360\Authorization;
use Camera360\EffectManager;

// 用于签名的公钥和私钥
$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` 参考[滤镜列表](https://github.com/pinguo/effectapi-php-sdk/blob/master/%E6%BB%A4%E9%95%9C%E5%88%97%E8%A1%A8.md)。

常见问题
----

[](#常见问题)

- 内部发生错误，都将抛出异常，请根据实际处理场景来捕获异常。
- API 的使用 demo 可以参考 [单元测试](https://github.com/pinguo/effectapi-php-sdk/blob/master/tests)。

联系我们
----

[](#联系我们)

- 如果需要帮助，请直接向  发送邮件
- 更详细的文档，见[官方文档站](https://developer.camera360.com/)
- 如果发现了bug， 欢迎提交 [issue](https://github.com/pinguo/effectapi-php-sdk/issues)
- 如果有功能需求，欢迎提交 [issue](https://github.com/pinguo/effectapi-php-sdk/issues)
- 如果要提交代码，欢迎提交 pull request

商务合作
------------------------------------

[](#商务合作)

- [申请地址](https://sdk.camera360.com/apply.html)
- QQ: 2851258253
- 在线技术支持
    周一到周五：北京时间 9:00 - 18:00

代码许可
----

[](#代码许可)

The MIT License (MIT).详情见 [License文件](https://github.com/pinguo/effectapi-php-sdk/blob/master/LICENSE).

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

2

Last Release

3215d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/73195cce221c441227e404e16ba55668266bcfec3b5b659c2cf344cdccb5ef53?d=identicon)[pinguo-zhanglu](/maintainers/pinguo-zhanglu)

---

Top Contributors

[![pinguo-zhanglu](https://avatars.githubusercontent.com/u/6878788?v=4)](https://github.com/pinguo-zhanglu "pinguo-zhanglu (27 commits)")

---

Tags

sdkfiltereffectcamera360

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/pinguo-effectapi-php-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/pinguo-effectapi-php-sdk/health.svg)](https://phpackages.com/packages/pinguo-effectapi-php-sdk)
```

###  Alternatives

[dms/dms-filter

DMS Filter provides Annotation based entity filtering.

96478.2k2](/packages/dms-dms-filter)[dms/dms-filter-bundle

DMS Filter Bundle, makes Annotation based entity filtering available in Symfony

78351.6k1](/packages/dms-dms-filter-bundle)[wandersonwhcr/romans

A Simple PHP Roman Numerals Library

44395.1k8](/packages/wandersonwhcr-romans)[flow-php/parquet

PHP ETL - library for reading and writing Parquet files

56143.1k8](/packages/flow-php-parquet)[silverstripe-terraformers/gridfield-rich-filter-header

Rich filter header component for GridField

1325.7k1](/packages/silverstripe-terraformers-gridfield-rich-filter-header)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
