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 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.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() ?>

待办事项