php lib for handling genderize.io
PHP
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
src remove spl_autoload_register Aug 23, 2016
test
.gitignore
LICENSE
README
README.md
composer.json rollback Aug 23, 2016
composer.lock
index.php

README.md

php_genderize

PHP5 lib for handling genderize.io gender recognition

Basicaly, it's for guessing the gender by a given first name and using genderize.io.

Author: Bart Tyrant bartlomiej@tyranowski.pl Contributors: Luke Shaheen @tlshaheen http://github.com/tlshaheen License: The MIT License http://www.opensource.org/licenses/mit-license.php

==Usage:==

The simplest case:

$recognizer = new \Genderize\Base\Recognizer('Peter');

$peter = $recognizer->recognize();
print_r($peter);

will give:

Genderize\Base\Name Object ( [_name:protected] => Peter [_count:protected] => 4284 [_gender:protected] => male [_probability:protected] => 1.00 )

You can pass multiple names - at time of writing, genderizer.io accepts up to 10 at once

$recognizer = new \Genderize\Base\Recognizer(array('Peter', 'John'));

$namesinfo = $recognizer->recognize();
print_r($namesinfo);

will give:

array([0] => Genderize\Base\Name Object ( [_name:protected] => Peter [_count:protected] => 4284 [_gender:protected] => male [_probability:protected] => 1.00 ), [1] => Genderize\Base\Name Object ( [_name:protected] => Peter [_count:protected] => 4284 [_gender:protected] => male [_probability:protected] => 1.00 ) )

Also, country and language filters are supported:

$Recognizer = Genderize::factory();

$asia = $Recognizer->set_name('Asia')->recognize();
print_r($asia);

$asiaPL = $Recognizer->set_country_id('pl')->set_name('Asia')->recognize();
print_r($asiaPL);

... will print out:

Genderize\Base\Name Object ( [_name:protected] => Asia [_count:protected] => 97 [_gender:protected] => female [_probability:protected] => 0.99 ) Genderize\Base\Name Object ( [_name:protected] => Asia [_count:protected] => 26 [_gender:protected] => female [_probability:protected] => 1.00 [_country_id] => PL )

Have an API key from http://store.genderize.io? Use $Recognizer->set_api_key($api_key) to pass it with the request.