solbianca/yii2-fias

Fias base for your site

ABANDONED

Данный репозиторий не поддерживается. Код может не работать или работать не корректно. Вы можете взять данный репозиторий за основу своего решения либо посмотреть в сторону форков., _(*1)

Документация по модулю fias

Модуль fias предназначен для работы с государственным адресным реестром http://fias.nalog.ru/, _(*2)

Структура модуля

actions             содержит действия               
console             содержит логику для работы приложения в консоли
    base            содержит модели необходимые для работы модуля в консоли
    controllers     содержит контроллер консольных команд
    models          содержит модели для работы с данными в консоли
    traits          содержит трейты
controllers         содержит основные контроллеры модуля
helpers             содержит классы хелперы
models              сожержит основные модели модуля
searches            содержит модели поиска
widgets             содержит виджеты модуля
Module.php          базовый класс модуля

Зависимости

Модулю для работы нужно официальное jquery ui расширение (yiisoft/yii2-jui)., _(*3)

Установка

Установить модуль с помощью композера:, _(*4)

    composer require solbianca/yii2-fias "dev-master"

Применить миграции: php yii migrate/up --migrationPath=@vendor/solbianca/yii2-fias/migrations, _(*5)

Настройки

В файле конфига необходимо подключить модуль:, _(*6)

    'modules' => [
        ....
            'fias' => [
                'class' => 'solbianca\fias\Module',
            ],
        ....
    ],

Задать карту контроллеров:, _(*7)

'controllerMap' => [
    'fias' => [
        'class' => 'solbianca\fias\console\controllers\FiasController'
    ]
],

Модулю можно указать директорию, в которую буду скачиваться архивы/распаковываться базы данных. По умолчанию пытается скачивать/распаковывать в папку @app/runtime/fias, _(*8)

    'modules' => [
        ....
            'fias' => [
                'class' => '\path\to\Module',
                'directory' => path/to/directory
            ],
        ....
    ],

Консольные команды

Для инициализации базы данных fias необходимо набрать команду:, _(*9)

    php yii fias/install

Данный способ требует много времени, так как приложение сначало скачает архив на 3.5 гигабайта, затем его извлечет и только затем импортирует данные., _(*10)

Более предпочтительный способ инициализации базы. Предварительно скачиваем базу, распаковываем, заливаем на сервер и указываем путь до нее в консольной команде., _(*11)

    php yii fias/install /path/to/files

В силу того что база имеет большой размер (около 20 гигабайт), импорт полной базы может продолжаться длительное время, несколько часов., _(*12)

Для обновления данных базы fias используется команда. Приложение сммотрит последнюю версию данных на сервере и версию импоритрованную на сервер. Если они разлисны, скачивает последнюю версию delta_fias и применяет ее., _(*13)

    php yii fias/update

Очистить директорию для скачки/распаковывания файлов (по умолчанию @app/runtime/fias):, _(*14)

    php yii fias/clear-directory

Виджет

Для того что бы использовать виджет необходимо в нужном файле представления прописать:, _(*15)

<?= app\modules\fias\widgets\autocomplete\Autocomplete::widget() ?>

TO DO