PHPackages                             abpam/ekatte - 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

AbandonedArchivedLibrary[Utility & Helpers](/categories/utility)

abpam/ekatte
============

Списък на населените места в Р. България по Селище, Община и Област във вид на архив, готов за използване.

0.0.1(8y ago)175375MITPHPPHP >=5.3.0

Since Jun 8Pushed 4mo ago3 watchersCompare

[ Source](https://github.com/ABPAM/ekatte)[ Packagist](https://packagist.org/packages/abpam/ekatte)[ Docs](http://github.com/ABPAM/ekatte)[ RSS](/packages/abpam-ekatte/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (1)Versions (2)Used By (0)

❗This repo is archived. Please use version 2 - .

❗Този пакет е архивиран и повече не се поддържа. Моля, използвайте версия 2 - .

EKATТE
------

[](#ekatтe)

### Какво е EKATТE?

[](#какво-е-ekatтe)

###### Списък на населените места в Р. България, сортирани по области и общини, по ЕКАТТЕ (Единен Класификатор на Административно-Териториалните и Териториалните Единици), във вид, удобен за използване в PHP среда.

[](#списък-на-населените-места-в-р-българия-сортирани-по-области-и-общини-по-екатте-единен-класификатор-на-административно-териториалните-и-териториалните-единици-във-вид-удобен-за-използване-в-php-среда)

### Кой би имал нужда от подобно нещо?

[](#кой-би-имал-нужда-от-подобно-нещо)

###### Разработчици, работещи върху системи за:

[](#разработчици-работещи-върху-системи-за)

- Електронна търговия
- Застрахователни услуги
- Всичко останало, при разработката на което се налага работа с населени места (от потребители и/или администратори).

### Какво е необходимо, за да използвам EKATTE?

[](#какво-е-необходимо-за-да-използвам-ekatte)

- php >= 5.3.0 - поради наличието на namespaces, closures и др.
- ext-zip - PHP Plug-in за работа със .zip архиви. Функцията update на EKATTE изтегля .zip архив от сайта на НСИ (Национален Статистически Институт), който трябва да бъде обработен.
- nuovo/spreadsheet-reader - PHP пакет, спомагащ за прочитане на файлове от Excel. В архива от НСИ се съдържат електронни таблици (spreadsheets) в .xls формат, които трябва да бъдат прочетени, след което, информацията от тях да бъде приведена в удобен за използване вид.

### Как да инсталирам EKATTE?

[](#как-да-инсталирам-ekatte)

##### Ако разполагате с инсталиран composer глобално (сиреч, composer е инсталиран в системата Ви), просто изпълнете следната команда (в команден ред - Terminal, Konsole, Command Prompt) в папката на проекта (`cd път/до/папката` или в Windows `cd път\до\папката`), в който искате да използвате EKATTE:

[](#ако-разполагате-с-инсталиран-composer-глобално-сиреч-composer-е-инсталиран-в-системата-ви-просто-изпълнете-следната-команда-в-команден-ред---terminal-konsole-command-prompt-в-папката-на-проекта-cd-пътдопапката-или-в-windows-cd-пътдопапката-в-който-искате-да-използвате-ekatte)

```
    composer require abpam/ekatte
```

##### Ако работите с composer локално (composer архив във всеки отделен проект) -

[](#ако-работите-с-composer-локално-composer-архив-във-всеки-отделен-проект--)

```
    composer.phar require abpam/ekatte
```

##### в папката на проекта.

[](#в-папката-на-проекта)

### Как да използвам EKATTE?

[](#как-да-използвам-ekatte)

##### На първо време, трябва да обновите базата до последните данни на НСИ. Това става с помощта на файла vendor/abpam/ekatte/updater.php. През команден ред стигнете до папката `път/до/проекта/vendor/abpam/ekatte` и изпълнете:

[](#на-първо-време-трябва-да-обновите-базата-до-последните-данни-на-нси-това-става-с-помощта-на-файла-vendorabpamekatteupdaterphp-през-команден-ред-стигнете-до-папката-пътдопроектаvendorabpamekatte-и-изпълнете)

`php updater.php`

##### Ако всичко е наред, резултатът трябва да е:

[](#ако-всичко-е-наред-резултатът-трябва-да-е)

```
100%[==================================================>]

Обновено...

```

---

### *Забележка:*

[](#забележка)

*Ако по време на обновяването скриптът върне грешка, свързана с кодировка на файловете (encoding), това е проблем при прочитането на .xls файловете от пакета SpreadsheetReader на nuovo. Този проблем се разрешава като ред № 917 на файл /vendor/nuovo/spreadsheet-reader/php-excel-reader/excel\_reader2.php бъде заменен от:*

```
    $this->setUTFEncoder('iconv');
```

*на:*

```
    $this->setUTFEncoder('mb');
```

---

##### Укажете на проекта си да използва composer файловете, ако вече не сте го направили:

[](#укажете-на-проекта-си-да-използва-composer-файловете-ако-вече-не-сте-го-направили)

```