PHPackages ngtfkx/laradeck-address-generator - 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. [Utility & Helpers](/categories/utility) 4. / 5. ngtfkx/laradeck-address-generator ActiveLibrary[Utility & Helpers](/categories/utility) ngtfkx/laradeck-address-generator ================================= Generating real addresses to create test data 1.0.0(8y ago)491[7 issues](https://github.com/ngtfkx/laradeck-address-generator/issues)MITPHPPHP ~7.0 Since Aug 24Pushed 8y ago2 watchersCompare [ Source](https://github.com/ngtfkx/laradeck-address-generator)[ Packagist](https://packagist.org/packages/ngtfkx/laradeck-address-generator)[ Docs](https://github.com/ngtfkx/laradeck-address-generator)[ RSS](/packages/ngtfkx-laradeck-address-generator/feed)WikiDiscussions master Synced 2w ago READMEChangelog (10)Dependencies (3)Versions (11)Used By (0) Laradeck Address Generator ========================== [](#laradeck-address-generator) [![Latest Version on Packagist](https://camo.githubusercontent.com/b117484e9a5a94b1965bd878911e6552a1c2f6ef7dc1781eadf2de9ae3b1f481/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6e6774666b782f6c6172616465636b2d616464726573732d67656e657261746f722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/ngtfkx/laradeck-address-generator)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Build Status](https://camo.githubusercontent.com/b6737c12c805304bb42329b7b8be57392ad6fe0df73bf18c48bcd4ab3dfe1ffd/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6e6774666b782f6c6172616465636b2d616464726573732d67656e657261746f722f6261646765732f6275696c642e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/ngtfkx/laradeck-address-generator)[![Coverage Status](https://camo.githubusercontent.com/936df2df91838145e40e221332fe3e4f3f971dec1c8090123ff59f1397dcd042/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f636f7665726167652f672f6e6774666b782f6c6172616465636b2d616464726573732d67656e657261746f722e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/ngtfkx/laradeck-address-generator/code-structure)[![Quality Score](https://camo.githubusercontent.com/0f6120ea5824b4dae404c077625d225db7b7e0ae4fb7eb359191df255dabfe78/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f6e6774666b782f6c6172616465636b2d616464726573732d67656e657261746f722e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/ngtfkx/laradeck-address-generator)[![Total Downloads](https://camo.githubusercontent.com/75ca0de273a82c52e0b921fcd573ff8696e456cad91cf700e93f6c938ed68f12/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6e6774666b782f6c6172616465636b2d616464726573732d67656e657261746f722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/ngtfkx/laradeck-address-generator) Генерация реальных адресов для нужд разработки. В отличии от Faker адреса реальныe для каждого города и их можно выводить на карту. Теперь у тестировщика не будет вопросов - почему маркер на карте не совпадает с адресом и как это объяснить клиенту/заказчику. Install ------- [](#install) Via Composer ``` $ composer require ngtfkx/laradeck-address-generator ``` Если необходимы консольные команды или подключение своих источников данных, то добавьте в файл `config/app.php` (для версий <=5.4.\*) сервис-провайдер ``` Ngtfkx\Laradeck\AddressGenerator\LaradeckAddressGeneratorServiceProvider::class, ``` Usage ----- [](#usage) Получение случайного адреса для любого из городов, который есть в пакете ``` $generator = new \Ngtfkx\Laradeck\AddressGenerator\Generator(); $address = $generator->getRandomAddress(); ``` Получение случайного адреса для любого из указанных городов ``` $generator = new \Ngtfkx\Laradeck\AddressGenerator\Generator(); $generator->setCities('Tomsk', 'nsk', 'Омск'); // можно передавать массив $generator->addCity('новосибирск'); // добавит город к ранее установленным $address = $generator->getRandomAddress(); // адрес будет для какого-то из вышеуказанных 4-х горолдов ``` Documentation ------------- [](#documentation) ### Получение адреса [](#получение-адреса) Для получения адреса существуют следующие методы - `getRandomAddress($forCity = null): Address` - получить один адрес - `getRandomAddresses(int $count, $forCity = null): Collection` - получить коллекцию с указанным кол-ом адресов По умолчанию случайный адрес может быть сгенерирован для любого из поддерживаемых городов (если алиас города не указан параметром) ### Установка города [](#установка-города) Если надо сгенерировать адрес для конкретного города(ов), то надо принудительно указать эти города. Для этого есть следующие методы - `addCity(string $city): Generator` - добавить город по его алиасу в список использованных - `addCities(...$cities): Generator` - добавить несколько городов (можно через запятую, можно массивом) - `setCities(...$cities): Generator` - добавить несколько городов, обнулись ранее добавленные ### Объект типа Address [](#объект-типа-address) Содержить следующие методы - `getFull(): string` - получить полный адрес (с городом, улицей и номером дома) - `getInsideLocality(): string` - получить адрес нутри населенного пункта (только улица и номер дома) - `getLocality(): string` - получить наименование населенного пункта - `getStreet(): string` - получить наименование улицы - `getBuilding(): string` - получить номер дома ### Структура хранения данных [](#структура-хранения-данных) Данные для генерации адресов по городам храняться в папке `data/ru` в файле `{cityId}.php` в виде массива, где `{cityId}` - id города в системе ``` return [ "1 Восточный спуск" => ["100", "101", "102"], "1-й квартал" => ["13", "2a", "3/1", "4", "5", "6"], ]; ``` Информация о списке поддерживаемых городов и их алиасах хранится в файле `data/ru/cities.php` виде массива ``` return [ '173343488' => [ 'Омск', 'Omsk', ], '173436661' => [ 'Новосибирск', 'Nsk', 'Novo-sibirsk', 'Нск', ], ]; ``` ### Подключение пользовательских данных [](#подключение-пользовательских-данных) Для подключения пользовательских данных положите файл аналогичной структуры (см. Структура хранения данных) в любое место и укажите абсолютный путь до него от корня диска. Далее подключаете данные следующим образом ``` $generator = new Generator(); $generator->loadCustomData(111, 'Нефтебаза', storage_path('app/111.php')); ``` Теперь адреса населенного пункта Нефтебаза доступны для генерации. ### Статистика [](#статистика) Для получения информации о доступных городах и адресах есть консольная команда `php artisan address:stat` ### Генерация своих файлов данных [](#генерация-своих-файлов-данных) Для генерации файла данных есть консольная команда `php artisan address:city-address-ru {city} {url} {--limit=0}` - {city} - id города в системе - {url} - первая страница города со списком улиц на сайте , например [вот такая](http://www.city-address.ru/region-70_tomsk/all-street/) - {--limit=0} - кол-во обрабатываемых страниц (0 - все) Поддерживаемые города --------------------- [](#поддерживаемые-города) - Омск. Адресов: 27 297 - Новосибирск. Адресов: 41 052 - Красноярск. Адресов: 14 628 - Барнаул. Адресов: 16 668 - Томск. Адресов: 17 859 - Сургут. Адресов: 2 649 - Белгород. Адресов: 13 524 - Брянск. Адресов: 14 844 - Иваново. Адресов: 18 333 - Сочи. Адресов: 6 885 - Магнитогорск. Адресов: 7 846 - Тверь. Адресов: 12 494 - Улан-Удэ. Адресов: 14 229 - Ставрополь. Адресов: 8 204 - Курск. Адресов: 2 327 - Калининград. Адресов: 13 618 - Тула. Адресов: 12 081 - Чебоксары. Адресов: 7 315 - Киров. Адресов: 8 966 - Липецк. Адресов: 14 182 - Пенза. Адресов: 18 877 - Набережные Челны. Адресов: 4 947 - Астрахань. Адресов: 35 539 - Рязань. Адресов: 10 751 - Новокузнецк. Адресов: 22 101 - Кемерово. Адресов: 20 679 - Оренбург. Адресов: 17 617 - Махачкала. Адресов: 1 100 - Владивосток. Адресов: 7 739 - Ярославль. Адресов: 14 571 - Хабаровск. Адресов: 16 990 - Иркутск. Адресов: 15 746 - Ульяновск. Адресов: 12 533 - Ижевск. Адресов: 13 636 - Тольятти. Адресов: 8 107 - Тюмень. Адресов: 18 074 - Саратов. Адресов: 16 236 - Краснодар. Адресов: 6 143 - Волгоград. Адресов: 37 421 - Воронеж. Адресов: 22 383 - Пермь. Адресов: 4 495 - Уфа. Адресов: 19 805 - Ростов-на-Дону. Адресов: 37 131 - Самара. Адресов: 19 083 - Челябинск. Адресов: 23 013 - Казань. Адресов: 30 572 - Нижний Новгород. Адресов: 22 949 - Екатеринбург. Адресов: 4 936 - Санкт-Петербург. Адресов: 20 138 - Москва. Адресов: 34 015 Change log ---------- [](#change-log) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Credits ------- [](#credits) - [Denis Sandal](https://github.com/ngtfkx) - [All Contributors](../../contributors) Milestones ---------- [](#milestones) - Version 1: базовая функциональность - Version 2: подключение стран, локализация, геокординаты, перевод на английский - Version 3: отвязка от фреймворка License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 25 — LowBetter than 35% of packages Maintenance0 Infrequent updates — may be unmaintained Popularity13 Limited adoption so far Community10 Small or concentrated contributor base Maturity64 Established project with proven stability Bus Factor1 Top contributor holds 98.1% 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 ~2 days Total 10 Last Release 3211d ago Major Versions 0.6.0 → 1.0.02017-09-14 PHP version history (2 changes)0.1.0PHP ~7.1 0.5.0PHP ~7.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/88ffb7c9f3e09555ebe86802abaee7c8594694b649e3409c5d475f247336ff82?d=identicon)[ngtfkx](/maintainers/ngtfkx) --- Top Contributors [![ngtfkx](https://avatars.githubusercontent.com/u/5647351?v=4)](https://github.com/ngtfkx "ngtfkx (51 commits)")[![scrutinizer-auto-fixer](https://avatars.githubusercontent.com/u/6253494?v=4)](https://github.com/scrutinizer-auto-fixer "scrutinizer-auto-fixer (1 commits)") --- Tags laraveladdressfixturesdatangtfkxlaradeckLaradeckAddressGenerator ### Code Quality TestsPHPUnit Code StylePHP\_CodeSniffer ### Embed Badge ![Health badge](/badges/ngtfkx-laradeck-address-generator/health.svg) ``` [![Health](https://phpackages.com/badges/ngtfkx-laradeck-address-generator/health.svg)](https://phpackages.com/packages/ngtfkx-laradeck-address-generator) ``` ### Alternatives [psalm/plugin-laravel Psalm plugin for Laravel 3355.3M337](/packages/psalm-plugin-laravel)[renatomarinho/laravel-page-speed Laravel Page Speed 2.5k1.7M11](/packages/renatomarinho-laravel-page-speed)[vinkius-labs/laravel-page-speed Laravel Page Speed 2.5k9.6k1](/packages/vinkius-labs-laravel-page-speed)[webwizo/laravel-shortcodes Wordpress like shortcodes for Laravel 11, 12 and 13 217700.9k8](/packages/webwizo-laravel-shortcodes)[emargareten/inertia-modal Inertia Modal is a Laravel package that lets you implement backend-driven modal dialogs for Inertia apps. 90142.9k](/packages/emargareten-inertia-modal)[xefi/faker-php-laravel Faker php integration with laravel 2618.0k](/packages/xefi-faker-php-laravel) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)