ondrs/hi

Czech names and surnames greeting generator API PHP wrapper

v1.0.1 2023-03-17 09:05 UTC

Requires

• php: >=7.1
• ext-curl: *
• ext-json: *
• nette/caching: ^3.0
• nette/utils: ^3.0

Requires (Dev)

• mockery/mockery: ^1.3
• nette/tester: ^2.4

MIT

• Ondřej Plšek

• generator
• php
• api
• wrapper
• name
• czech
• greeting
• surname

README

Czech names and surnames greeting generator API PHP wrapper. Service is available at the url http://hi.ondraplsek.cz

Instalation

composer.json

"ondrs/hi": "1.0.1"

Usage

Create a new Hi instance and specify a caching storage where the downloaded content will be cached - you don't want to call the API for the same name again and again. Additionally, you can set if you are looking for a name or a surname.

$hi = new ondrs\Hi\Hi(new Nette\Caching\Storages\FileStorage('path/to/cache/dir'));
$hi->setType(ondrs\Hi\Hi::TYPE_SURNAME)

Call appropriate method (mr() or ms()) according to assumed gender. If you are not sure about the gender, call the method to().

$greeting = $hi->mr('plšek');
$greeting = $hi->to('plšek');

You will receive an sdtClass object with 4 properties or a FALSE in the case that greeting generator have not been successful.

stdClass(4) {
   nominativ => "Plšek" (6)
   vocativ => "Plšku" (6)
   type => "surname" (7)
   gender => "male" (4)
}

In the application you can get your greeting via vocativ property.

$greeting->vocativ;