PHPackages                             sequelone/laravel-vk-geo - 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. [Queues &amp; Workers](/categories/queues)
4. /
5. sequelone/laravel-vk-geo

ActiveLibrary[Queues &amp; Workers](/categories/queues)

sequelone/laravel-vk-geo
========================

Parse countries, regions and cities from vk.com api

v1.0.1(5y ago)18MITPHPPHP &gt;=7.2

Since Feb 24Pushed 5y ago1 watchersCompare

[ Source](https://github.com/SequelONE/laravel-vk-geo)[ Packagist](https://packagist.org/packages/sequelone/laravel-vk-geo)[ RSS](/packages/sequelone-laravel-vk-geo/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (2)Versions (3)Used By (0)

Laravel VK Geo
==============

[](#laravel-vk-geo)

[![GitHub license](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://raw.githubusercontent.com/sequelone/laravel-vk-geo/master/LICENSE)[![StyleCI](https://camo.githubusercontent.com/154fa99fbe4adc3623a4ada046c8dad8e8aa7662143bbc6ab632520d2e4dbf9e/68747470733a2f2f7374796c6563692e696f2f7265706f732f39333836363935312f736869656c643f6272616e63683d6d6173746572)](https://styleci.io/repos/93866951)

Пакет предоставляет удобный способ ипорта стран, регионов и городов используя api vk.com.

Пакет использует [atehnix/vk-client](https://github.com/atehnix/vk-client) для выполнения запросов. Используются **синхронные запросы**, если вы хотите постоянно обновлять данные, то используйте пакет [atehnix/laravel-vk-requester](https://github.com/atehnix/laravel-vk-requester)

Содержание
----------

[](#содержание)

- Установка
- Импорт данных
- Использование

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

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

Вы можете установить данный пакет с помощью сomposer:

```
composer require sequelone/laravel-vk-geo

```

Далее необходимо зарегистровать новый сервис-провайдер в config/app.php:

```
...
'providers' => [
    ...
     Sequelone\VkGeo\VkGeoServiceProvider::class,
],
...
```

### Конфигурация

[](#конфигурация)

Сначала необходимо создать необходимые таблицы в базе данных, для этого импортируйте файлы миграций из пакета используя artisan:

```
php artisan vendor:publish --provider=Sequelone\VkGeo\VkGeoServiceProvider

```

Также создастся файл конфигурации `config/vk-geo.php`. После чего необходимо применить миграции:

```
php artisan migrate

```

Добавьте роут в `routes/web.php`.

```
Route::get('/vkauth', [App\Http\Controllers\VkAccessTokenController::class, 'vkaccesstoken'])->name('vkaccesstoken');

```

В `.env` необходимо добавить, данные вашего vk приложения:

```
VKONTAKTE_KEY={введите здесь ID Standalone-приложения}
VKONTAKTE_SECRET={здесь защищённый ключ}
VKONTAKTE_REDIRECT_URI={здесь ссылку на страницу https://mysite.com/vkauth}

```

Также для выполнения импорта получить токен ([Где взять api токен?](https://github.com/atehnix/laravel-vk-requester#%D0%93%D0%B4%D0%B5-%D0%B2%D0%B7%D1%8F%D1%82%D1%8C-api-%D1%82%D0%BE%D0%BA%D0%B5%D0%BD)) приложения и добавить в `.env`:

```
VKONTAKTE_TOKEN={после получения токена со страницы /vkauth скопируйте и вставьте его сюда}

```

Либо переопределить токен в `config/vk-geo.php`.

Импорт осуществляется через консоль.
------------------------------------

[](#импорт-осуществляется-через-консоль)

### Импорт всех стран

[](#импорт-всех-стран)

```
php artisan vk:import-countries

```

### Импорт регионов

[](#импорт-регионов)

Импорт регионов для всех стран

```
php artisan vk:import-regions

```

Возможен также и импорт для отдельных стран по их id

```
php artisan vk:import-regions --countryId=1 --countryId=2

```

### Импорт городов

[](#импорт-городов)

Импорт городов для отдельных стран

```
php artisan vk:import-cities --countryId=1 --countryId=2

```

Импорт городов для отдельных регионов

```
php artisan vk:import-cities --regionId=1014032 --regionId=1048584

```

Если вам нужен импорт для всех стран и всех регионов, то можно запустить компанду без параметров, но данный способ не тестировался, и скорее всего будут ошибки связанные с ответом от серверов VK. Вы также можете переопределить любую из консольных команд, создав собсвтенные и отнаследовавшись от оригинальных.

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

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

Использовать пакет достаточно просто. В пакет входят eloquent модели города, региона и страны (City, Region, Country). Вы можете вызывать модели в контроллерах:

```
namespace App\Http\Controllers;

use Sequelone\VkGeo\Models\City;

class Controller
{
    protected function show($name){

        $city = City::where('title', $name)->first();

    }
}
```

У каждой модели есть `title`, `id`, у городов есть `area` (район), также настроенны связи между моделями. При необходимости можете также переопределить их.

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~0 days

Total

2

Last Release

1903d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/7eae8f6dc70ef8e7e86f9d76f7a2877fbcea11778deb1551f7eb39d7720d7752?d=identicon)[sequelone](/maintainers/sequelone)

---

Top Contributors

[![SequelONE](https://avatars.githubusercontent.com/u/14241611?v=4)](https://github.com/SequelONE "SequelONE (3 commits)")

---

Tags

phpapiclientlaravelcountriesqueuegeovkvk.comvkontaktecitiesregions

### Embed Badge

![Health badge](/badges/sequelone-laravel-vk-geo/health.svg)

```
[![Health](https://phpackages.com/badges/sequelone-laravel-vk-geo/health.svg)](https://phpackages.com/packages/sequelone-laravel-vk-geo)
```

###  Alternatives

[openai-php/laravel

OpenAI PHP for Laravel is a supercharged PHP API client that allows you to interact with the Open AI API

3.7k7.6M74](/packages/openai-php-laravel)[digitalstars/simplevk

Powerful PHP library/framework for VK API bots, supporting LongPoll &amp; Callback &amp; OAuth

883.9k3](/packages/digitalstars-simplevk)[mozex/anthropic-laravel

Anthropic PHP for Laravel is a supercharged PHP API client that allows you to interact with the Anthropic API

71226.4k1](/packages/mozex-anthropic-laravel)

PHPackages © 2026

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