PHPackages lioniqs/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. lioniqs/fias-laravel ActiveLibrary[Database & ORM](/categories/database) lioniqs/fias-laravel ==================== Laravel bundle for FIAS database importer 00PHP Since Mar 6Pushed 1y agoCompare [ Source](https://github.com/lioniqs/fias-laravel)[ Packagist](https://packagist.org/packages/lioniqs/fias-laravel)[ RSS](/packages/lioniqs-fias-laravel/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependenciesVersions (1)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 15 — LowBetter than 3% of packages Maintenance34 Infrequent updates — may be unmaintained Popularity0 Limited adoption so far Community11 Small or concentrated contributor base Maturity15 Early-stage or recently created project Bus Factor1 Top contributor holds 81.7% 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. ### Community Maintainers ![](https://www.gravatar.com/avatar/b0c3918f619fd1cca0c0f2a84771cb883ecd7cb84029082a27d7d975be123c3a?d=identicon)[coolanole](/maintainers/coolanole) --- 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 (24 commits)")[![lioniqs](https://avatars.githubusercontent.com/u/42649218?v=4)](https://github.com/lioniqs "lioniqs (2 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")[![ShNURoK42](https://avatars.githubusercontent.com/u/2491495?v=4)](https://github.com/ShNURoK42 "ShNURoK42 (1 commits)") ### Embed Badge ![Health badge](/badges/lioniqs-fias-laravel/health.svg) ``` [![Health](https://phpackages.com/badges/lioniqs-fias-laravel/health.svg)](https://phpackages.com/packages/lioniqs-fias-laravel) ``` ### Alternatives [doctrine/orm Object-Relational-Mapper for PHP 10.2k285.3M6.2k](/packages/doctrine-orm)[jdorn/sql-formatter a PHP SQL highlighting library 3.9k115.1M102](/packages/jdorn-sql-formatter)[illuminate/database The Illuminate Database package. 2.8k52.4M9.4k](/packages/illuminate-database)[mongodb/mongodb MongoDB driver library 1.6k64.0M546](/packages/mongodb-mongodb)[ramsey/uuid-doctrine Use ramsey/uuid as a Doctrine field type. 90340.3M211](/packages/ramsey-uuid-doctrine)[reliese/laravel Reliese Components for Laravel Framework code generation. 1.7k3.4M16](/packages/reliese-laravel) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)