ridvanbaluyos/face

A PHP Library built for the Microsoft's Face API.

ridvanbaluyos/face

A PHP Library built for the Microsoft's Cognitive Services.

Cognitive Services: Face API

Table of contents

• Requirements
• Installation
• Configuration
• Usage
  • Detecting a Face
  • Analyzing Face Landmarks
  • Analyzing Face Attributes
  • Chaining options
• References

Requirements

Kindly subscribe for an API key to Microsoft's Cognitive Services API page.

Installation

Open your composer.json file and add the following to the require key:

"ridvanbaluyos/face": "v1.1"

---

After adding the key, run composer update from the command line to install the package

composer install

or

composer update

Configuration

Add your subscription key in src/Ridvanbaluyos/Face/config.json file

{
	"url" : "https://westus.api.cognitive.microsoft.com/face/v1.0/detect",
	"subscriptionKey" : "zWwPD7BGWYEArX6u6QxvS25TTsNge2Qw"
}

Usage

<?php
// namespace and autoloaders
use Ridvanbaluyos\Face\FaceDetection as FaceDetection;
require_once __DIR__ . '/vendor/autoload.php';

// let's use Justin Bieber's photo
$image = array(
    'url' => 'http://img2.timeinc.net/people/i/2014/database/140831/justin-bieber-300.jpg',
);

// instantiate face detection object
$face = new FaceDetection($image);
?>

Detecting a face

$face->getFaces();

Analyzing Face Landmarks

$face->analyzeFaceLandmarks()->getFaces();

Analyzing Face Attributes

$face->analyzeFaceAttributes()->getFaces();

Chaining options

$face->analyzeFaceLandmarks()->analyzeFaceAttributes()->getFaces();

Alternatively, you can analyze all possible options

$face->analyzeAll()->getFaces();

References

• Microsoft Cognitive Services
• Face API Documentation
• Face Open API Testing Console
• Test on RapidAPI

face's Issues

(bool)false

I have tried install and there is no error but return always (bool) false

Setting own API Key should not need modifying your package

getFaces() should return the result, not echo it