PHPackages                             ondrs/hi - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. ondrs/hi

ActiveLibrary[API Development](/categories/api)

ondrs/hi
========

Czech names and surnames greeting generator API PHP wrapper

v1.0.1(3y ago)3965.9k—3.6%3[4 issues](https://github.com/ondrs/Hi/issues)[1 PRs](https://github.com/ondrs/Hi/pulls)MITPHPPHP >=7.1

Since Aug 14Pushed 1y ago2 watchersCompare

[ Source](https://github.com/ondrs/Hi)[ Packagist](https://packagist.org/packages/ondrs/hi)[ Docs](http://ondraplsek.cz)[ RSS](/packages/ondrs-hi/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (2)DependenciesVersions (11)Used By (0)

Hi
==

[](#hi)

[![Total Downloads](https://camo.githubusercontent.com/34ae09b93a6603dd045b3d87ea3eb73b513a33b85a0e83b2b5182b4b9d79ac14/68747470733a2f2f706f7365722e707567782e6f72672f6f6e6472732f68692f646f776e6c6f616473)](https://packagist.org/packages/ondrs/hi)[![CircleCI](https://camo.githubusercontent.com/bf5bd9dd51361b74187202e0d71722d06e018dc6e55e69fad2d6267bd392995a/68747470733a2f2f636972636c6563692e636f6d2f67682f6f6e6472732f48692f747265652f6d61737465722e7376673f7374796c653d737667)](https://circleci.com/gh/ondrs/Hi/tree/master)[![Latest Stable Version](https://camo.githubusercontent.com/a01037df7af5191d60f31e8018bcaf3c855f8c8f67e5c1d73ea6e11cc5693062/68747470733a2f2f706f7365722e707567782e6f72672f6f6e6472732f68692f762f737461626c65)](https://packagist.org/packages/ondrs/hi)

Czech names and surnames greeting generator API PHP wrapper. Service is available at the url

Instalation
-----------

[](#instalation)

composer.json

```
"ondrs/hi": "1.0.1"

```

Usage
-----

[](#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;

```

###  Health Score

40

—

FairBetter than 88% of packages

Maintenance24

Infrequent updates — may be unmaintained

Popularity41

Moderate usage in the ecosystem

Community14

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 87.8% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~348 days

Recently: every ~606 days

Total

10

Last Release

1159d ago

Major Versions

v0.3.1 → v1.02021-11-22

PHP version history (2 changes)v0.1.0PHP >=5.4.0

v1.0PHP >=7.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/823d0a415fb57c38c782afccc97b246979817d463dfdc0e77d40e8d85a144202?d=identicon)[ondrs](/maintainers/ondrs)

---

Top Contributors

[![ondrs](https://avatars.githubusercontent.com/u/828362?v=4)](https://github.com/ondrs "ondrs (36 commits)")[![janpecha](https://avatars.githubusercontent.com/u/637719?v=4)](https://github.com/janpecha "janpecha (2 commits)")[![RiKap](https://avatars.githubusercontent.com/u/6736715?v=4)](https://github.com/RiKap "RiKap (2 commits)")[![klimesf](https://avatars.githubusercontent.com/u/5357636?v=4)](https://github.com/klimesf "klimesf (1 commits)")

---

Tags

phpapigeneratorwrappernamesurnameczechgreeting

### Embed Badge

![Health badge](/badges/ondrs-hi/health.svg)

```
[![Health](https://phpackages.com/badges/ondrs-hi/health.svg)](https://phpackages.com/packages/ondrs-hi)
```

###  Alternatives

[crada/php-apidoc

Generate documentation for php API based application. No dependency. No framework required.

259206.9k2](/packages/crada-php-apidoc)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)