README

该仓库不再维护。代码可能无法正常工作或工作不正确。您可以将其作为自己的解决方案的基础，或者查看分支。

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安装模块

    composer require djabiev/yii2-fias

应用迁移

    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.5GB的存档，然后提取它，然后再导入数据。

初始化数据库的更优方法。预先下载数据库，解压，上传到服务器，并在控制台命令中指定其路径。

    php yii fias/install /path/to/files

由于数据库体积较大（约20GB），完整数据库的导入可能需要很长时间，数小时。

使用命令更新fias数据库的数据。应用程序将检查服务器上的最新数据版本和导入到服务器上的版本。如果它们不同，则下载最新的delta_fias版本并应用它。

    php yii fias/update

清除下载/解压文件的目录（默认为 @app/runtime/fias）

    php yii fias/clear-directory

小部件

要使用小部件，需要在适当的视图文件中指定

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

待办事项