PHPackages                             simonproud/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 & Workers](/categories/queues)
4. /
5. simonproud/laravel-vk-geo

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

simonproud/laravel-vk-geo
=========================

Parse countries, regions and cities from vk.com api I'ts fork of bigperson/laravel-vk-geo

2.4(5y ago)0131MITPHPPHP >=5.5.9

Since Jun 9Pushed 5y agoCompare

[ Source](https://github.com/simonproud/laravel-vk-geo)[ Packagist](https://packagist.org/packages/simonproud/laravel-vk-geo)[ RSS](/packages/simonproud-laravel-vk-geo/feed)WikiDiscussions master Synced yesterday

READMEChangelog (4)Dependencies (2)Versions (13)Used By (0)

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

[](#laravel-vk-geo)

[![GitHub license](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://raw.githubusercontent.com/bigperson/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 simonproud/laravel-vk-geo

```

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

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

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

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

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

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

```

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

```
php artisan migrate

```

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

```
VKONTAKTE_KEY=
VKONTAKTE_SECRET=
VKONTAKTE_REDIRECT_URI=

```

Также для выполнения импорта получить токен ([Где взять 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=

```

Либо переопределить токен в `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 Simonproud\VkGeo\Models\City;

class Controller
{
    protected function show($name){

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

    }
}
```

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

Лицензия
--------

[](#лицензия)

[MIT](https://raw.github.com/bigperson/laravel-vk-geo/master/LICENSE)

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 60.9% 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 ~128 days

Recently: every ~0 days

Total

10

Last Release

2105d ago

Major Versions

0.1.4 → 2.12020-08-06

### Community

Maintainers

![](https://www.gravatar.com/avatar/a0a129dff7c6b400f449847ad8eeb6af01e55b23259f1e52b3e8110f355570e7?d=identicon)[simonproud](/maintainers/simonproud)

---

Top Contributors

[![bigperson](https://avatars.githubusercontent.com/u/4757391?v=4)](https://github.com/bigperson "bigperson (14 commits)")[![simonproud](https://avatars.githubusercontent.com/u/11677473?v=4)](https://github.com/simonproud "simonproud (7 commits)")[![shmidtelson](https://avatars.githubusercontent.com/u/6944443?v=4)](https://github.com/shmidtelson "shmidtelson (2 commits)")

---

Tags

phpapiclientlaravelcountriesqueuegeovkvk.comvkontaktecitiesregions

### Embed Badge

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

```
[![Health](https://phpackages.com/badges/simonproud-laravel-vk-geo/health.svg)](https://phpackages.com/packages/simonproud-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 & Callback & 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)