PHPackages                             nguyenvanduocit/face-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. [Utility & Helpers](/categories/utility)
4. /
5. nguyenvanduocit/face-sdk

ActiveLibrary[Utility & Helpers](/categories/utility)

nguyenvanduocit/face-sdk
========================

PHP SDK for face recognition using faceplusplus.com

v0.1-beta.1(10y ago)2171[1 PRs](https://github.com/nguyenvanduocit/FaceSDK/pulls)MITPHP

Since Oct 10Pushed 7y ago1 watchersCompare

[ Source](https://github.com/nguyenvanduocit/FaceSDK)[ Packagist](https://packagist.org/packages/nguyenvanduocit/face-sdk)[ RSS](/packages/nguyenvanduocit-face-sdk/feed)WikiDiscussions master Synced 1mo ago

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

FaceSDK
=======

[](#facesdk)

This SDK is the wrapper for faceplusplus.com's API. Provides modern ways to use the API in PHP.

Install
=======

[](#install)

It's very easy to install via composer

```
composer require nguyenvanduocit/face-sdk

```

Register API
============

[](#register-api)

This API is free to use, you can register your application at [FacePlusPlus](http://www.faceplusplus.com/) to get apiKey and apiSecretKey.

Usage
=====

[](#usage)

```
require_once '../vendor/autoload.php';
use FaceSDK\Node\RecognizedImage;
$faceAPI = new \FaceSDK\FaceSDK( 'YOUR_API', 'YOUR_API', 'http://apicn.faceplusplus.com' );
$response  = $faceAPI->post( '/detection/detect', [
	'url' => 'http://2anhdep.vn/wp-content/uploads/2014/11/anh-ngoc-trinh-dep-trong-nhung-bo-noi-y-xuyen-thau-khien-nguoi-xem-do-mat-6.jpg',
	'attribute'=>'glass,gender,age,race,smiling,glass,pose'
] );

/** @var RecognizedImage $detectedImage */
$detectedImage = $response->getRecognizedImage();
var_dump('$detectedImage', $detectedImage);

/** @var \FaceSDK\Node\RecognizedFace[] $faces */
$faces = $detectedImage->getFaces();
var_dump('$faces', $faces);

/** @var \FaceSDK\Node\RecognizedFaceAttribute $attrs */
$attrs =  $faces[0]->getAttributes();
var_dump('$attrs', $attrs);
```

Example
=======

[](#example)

There are two example in folder example :

- face-hightlight.php : Draw a rectangle around main face, and tell if she/he is smiling
- face-recognize.php : The demo with the example code below.

TODO
====

[](#todo)

- Implement all API from [FacePlusPlus Doc](http://www.faceplusplus.com/api-overview/)
- Improve Exception

Contribute
==========

[](#contribute)

Feel free to make PR

Development
===========

[](#development)

This SDK was shipped with many implement and lesson from Facebook PHP SDK.

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity50

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

Unknown

Total

1

Last Release

3873d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/ee57c1f29a4947db19fe94f46fc0e1cdfe95800a17c40f88bd807d910cc17e25?d=identicon)[nguyenvanduocit](/maintainers/nguyenvanduocit)

---

Top Contributors

[![nguyenvanduocit](https://avatars.githubusercontent.com/u/1256953?v=4)](https://github.com/nguyenvanduocit "nguyenvanduocit (19 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/nguyenvanduocit-face-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/nguyenvanduocit-face-sdk/health.svg)](https://phpackages.com/packages/nguyenvanduocit-face-sdk)
```

###  Alternatives

[shlinkio/shlink

A self-hosted and PHP-based URL shortener application with CLI and REST interfaces

4.8k4.3k](/packages/shlinkio-shlink)[ralphjsmit/laravel-helpers

A package containing handy helpers for your Laravel-application.

13704.6k2](/packages/ralphjsmit-laravel-helpers)[dhlparcel/magento2-plugin

DHL Parcel plugin for Magento 2

11180.5k2](/packages/dhlparcel-magento2-plugin)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)

PHPackages © 2026

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