PHPackages abpam/ekatte-2 - 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. [Utility & Helpers](/categories/utility) 4. / 5. abpam/ekatte-2 ActiveLibrary[Utility & Helpers](/categories/utility) abpam/ekatte-2 ============== Territorial Units classified by country, state, county, city/town/village and ready to use. 01PHP Since Nov 28Pushed 4y ago1 watchersCompare [ Source](https://github.com/ABPAM/ekatte-2)[ Packagist](https://packagist.org/packages/abpam/ekatte-2)[ RSS](/packages/abpam-ekatte-2/feed)WikiDiscussions main Synced 4w ago READMEChangelogDependenciesVersions (1)Used By (0) ЕКАТТЕ 2.0 ---------- [](#екатте-20) *Забележка: Това е версия 2.0 на пакета „ЕКАТТЕ“. За версия 1.0 - [кликнете тук](https://github.com/ABPAM/ekatte)* #### Какво е ЕКАТТЕ (като РНР пакет)? [](#какво-е-екатте-като-рнр-пакет) Списък на населените места в Р. България, изтеглени от [НСИ (Национален Статистически Институт)](https://nsi.bg), сортирани по области и общини, във вид, удобен за използване в PHP среда. \*ЕКАТТЕ - **Е**динен **К**ласификатор на **А**дминистративно-**Т**ериториалните и **Т**ериториалните **Е**диници. #### Кой би имал нужда от подобно нещо? [](#кой-би-имал-нужда-от-подобно-нещо) Разработчици, работещи върху системи за: - Електронна търговия - Застрахователни услуги - Всичко останало, при разработката на което се налага работа с населени места (от потребители и/или администратори). #### Какво е необходимо, за да използвам EKATTE? [](#какво-е-необходимо-за-да-използвам-ekatte) - php >= 5.6.0 #### Как да инсталирам EKATTE? [](#как-да-инсталирам-ekatte) В composer.json файла на своя проект добавете: ``` "require": { ... "abpam/ekatte-2": "^0.0.1" ... }, ... "scripts": { ... "setup-ekatte": [ "@putenv EKATTE_URL=\"http://www.nsi.bg/sites/default/files/files/EKATTE/Ekatte.zip\"", "ABPAM\\Ekatte\\Ekatte::setup" ], ... } ``` Запишете composer.json и изпълнете `composer install && composer run setup-ekatte` #### Как да използвам ЕКАТТЕ? (вместо документация :) ) [](#как-да-използвам-екатте-вместо-документация--) ФункцияОписаниеВръщана стойност`Oblast::getList()`Получаване на списък с всички области.Array`Oblast::getByName(string)`Получаване на информация за дадена област, търсена по име. Пример: `Oblast::getByName('Велико Търново')` - Информация за област Велико Търново.Array`Oblast::getByCode(string)`Получаване на информация за дадена област, търсена по трибуквен код (вж. „Пояснение за КОД“). Пример: `Oblast::getByCode('SHU')` - Информация за област Шумен.Array`Obshtina::getList()`Получаване на списък с всички общини.Array`Obshtina::getByName(string)`Получаване на информация за дадена община, търсена по име. Пример: `Obshtina::getByName('Чирпан')`.Array`Obshtina::getByCode(string)`Получаване на информация за дадена община, търсена по идентификационен код (вж. „Пояснение за КОД“). Пример: `Obshtina::getByCode('VAR03')` - Информация за община „Белослав“.Array`Obshtina::getListByOblastName(string)`Получаване на списък с общините в дадена област, търсена по име. Пример: `Obshtina::getListByOblastName('Благоевград')` - Списък на общините в област „Благоевград“.Array`Obshtina::getListByOblastCode(string)`Получаване на списък с общините в дадена област, търсена по трибуквен код (вж. „Пояснение за КОД“). Пример: `Obshtina::getListByOblastCode('SZR')` - Списък на общините в област „Стара Загора“.Array`Kmetstvo::getList()`Получаване на списък с всички населени места в Р. България.Array`Kmetstvo::getByName(string)`Получаване на информация за дадено кметсво, търсено по име. Пример: `Kmetstvo::getByName('гр. Свищов')` - информация за град Свищов. *Важно: При търсене НЕ Е нужно да се указва типа на кметството („гр.“, „с.“ и т.н.). Да се има предвид, обаче, че при търсене на кмество САМО по име е възможно резултатите да са повече от един. Например `Kmetstvo::getByName('Разград')` връща информация за град Разград в Североизточна България и за село Разград, Монтанско.*Array`Kmetstvo::getByCode(string)`Получаване на информация за дадено кметсво, търсено по идентификационен код (вж. „Пояснение за КОД“). Пример: `Kmetstvo::getByCode('RSE08-003')` - информация за село Ценово, Русенско.Array`Kmetstvo::getListByObshtinaName(string)`Получаване на списък с всички кметства в дадена община, търсена по име. Пример: `Kmetstvo::getListByObshtinaName('Стралджа')` - Списък с кметствата в община Стралджа.Array`Kmetstvo::getListByObshtinaCode(string)`Получаване на списък с всички кметства в дадена община, търсена по идентификационен код (вж. „Пояснение за КОД“). Пример: `Kmetstvo::getListByObshtinaCode('PAZ03')` - Списък на кметствата в община БрациговоArray`Kmetstvo::getListByOblastName(string)`Получаване на списък с всички кметства в дадена област, търсена по име. Пример: `Kmetstvo::getListByOblastName('Търговище')` - Списък с кметствата в област Търговище.Array`Kmetstvo::getListByOblastCode(string)`Получаване на списък с всички кметства в дадена област, търсена по трибуквен код (вж. „Пояснение за КОД“). Пример: `Kmetstvo::getListByOblastCode('VRC')` - Списък с кметствата в област Враца.Array#### Пояснение за КОД [](#пояснение-за-код) Когато става въпрос за области, трибуквеният код идва от екселските файлове на НСИ и представлява трибуквено представяне на всяка област на латиница. Напомня на отговора на „asl pls“ от едно време (макар и да е всеизвестен факт, че `BS KS`, а `SF RF` ;) ). Например, Старозагорска област е обозначена като „SZR“, Пловдивска като „PDV“, Бургаска като „BGS“, Софийска като „SFO“, София (като отделна област) като „SOF“ и т.н. ##### Ето и таблица с трибуквените кодове на всяка област [](#ето-и-таблица-с-трибуквените-кодове-на-всяка-област) *Трибуквен код**Област**BLG**Благоевград**BGS**Бургас**VAR**Варна**VTR**Велико Търново**VID**Видин**VRC**Враца**GAB**Габрово**DOB**Добрич**KRZ**Кърджали**KNL**Кюстендил**LOV**Ловеч**MON**Монтана**PAZ**Пазарджик**PER**Перник**PVN**Плевен**PDV**Пловдив**RAZ**Разград**RSE**Русе**SLS**Силистра**SLV**Сливен**SML**Смолян**SFO**София**SOF**София (столица)**SZR**Стара Загора**TGV**Търговище**HKV**Хасково**SHU**Шумен**JAM**Ямбол*Идентификационният код на всяка община е образуван от трибуквения код на областта + поредния номер на общината (по азбучен ред), в две цифри с водеща нула. Например, община Разлог има идентификационен код `BLG08`, а община Якоруда - `BLG14`. По подобен начин стои и въпросът с идентификационните кодове на кметствата, но там за основа е взет кода на общината, в която се намира кметството + тире + поредния номер на самото кметство, в три цифри с водеща нула. Например, град Свищов (на който автора има честта да е горд представител ;) ) се намира на територията на община Свищов, която пък е в област Велико Търново - съответно идентификационния код на гр. Свищов е `VTR08-012`. Или казано по друг начин: дванадесетото поред кметство в осмата поред община във Великотърновска област. #### Връзка с мен [](#връзка-с-мен) За въпроси и предложения, пишете ми на . Ако някой може да направи подобрения по кода, нова функционалност или каквато и да била положителна промяна - нека се чувства свободен да направи Pull Request към repo-то :) ### Health Score 14 — LowBetter than 2% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity1 Limited adoption so far Community7 Small or concentrated contributor base Maturity27 Early-stage or recently created project 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. ### Community Maintainers ![](https://www.gravatar.com/avatar/6e80560a65eb87cb907cb78c67a335713f1b904b37202204b4e5f7ff1522910e?d=identicon)[ABPAM](/maintainers/ABPAM) --- Top Contributors [![ABPAM](https://avatars.githubusercontent.com/u/1682563?v=4)](https://github.com/ABPAM "ABPAM (3 commits)") ### Embed Badge ![Health badge](/badges/abpam-ekatte-2/health.svg) ``` [![Health](https://phpackages.com/badges/abpam-ekatte-2/health.svg)](https://phpackages.com/packages/abpam-ekatte-2) ``` ### Alternatives [whitehat101/apr1-md5 Apache's APR1-MD5 algorithm in pure PHP 349.7M10](/packages/whitehat101-apr1-md5) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)