README

捷克名字和姓氏问候语生成API的PHP包装器。服务可在网址 http://hi.ondraplsek.cz 获取

安装

composer.json

"ondrs/hi": "1.0.1"

创建一个新的Hi实例并指定一个缓存存储，下载的内容将在此缓存中。您不想再次对同一名字调用API。此外，您可以设置您是在寻找名字还是姓氏。

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

根据假设的性别调用相应的方法（mr() 或 ms()）。如果您不确定性别，请调用 to() 方法。

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

您将收到一个具有4个属性或未成功生成问候语时返回FALSE的 sdtClass 对象。

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

在应用程序中，您可以通过 vocativ 属性获取您的问候语。

$greeting->vocativ;