https://github.com/solbianca/yii2-fias
ABANDONED * Модуль для работы с данными базы ФИАС
https://github.com/solbianca/yii2-fias
abandoned fias yii2
Last synced: about 2 months ago
JSON representation
ABANDONED * Модуль для работы с данными базы ФИАС
- Host: GitHub
- URL: https://github.com/solbianca/yii2-fias
- Owner: solbianca
- License: mit
- Created: 2016-08-19T06:28:38.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2018-06-29T05:50:17.000Z (almost 7 years ago)
- Last Synced: 2025-01-27T07:46:16.046Z (3 months ago)
- Topics: abandoned, fias, yii2
- Language: PHP
- Homepage:
- Size: 30.3 KB
- Stars: 14
- Watchers: 3
- Forks: 24
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
ABANDONED
===============
Данный репозиторий не поддерживается. Код может не работать или работать не корректно. Вы можете взять данный репозиторий за основу своего решения либо посмотреть в сторону форков.
Документация по модулю fias
============================
Модуль fias предназначен для работы с государственным адресным реестром http://fias.nalog.ru/
Структура модуля
-------------------
actions содержит действия
console содержит логику для работы приложения в консоли
base содержит модели необходимые для работы модуля в консоли
controllers содержит контроллер консольных команд
models содержит модели для работы с данными в консоли
traits содержит трейты
controllers содержит основные контроллеры модуля
helpers содержит классы хелперы
models сожержит основные модели модуля
searches содержит модели поиска
widgets содержит виджеты модуля
Module.php базовый класс модуля
Зависимости
-------------------
Модулю для работы нужно официальное jquery ui расширение (yiisoft/yii2-jui).
Установка
-------------------
Установить модуль с помощью композера:
````
composer require solbianca/yii2-fias "dev-master"
````
Применить миграции:
````
php yii migrate/up --migrationPath=@vendor/solbianca/yii2-fias/migrations
````
Настройки
-------------------
В файле конфига необходимо подключить модуль:
````
'modules' => [
....
'fias' => [
'class' => 'solbianca\fias\Module',
],
....
],
````
Задать карту контроллеров:
````
'controllerMap' => [
'fias' => [
'class' => 'solbianca\fias\console\controllers\FiasController'
]
],
````
Модулю можно указать директорию, в которую буду скачиваться архивы/распаковываться базы данных.
По умолчанию пытается скачивать/распаковывать в папку @app/runtime/fias
````
'modules' => [
....
'fias' => [
'class' => '\path\to\Module',
'directory' => path/to/directory
],
....
],
````
Консольные команды
-------------------
Для инициализации базы данных fias необходимо набрать команду:
````
php yii fias/install
````
Данный способ требует много времени, так как приложение сначало скачает архив на 3.5 гигабайта, затем его извлечет и только затем импортирует данные.
Более предпочтительный способ инициализации базы. Предварительно скачиваем базу, распаковываем, заливаем на сервер и указываем путь до нее в консольной команде.
````
php yii fias/install /path/to/files
````
В силу того что база имеет большой размер (около 20 гигабайт), импорт полной базы может продолжаться длительное время, несколько часов.
Для обновления данных базы fias используется команда. Приложение сммотрит последнюю версию данных на сервере и версию импоритрованную на сервер.
Если они разлисны, скачивает последнюю версию delta_fias и применяет ее.
````
php yii fias/update
````
Очистить директорию для скачки/распаковывания файлов (по умолчанию @app/runtime/fias):
````
php yii fias/clear-directory
````
Виджет
-----------------------
Для того что бы использовать виджет необходимо в нужном файле представления прописать:
````
= app\modules\fias\widgets\autocomplete\Autocomplete::widget() ?>
````
TO DO
-----------------------