PHP Classes

PHP User Predictor: Guess the user age, gender, etc from a picture

Recommend this page to a friend!
  Info   View files Example   View files View files (6)   DownloadInstall with Composer Download .zip   Reputation   Support forum   Blog    
Ratings Unique User Downloads Download Rankings
Not enough user ratingsTotal: 437 All time: 6,272 This week: 524Up
Version License PHP version Categories
user-predictor 1.0.0GNU General Publi...5PHP 5, Graphics, User Management, Web..., A...


This class can guess user details from a picture using the FacePlusPlus API.

It can send a request to a FacePlusPlus API to request to analyze a picture of a person with a given URL.

The service analyzes the picture and returns a guess of several details of the person like the age, race, gender, pose, or whether the person is smiling or using glasses.

Innovation Award
PHP Programming Innovation award winner
August 2015

Prize: One downloadable e-book of choice by O'Reilly
Many sites have long registration forms that are painful for the user to fill completely because they ask much more information than the user would like to be bothered to provide.

This class can help minimizing that pain by asking the user to provide a picture of himself in the beginning.

This way the class can query a Web service to analyze the picture and guess several details about the user like the approximate age, race, gender and other details.

If the guess is not accurate, the user can still fix the wrong fields. Otherwise the user does not have to be bother to fill guessed correctly.

Manuel Lemos
Picture of Samuel Adeshina
  Performance   Level  
Name: Samuel Adeshina is available for providing paid consulting. Contact Samuel Adeshina .
Classes: 19 packages by
Country: Nigeria Nigeria
Age: 25
All time rank: 5242 in Nigeria Nigeria
Week rank: 72 Up5 in Nigeria Nigeria Down
Innovation award
Innovation award
Nominee: 7x

Winner: 1x


        This package is distributed with a composer.json file.
        If you have composer installed, you have to install the contents of the file
        It creates an autoload class that contains the Unirest Class.
        For users without composer, you need to download the Unirest class provided by Mashape.
        You can find it on Github.

        After getting the necessary autoloads, you need to require the vendor/autoload.php file
        so that the Unirest class can be included in your script. Then include the photoinfo.class.php
        class too.


error_reporting(0); //suppress notices and warnings;

use Unirest\Request; //We use the Request class thats created in the Unirest namespace to make life easier later on

$photoInfo = new PhotoInfo(new Request()); //Instantiating the PhotoInfo class. The Request Class imported from the unirest namespace must be injected as a dependency into the constructor of the PhotoInfo class.

$photo = ""; //URL of the image you want to analyze

$queryString = "SELECT * FROM $photo";

$process = $photoInfo->execute($queryString);
        The execute method accepts a string as parameter. This string must be constructed exactly as a normal sql query
        would be constructed or writtten.
        the $photo variable (thats, the url of the image to be analyzed) acts as the table in this case and the features you want to get acts as the table columns. Features such as the age, gender, race, smiling, and so on of the person in the picture
        can be retrieved.
        For instance, you could say:
                "SELECT age, gender, race, smiling, pose FROM";
        Using the * symbol means you want to select all features.
        You can print_r or var_dump the $process variable to get a full look at the values returned by the execute method

echo "Predicted Age: ".$photoInfo->getAge()["value"]."<br/>";
"Age Range: ".$photoInfo->getAge()["range"]."<br/>";
        The getAge method returns an array with the following keys 'value' and 'range'.
        the value key holds the predicted age of the candidate in the supplied photo
        while the range speicifes 'a range' that the candidate could fall in age-wise
echo "Race: ".$photoInfo->getRace()["value"]."<br/>";
"Confidence That the candidate is ".$photoInfo->getRace()["value"].": ".$photoInfo->getRace()["confidence"]."<br/>";
        The getRace method also returns an array with the following keys 'value' and 'confidence'.
        the value key holds the predicted race (black, asian or white) of the candidate in the supplied photo
        while the confidence specifies how sure the algorithm is that the predicted race is correct

    /* All other methods in the class follows this pattern. These methods are:
        => getGlass() : returns a value that helps to determine whether the candidate is wearing glasses
        => isSmiling() : returns a percentage indicating whether the candidate is smiling or not
        => getGender() : returns the gender of the candidate in the supplied photo
        => getPose() : returns a list of values for determining the candidate's pose in the photo.
        => getImageHeight(): returns the height of the image
        => getWidthHeight(): returns the width of the image
        => getImageSrc(): returns the url of the image
        => getImageID(): returns a unique ID that can be used for identifying this image. (probably in a database or directory)

    You can get more details about this methods and the class entirely from the photoinfo.class.php file.

echo "Glasses: ".$photoInfo->getGlass()["value"].", ";
"Confidence : ".$photoInfo->getGlass()["confidence"]."<br/>";

"Gender: ".$photoInfo->getGender()["value"].", ";
"Confidence : ".$photoInfo->getGender()["confidence"]."<br/>";

"<img src = '".$photoInfo->getImageSrc()."' width='30%' height='300px' />";


  Files folder image Files  
File Role Description
Accessible without login Plain text file composer.json Data for dumping the necessary autoloads via composer
Accessible without login Plain text file config.ini Data configuration file
Accessible without login Plain text file example.php Example example file
Accessible without login Plain text file image-links.txt Data contains sample links that can be used to test the class' functionality
Accessible without login Plain text file LICENSE Lic. License File
Plain text file photoinfo.class.php Class main class

 Version Control Unique User Downloads Download Rankings  
This week:0
All time:6,272
This week:524Up