PHPackages                             hymns/microsoft-cognitive-face - 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. [API Development](/categories/api)
4. /
5. hymns/microsoft-cognitive-face

ActiveLibrary[API Development](/categories/api)

hymns/microsoft-cognitive-face
==============================

PHP client library for Face module in Microsoft Cognitive Services

v1.2(7y ago)078MITPHPPHP >=7.1

Since Oct 17Pushed 7y ago1 watchersCompare

[ Source](https://github.com/hymns/microsoft-cognitive-face)[ Packagist](https://packagist.org/packages/hymns/microsoft-cognitive-face)[ Docs](https://github.com/hymns/microsoft-cognitive-face)[ RSS](/packages/hymns-microsoft-cognitive-face/feed)WikiDiscussions master Synced yesterday

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

Microsoft Cognitive Face Service APIs Client Library for PHP
============================================================

[](#microsoft-cognitive-face-service-apis-client-library-for-php)

[![Latest Stable Version](https://camo.githubusercontent.com/117a9fcf438dcc0c20f96c2dfbe0aa8d28a0921113511bcbd8c8b94cd1b6e234/68747470733a2f2f706f7365722e707567782e6f72672f68796d6e732f6d6963726f736f66742d636f676e69746976652d666163652f762f737461626c65)](https://packagist.org/packages/hymns/microsoft-cognitive-face)[![Total Downloads](https://camo.githubusercontent.com/85f6be6e51dd997ef06ef51fb7cadbe4464826fdcf67d41263a5d99bc4352944/68747470733a2f2f706f7365722e707567782e6f72672f68796d6e732f6d6963726f736f66742d636f676e69746976652d666163652f646f776e6c6f616473)](https://packagist.org/packages/hymns/microsoft-cognitive-face)[![License](https://camo.githubusercontent.com/41115712480707fe041324d0beea9885e7d3bca2d174951383ff2b688e0ac168/68747470733a2f2f706f7365722e707567782e6f72672f68796d6e732f6d6963726f736f66742d636f676e69746976652d666163652f6c6963656e7365)](https://packagist.org/packages/hymns/microsoft-cognitive-face)

The cloud-based Face API provides developers with access to advanced face algorithms. Microsoft Cognitive Face algorithms analyze specificed face attribute detection such as age, gender, smile, hair and much more.

Requirements
------------

[](#requirements)

- [PHP 7.1.0 or higher](http://www.php.net/)

Installation
------------

[](#installation)

You can use **Composer** or simply **Download the Release**

### Composer

[](#composer)

The preferred method is via [composer](https://getcomposer.org). Follow the [installation instructions](https://getcomposer.org/doc/00-intro.md) if you do not already have composer installed.

Once composer is installed, execute the following command in your project root to install this library:

```
composer require hymns/microsoft-cognitive-face
```

Finally, be sure to include the autoloader:

```
require_once '/path/to/your-project/vendor/autoload.php';
```

### Download the Release

[](#download-the-release)

If you abhor using composer, you can download the package in its entirety. The [Releases](https://github.com/hymns/microsoft-cognitive-face/releases) page lists all stable versions. Download any file with the name `microsoft-cognitive-face-[RELEASE_NAME].zip` for a package including this library and its dependencies.

Uncompress the zip file you download, and include the autoloader in your project:

```
require_once '/path/to/microsoft-cognitive-face/vendor/autoload.php';
```

Examples
--------

[](#examples)

### Detect Faces from Image

[](#detect-faces-from-image)

```
// include your composer dependencies
require_once 'vendor/autoload.php';

$client = new \Hymns\MicrosoftCognitiveFace\Client('YOUR_APP_KEY', 'YOUR_REGION');
$faces = $client->face()->detectFacesFromImage('URL_IMAGE');

print_r($faces);
```

### Verify Two Faces

[](#verify-two-faces)

```
// include your composer dependencies
require_once 'vendor/autoload.php';

$client = new \Hymns\MicrosoftCognitiveFace\Client('YOUR_APP_KEY', 'YOUR_REGION');
$result = $client->face()->verifyTwoFaces('FACE_ID_1', 'FACE_ID_2');

print_r($result);
```

### Milestone Plan for Development

[](#milestone-plan-for-development)

- Detect Faces from Image
- Verify Two Faces
- Find Similar form FaceList
- Identify Face from PersonGroup

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity59

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 ~37 days

Total

3

Last Release

2691d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/63188e5a567b1352306b9279475af9fa5d6730b0cbb9e24d6e12bfb3b75999e0?d=identicon)[hymns](/maintainers/hymns)

---

Top Contributors

[![hymns](https://avatars.githubusercontent.com/u/232046?v=4)](https://github.com/hymns "hymns (3 commits)")

---

Tags

apimicrosoftfacecognitive

### Embed Badge

![Health badge](/badges/hymns-microsoft-cognitive-face/health.svg)

```
[![Health](https://phpackages.com/badges/hymns-microsoft-cognitive-face/health.svg)](https://phpackages.com/packages/hymns-microsoft-cognitive-face)
```

###  Alternatives

[openai-php/laravel

OpenAI PHP for Laravel is a supercharged PHP API client that allows you to interact with the Open AI API

3.7k7.6M74](/packages/openai-php-laravel)[jordikroon/google-vision

Google Vision Api for PHP (https://cloud.google.com/vision/)

6374.9k1](/packages/jordikroon-google-vision)[get-stream/stream-chat

A PHP client for Stream Chat (https://getstream.io/chat/)

301.8M2](/packages/get-stream-stream-chat)[convertkit/convertkitapi

Kit PHP SDK for the Kit API

2167.1k1](/packages/convertkit-convertkitapi)

PHPackages © 2026

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