PHPackages                             liquetsoft/fias-laravel - 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. [Database & ORM](/categories/database)
4. /
5. liquetsoft/fias-laravel

ActiveLibrary[Database & ORM](/categories/database)

liquetsoft/fias-laravel
=======================

Laravel bundle for FIAS database importer

v14.1.1(1y ago)3514.1k↓52.8%10[1 issues](https://github.com/liquetsoft/fias-laravel/issues)MITPHPPHP >=8.2CI failing

Since Oct 14Pushed 1y ago3 watchersCompare

[ Source](https://github.com/liquetsoft/fias-laravel)[ Packagist](https://packagist.org/packages/liquetsoft/fias-laravel)[ RSS](/packages/liquetsoft-fias-laravel/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (9)Versions (51)Used By (0)

fias-laravel
============

[](#fias-laravel)

[![Latest Stable Version](https://camo.githubusercontent.com/a147215cb8019ad0a8571954ff93aefe146b52920b24d6ac5371131ff645e17a/68747470733a2f2f706f7365722e707567782e6f72672f6c6971756574736f66742f666961732d6c61726176656c2f76)](https://packagist.org/packages/liquetsoft/fias-laravel)[![Total Downloads](https://camo.githubusercontent.com/08c2cc2cd077f5b978eb4c9569c579706233ffe6fd6a42eda494c1fe4984556b/68747470733a2f2f706f7365722e707567782e6f72672f6c6971756574736f66742f666961732d6c61726176656c2f646f776e6c6f616473)](https://packagist.org/packages/liquetsoft/fias-laravel)[![License](https://camo.githubusercontent.com/2b7114622daf53b2672466760e955a1da74cc9260f496d6abb354ebdfdd499cf/68747470733a2f2f706f7365722e707567782e6f72672f6c6971756574736f66742f666961732d6c61726176656c2f6c6963656e7365)](https://packagist.org/packages/liquetsoft/fias-laravel)[![Build Status](https://github.com/liquetsoft/fias-laravel/workflows/liquetsoft_fias/badge.svg)](https://github.com/liquetsoft/fias-laravel/actions?query=workflow%3A%22liquetsoft_fias%22)

Бандл laravel для установки данных из [ФИАС](https://fias.nalog.ru/).

Для установки ФИАС используются xml-файлы, ссылки на которые предоставляются SOAP-сервисом информирования ФИАС.

Установка
---------

[](#установка)

1. Установить пакет с помощью composer:

    ```
    composer require liquetsoft/fias-laravel
    ```
2. Бандл следует стандартной структуре, поэтому на `laravel >=5.5` зарегистрируется автоматически с помощью `Package Discovery`. Для более ранних версий провайдер нужно зарегистрировать самостоятельно, добавив его в `config/app.php`:

    ```
    'providers' => [
        // Other Service Providers
        Liquetsoft\Fias\Laravel\LiquetsoftFiasBundle\LiquetsoftFiasBundleServiceProvider::class,
    ],
    ```
3. Бандл предоставляет свою конфигурацию и по умолчанию будет использовать именно её. Настоятельно рекомендуется опубликовать копию конфигурации в проект, а не использовать встроенную:

    ```
    php artisan vendor:publish --provider="Liquetsoft\Fias\Laravel\LiquetsoftFiasBundle\LiquetsoftFiasBundleServiceProvider"
    ```
4. Можно настроить подключение к бд, которое будет использовать бандл, с помощью опции `eloquent_connection`:

    ```
    // config/liquetsoft_fias.php
    'eloquent_connection' => 'custom_connection',
    ```
5. Бандл предоставляет миграции, которые создадут структуру таблиц в базе данных:

    ```
    php artisan migrate
    ```

    Миграции можно отключить с помощью опции `allow_bundle_migrations`, в случае если структура не подходит или является избыточной:

    ```
    // config/liquetsoft_fias.php
    'allow_bundle_migrations' => false,
    ```
6. Бандл пытается конвертировать записи ФИАС в объекты. Необходимо указать какие именно сущности используются (те сущности, для которых не указан класс конвертации использоваться не будут) и в какие объекты конвертируются (важно понимать, что сущность на стороне проекта может быть любой, [сериализатор symfony](https://symfony.com/doc/current/components/serializer.html) попробует преобразовать xml в указанный объект):

    ```
    // config/liquetsoft_fias.php
    /*
     * Имя класса для сущности, которая хранит историю версий ФИАС.
     */
    'version_manager_entity' => FiasVersion::class,
    /*
     * Связка между сущностями ФИАС и моделями в проекте.
     */
    'entity_bindings' => [
        'ADDR_OBJ' => AddrObj::class,
        'ADDR_OBJ_DIVISION' => AddrObjDivision::class,
        'ADDR_OBJ_TYPES' => AddrObjTypes::class,
        'ADM_HIERARCHY' => AdmHierarchy::class,
        'APARTMENTS' => Apartments::class,
        'APARTMENT_TYPES' => ApartmentTypes::class,
        'CARPLACES' => Carplaces::class,
        'CHANGE_HISTORY' => ChangeHistory::class,
        'HOUSES' => Houses::class,
        'HOUSE_TYPES' => HouseTypes::class,
        'MUN_HIERARCHY' => MunHierarchy::class,
        'NORMATIVE_DOCS' => NormativeDocs::class,
        'NORMATIVE_DOCS_KINDS' => NormativeDocsKinds::class,
        'NORMATIVE_DOCS_TYPES' => NormativeDocsTypes::class,
        'OBJECT_LEVELS' => ObjectLevels::class,
        'OPERATION_TYPES' => OperationTypes::class,
        'PARAM' => Param::class,
        'PARAM_TYPES' => ParamTypes::class,
        'REESTR_OBJECTS' => ReestrObjects::class,
        'ROOMS' => Rooms::class,
        'ROOM_TYPES' => RoomTypes::class,
        'STEADS' => Steads::class,
    ],
    ```

    В составе бандла поставляются так же соответствующие eloquent-модели и ресурсные классы:

    - `Liquetsoft\Fias\Laravel\LiquetsoftFiasBundle\Entity\AddrObj`,
    - `Liquetsoft\Fias\Laravel\LiquetsoftFiasBundle\Entity\AddrObjDivision`,
    - `Liquetsoft\Fias\Laravel\LiquetsoftFiasBundle\Entity\AddrObjTypes`,
    - `Liquetsoft\Fias\Laravel\LiquetsoftFiasBundle\Entity\AdmHierarchy`,
    - `Liquetsoft\Fias\Laravel\LiquetsoftFiasBundle\Entity\Apartments`,
    - `Liquetsoft\Fias\Laravel\LiquetsoftFiasBundle\Entity\ApartmentTypes`,
    - `Liquetsoft\Fias\Laravel\LiquetsoftFiasBundle\Entity\Carplaces`,
    - `Liquetsoft\Fias\Laravel\LiquetsoftFiasBundle\Entity\ChangeHistory`,
    - `Liquetsoft\Fias\Laravel\LiquetsoftFiasBundle\Entity\Houses`,
    - `Liquetsoft\Fias\Laravel\LiquetsoftFiasBundle\Entity\HouseTypes`,
    - `Liquetsoft\Fias\Laravel\LiquetsoftFiasBundle\Entity\MunHierarchy`,
    - `Liquetsoft\Fias\Laravel\LiquetsoftFiasBundle\Entity\NormativeDocs`,
    - `Liquetsoft\Fias\Laravel\LiquetsoftFiasBundle\Entity\NormativeDocsKinds`,
    - `Liquetsoft\Fias\Laravel\LiquetsoftFiasBundle\Entity\NormativeDocsTypes`,
    - `Liquetsoft\Fias\Laravel\LiquetsoftFiasBundle\Entity\ObjectLevels`,
    - `Liquetsoft\Fias\Laravel\LiquetsoftFiasBundle\Entity\OperationTypes`,
    - `Liquetsoft\Fias\Laravel\LiquetsoftFiasBundle\Entity\Param`,
    - `Liquetsoft\Fias\Laravel\LiquetsoftFiasBundle\Entity\ParamTypes`,
    - `Liquetsoft\Fias\Laravel\LiquetsoftFiasBundle\Entity\ReestrObjects`,
    - `Liquetsoft\Fias\Laravel\LiquetsoftFiasBundle\Entity\Rooms`,
    - `Liquetsoft\Fias\Laravel\LiquetsoftFiasBundle\Entity\RoomTypes`,
    - `Liquetsoft\Fias\Laravel\LiquetsoftFiasBundle\Entity\Steads`.

Использование
-------------

[](#использование)

Бандл предоставляет несколько значимых команды консоли:

1. Установка ФИАС с ноля

    ```
    php artisan liquetsoft:fias:install
    ```
2. Обновление ФИАС через дельту (установка запускается только в первый раз, а обновление следует поставить в качестве задачи для `cron`)

    ```
    php artisan liquetsoft:fias:update
    ```
3. Текущий статус серверов ФИАС (сервис информирования или сервер с файлами могут быть недоступны по тем или иным причинам)

    ```
    php artisan liquetsoft:fias:status
    ```
4. Список доступных для установки и обновления версий ФИАС

    ```
    php artisan liquetsoft:fias:versions
    ```
5. Загрузка и распаковка архива с полной версией ФИАС

    ```
    php artisan liquetsoft:fias:download /path/to/download latest --extract
    ```
6. Установка ФИАС из указанного каталога

    ```
    php artisan liquetsoft:fias:install_from_folder /path/to/extracted/fias
    ```
7. Обновление ФИАС из указанного каталога

    ```
    php artisan liquetsoft:fias:update_from_folder /path/to/extracted/fias
    ```
8. Принудительная установка номера текущей версии ФИАС

    ```
    php artisan liquetsoft:fias:version_set 20160101
    ```

Производительность
------------------

[](#производительность)

Есть несколько возможностей ускорить импорт, используя настройки бандла:

1. убрать неиспользуемые сущности; к примеру, если информация о парковочных местах не требуется, то можно отключить соответствие для `CARPLACES`

    ```
    // config/liquetsoft_fias.php
    'entity_bindings' => [
        // 'CARPLACES' => Carplaces::class,
    ],
    ```
2. поскольку в формате ГАР все данные разделены по папкам регионов, то можно исключить обработку файлов для неиспользуемых регионов

    ```
    // config/liquetsoft_fias.php
    'files_filter' => [
        "#^.+/extracted/30/AS_.+$#", // разрешает все данные для региона
        "#^.+/extracted/AS_.+$#",    // разрешает общие словари
        // все остальные файлы будут проигнорированы
    ],
    ```

Allowed Memory Size Exhausted
-----------------------------

[](#allowed-memory-size-exhausted)

В некоторых установках laravel во время установки ФИАС возникает ошибка из-за недостатка оперативной памяти для скрипта. Это связано с пакетами для дебага и логирования. Для установки ФИАС следует либо отключать эти пакеты совсем, либо отключать обработку запросов к базе данных.

Известные конфликты:

1. **facade/ignition**:

    - опубликуйте конфигурационный файл, если он еще не опубликован, с помощью команды:

        ```
        php artisan vendor:publish --provider="Facade\Ignition\IgnitionServiceProvider" --tag="flare-config"
        ```
    - отключите логирование запросов к базе данных:

        ```
        //в config/flare.php
        'reporting' => [
            'report_queries' => false,
            'report_query_bindings' => false,
        ],
        ```
2. **laravel/telescope**

    - отключите все логирование для консольных команд

        ```
        // в config/telescope.php
        'ignore_commands' => [
            'liquetsoft:fias*',
        ],
        ```

###  Health Score

51

—

FairBetter than 96% of packages

Maintenance48

Moderate activity, may be stable

Popularity38

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity83

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 81.2% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~41 days

Recently: every ~51 days

Total

50

Last Release

372d ago

Major Versions

v9.1.0 → v10.0.02021-09-14

v10.0.0 → v11.0.02022-07-24

v11.0.1 → v12.0.02022-12-07

v12.1.0 → v13.0.02024-09-25

v13.1.0 → v14.0.02024-10-17

PHP version history (4 changes)v1.0.0PHP >=7.2.0

v8.0.0PHP >=7.3

v11.0.0PHP >=8.0

v13.0.0PHP >=8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/ac7bd046ef4961c2d910e6d11354f647a5166cc536852295d41533b633c05ceb?d=identicon)[liquetsoft](/maintainers/liquetsoft)

---

Top Contributors

[![marvin255](https://avatars.githubusercontent.com/u/2802915?v=4)](https://github.com/marvin255 "marvin255 (125 commits)")[![liquetsoft](https://avatars.githubusercontent.com/u/49859130?v=4)](https://github.com/liquetsoft "liquetsoft (26 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")[![lioniqs](https://avatars.githubusercontent.com/u/42649218?v=4)](https://github.com/lioniqs "lioniqs (1 commits)")[![ShNURoK42](https://avatars.githubusercontent.com/u/2491495?v=4)](https://github.com/ShNURoK42 "ShNURoK42 (1 commits)")

---

Tags

fiasfias-laravellaravelphpphplaravelfias

###  Code Quality

TestsPHPUnit

Static AnalysisPsalm

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/liquetsoft-fias-laravel/health.svg)

```
[![Health](https://phpackages.com/badges/liquetsoft-fias-laravel/health.svg)](https://phpackages.com/packages/liquetsoft-fias-laravel)
```

###  Alternatives

[spiritix/lada-cache

A Redis based, automated and scalable database caching layer for Laravel

591444.8k2](/packages/spiritix-lada-cache)[glushkovds/phpclickhouse-laravel

Adapter of the most popular library https://github.com/smi2/phpClickHouse to Laravel

2031.2M2](/packages/glushkovds-phpclickhouse-laravel)[io238/laravel-iso-countries

Ready-to-use Laravel models and relations for country (ISO 3166), language (ISO 639-1), and currency (ISO 4217) information with multi-language support.

5462.3k](/packages/io238-laravel-iso-countries)[sebastiaanluca/laravel-boolean-dates

Automatically convert Eloquent model boolean attributes to dates (and back).

40111.7k1](/packages/sebastiaanluca-laravel-boolean-dates)[api-platform/laravel

API Platform support for Laravel

59126.4k6](/packages/api-platform-laravel)[ntanduy/cloudflare-d1-database

Easy configuration and setup for D1 Database connections in Laravel.

215.4k](/packages/ntanduy-cloudflare-d1-database)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)