Download the PHP package liquetsoft/fias-laravel without Composer

fias-laravel

Бандл laravel для установки данных из ФИАС.

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

Установка

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

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

3. Бандл предоставляет свою конфигурацию и по умолчанию будет использовать именно её. Настоятельно рекомендуется опубликовать копию конфигурации в проект, а не использовать встроенную:

4. Можно настроить подключение к бд, которое будет использовать бандл, с помощью опции eloquent_connection:

5. Бандл предоставляет миграции, которые создадут структуру таблиц в базе данных:

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

6. Бандл пытается конвертировать записи ФИАС в объекты. Необходимо указать какие именно сущности используются (те сущности, для которых не указан класс конвертации использоваться не будут) и в какие объекты конвертируются (важно понимать, что сущность на стороне проекта может быть любой, сериализатор symfony попробует преобразовать xml в указанный объект):

   В составе бандла поставляются так же соответствующие 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. Установка ФИАС с ноля

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

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

4. Список доступных для установки и обновления версий ФИАС

5. Загрузка и распаковка архива с полной версией ФИАС

6. Установка ФИАС из указанного каталога

7. Обновление ФИАС из указанного каталога

8. Принудительная установка номера текущей версии ФИАС

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

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

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

2. поскольку в формате ГАР все данные разделены по папкам регионов, то можно исключить обработку файлов для неиспользуемых регионов

Allowed Memory Size Exhausted

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

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

1. facade/ignition:

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

   • отключите логирование запросов к базе данных:

2. laravel/telescope

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