PHPackages addon/kodifikator - 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. [Parsing & Serialization](/categories/parsing) 4. / 5. addon/kodifikator ActiveLibrary[Parsing & Serialization](/categories/parsing) addon/kodifikator ================= Parser and importer for the Ukrainian Codifier of Administrative-Territorial Units v1.0.1(1y ago)01CC-BY-4.0PHPPHP ^8.1 Since Jun 26Pushed 1y agoCompare [ Source](https://github.com/testapiw/kodifikator)[ Packagist](https://packagist.org/packages/addon/kodifikator)[ RSS](/packages/addon-kodifikator/feed)WikiDiscussions main Synced today READMEChangelogDependencies (4)Versions (3)Used By (0) 🇺🇦 Kodifikator Parser & Importer ==================================== [](#-kodifikator-parser--importer) **Parser and importer for the Codifier of Administrative-Territorial Units and Territorial Communities of Ukraine.** This Symfony-based project automates the process of parsing, downloading, and importing the official Ukrainian **Кодифікатор адміністративно-територіальних одиниць та територій територіальних громад КАТОТТГ** into your application. --- Source ------ [](#source) **Official government page:** 🔗 [mindev.gov.ua](https://mindev.gov.ua/diialnist/rozvytok-mistsevoho-samovriaduvannia/kodyfikator-administratyvno-terytorialnykh-odynyts-ta-terytorii-terytorialnykh-hromad) **License:** [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/deed.en) --- Features -------- [](#features) - Automatically parses the latest codifier release from the official site. - Downloads and stores XLSX, PDF, DOCX versions of the document. - Imports XLSX data into your database using Doctrine. - Batch processing for optimized performance with large datasets. - Symfony Console command and HTTP API endpoints available. --- Requirements ------------ [](#requirements) ### PHP Extensions [](#php-extensions) - `php-gd` - `php-zip` - `php-xml` - `php-mbstring` ### Composer Dependencies [](#composer-dependencies) ``` composer require guzzlehttp/guzzle composer require symfony/dom-crawler symfony/css-selector composer require phpoffice/phpspreadsheet ``` --- Installation ------------ [](#installation) 1. Clone the repository 2. Set the environment variable for storage: ``` # .env KODIFIKATOR_PATH="var/kodifikator" ``` 3. Register services in config/services.yaml ``` services: # Automatically register Doctrine repositories Kodifikator\Repository\: resource: '../addon/kodifikator/src/Repository' tags: ['doctrine.repository_service'] # Register services with parameters Kodifikator\Service\KodifikatorUploader: arguments: $storagePath: '%env(resolve:KODIFIKATOR_PATH)%' Kodifikator\Service\KodifikatorImport: arguments: $storagePath: '%env(resolve:KODIFIKATOR_PATH)%' Kodifikator\Domain\KodifikatorParser: ~ Kodifikator\Service\KodifikatorManager: ~ # Autowire other classes (e.g., Console, Controller, etc.) Kodifikator\: resource: '%kernel.project_dir%/vendor/addon/kodifikator/src/Repository' exclude: - '%kernel.project_dir%/vendor/addon/kodifikator/src/Entity' - '%kernel.project_dir%/vendor/addon/kodifikator/src/Repository' ``` 3. Register Doctrine mapping in config/packages/doctrine.yaml: ``` doctrine: orm: mappings: Kodifikator: is_bundle: false type: attribute dir: '%kernel.project_dir%/vendor/addon/kodifikator/src/Entity' prefix: 'Kodifikator\Entity' alias: Kodifikator ``` ``` php bin/console make:migration ``` 4. Ensure the storage directory exists and is writable: ``` sudo mkdir -p var/kodifikator sudo chown www-data:www-data var/kodifikator ``` Install via Composer: ``` composer require addon/kodifikator ``` --- Usage ----- [](#usage) Run the full fetch and import process via Symfony Console: ``` php bin/console kodifikator:update ``` Or call via HTTP API (if exposed): ``` GET /kodifikator/parse # Get available document links POST /kodifikator/update # Run full fetch & import process ``` --- Optimization Notes ------------------ [](#optimization-notes) This project handles large XLSX datasets efficiently: - **Batch inserts:** Processes 300 rows at a time - **Hash upsert:** Prevents duplicates using computed hash key - **Streaming:** XLSX rows are processed with minimal memory Supports large files with 10,000+ rows. --- Structure --------- [](#structure) ComponentDescription`KodifikatorParser`Parses the official government page`KodifikatorUploader`Downloads XLSX/PDF/DOCX files and stores metadata`KodifikatorImport`Reads and imports XLSX content into the database`KodifikatorController`Optional API interface for triggering actions`KodifikatorUpdateCommand`Symfony Console command for full update--- License ------- [](#license) This project uses publicly available government data under the [Creative Commons Attribution 4.0 International License (CC BY 4.0)](https://creativecommons.org/licenses/by/4.0/deed.en). ### Health Score 27 — LowBetter than 47% of packages Maintenance49 Moderate activity, may be stable Popularity1 Limited adoption so far Community2 Small or concentrated contributor base Maturity47 Maturing project, gaining track record 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 ~4 days Total 2 Last Release 368d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/7a64e32972552f929e57aebd497175b99b06c981ade505731240aeb8f9681139?d=identicon)[testapiw](/maintainers/testapiw) ### Embed Badge ![Health badge](/badges/addon-kodifikator/health.svg) ``` [![Health](https://phpackages.com/badges/addon-kodifikator/health.svg)](https://phpackages.com/packages/addon-kodifikator) ``` ### Alternatives [craftcms/cms Craft CMS 3.6k3.6M3.1k](/packages/craftcms-cms)[spatie/crawler Crawl all internal links found on a website 2.8k18.5M67](/packages/spatie-crawler)[civicrm/civicrm-core Open source constituent relationship management for non-profits, NGOs and advocacy organizations. 751291.4k43](/packages/civicrm-civicrm-core)[spatie/laravel-export Create a static site bundle from a Laravel app 674146.0k6](/packages/spatie-laravel-export)[sproutcms/cms Enterprise content management and framework 242.5k4](/packages/sproutcms-cms)[drupal/core-dev require-dev dependencies from drupal/drupal; use in addition to drupal/core-recommended to run tests from drupal/core. 2022.6M342](/packages/drupal-core-dev) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)