PHPackages                             igzard/huncity-php - 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. [Search & Filtering](/categories/search)
4. /
5. igzard/huncity-php

ActiveLibrary[Search & Filtering](/categories/search)

igzard/huncity-php
==================

Searchable hungarian city list PHP library with zip code

v1.0.2(1y ago)24MITPHPPHP ^8.3.0

Since Jan 14Pushed 1y ago1 watchersCompare

[ Source](https://github.com/igzard/huncity-php)[ Packagist](https://packagist.org/packages/igzard/huncity-php)[ RSS](/packages/igzard-huncity-php/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (3)Dependencies (3)Versions (5)Used By (0)

Huncity-php
===========

[](#huncity-php)

EN: 🌐 Searchable hungarian city list - PHP library

HU: 🌐 Kereshető magyar városlista - PHP könyvtár

 [![Tests passed](https://camo.githubusercontent.com/2321c59c5575f482a28a279161b2e09b8d4056aec89e3df5ac6a675954a9afd3/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f69677a6172642f68756e636974792d7068702f74657374732e796d6c3f6c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/igzard/huncity-php/actions/workflows/tests.yml) [![Total Downloads](https://camo.githubusercontent.com/6e87fec76c14655f0e4f2c80456fd86de68a66f9f95078f240117479a7683551/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f69677a6172642f68756e636974792d706870)](https://packagist.org/packages/igzard/huncity-php) [![Latest Version](https://camo.githubusercontent.com/95d7ac38d4f025d698b6692fa8bb8e587a586f875f74a74854c9eb404bacb454/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f69677a6172642f68756e636974792d706870)](https://packagist.org/packages/igzard/huncity-php)

---

English 🇬🇧
----------

[](#english-)

> **Requires [PHP 8.3+](https://php.net/releases/)**

Getting started
---------------

[](#getting-started)

```
composer require igzard/huncity-php
```

Usage
-----

[](#usage)

### Search by city name

[](#search-by-city-name)

```
use Igzard\HuncityPhp\CitySearcher;

require __DIR__.'/../vendor/autoload.php';

$searcher = new CitySearcher();
$cities = $searcher->find('Bu');
```

### Search by zipcode

[](#search-by-zipcode)

```

use Igzard\HuncityPhp\CitySearcher;

require __DIR__.'/../vendor/autoload.php';

$searcher = (new CitySearcher())->findBy(new Igzard\HuncityPhp\Service\Search\Zipcode());
$zipcodes = $searcher->find('2194');
```

Magyar 🇭🇺
=========

[](#magyar-)

> **Szükséges [PHP 8.3+](https://php.net/releases/)**

Telepítés
---------

[](#telepítés)

```
composer require igzard/huncity-php
```

Használat
---------

[](#használat)

### Városnév alapján keresés

[](#városnév-alapján-keresés)

```
use Igzard\HuncityPhp\CitySearcher;

require __DIR__.'/../vendor/autoload.php';

$searcher = new CitySearcher();
$cities = $searcher->find('Bu');
```

### Irányítószám alapján keresés

[](#irányítószám-alapján-keresés)

```

use Igzard\HuncityPhp\CitySearcher;

require __DIR__.'/../vendor/autoload.php';

$searcher = (new CitySearcher())->findBy(new Igzard\HuncityPhp\Service\Search\Zipcode());
$zipcodes = $searcher->find('2194');
```

---

Contributing
------------

[](#contributing)

If you want to contribute to this project and make it better, your help is very welcome.

🚀 Install dependencies with **composer**:

```
make composer-install
```

✅ Run **Code quality** check:

```
make code-quality
```

👷 Run **PHPUnit** tests:

```
make phpunit
```

🎨 Run **php-cs-fixer**:

```
make cs-fix
```

🔥 Run **phpstan**:

```
make phpstan
```

**Huncity PHP** was created by **[Gergely Ignácz](https://x.com/igz4rd)** under the **[MIT license](https://opensource.org/licenses/MIT)**.

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance41

Moderate activity, may be stable

Popularity6

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~0 days

Total

3

Last Release

489d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/edf561191867ffdeb3b9d6d58cad673300a26d4523cb0e0e169da75a59c4da0f?d=identicon)[igzard](/maintainers/igzard)

---

Top Contributors

[![igzard](https://avatars.githubusercontent.com/u/10142225?v=4)](https://github.com/igzard "igzard (11 commits)")

---

Tags

cityhungarymagyarphpvarosphpziplistcityhungarymagyarvarosiranyitoszamtelepules

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/igzard-huncity-php/health.svg)

```
[![Health](https://phpackages.com/badges/igzard-huncity-php/health.svg)](https://phpackages.com/packages/igzard-huncity-php)
```

###  Alternatives

[apicart/fql

Filter Query Language

1110.6k](/packages/apicart-fql)

PHPackages © 2026

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