PHPackages                             ijeffro/laravel-cities - 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. ijeffro/laravel-cities

ActiveLaravel-library

ijeffro/laravel-cities
======================

Laravel Cities is a bundle for Laravel, providing Iata Code ISO 3166 3 and country codes for all the cities.

118.2k↓100%9[1 issues](https://github.com/FLAIRUK/laravel-cities/issues)[1 PRs](https://github.com/FLAIRUK/laravel-cities/pulls)PHP

Since Oct 18Pushed 2y ago1 watchersCompare

[ Source](https://github.com/FLAIRUK/laravel-cities)[ Packagist](https://packagist.org/packages/ijeffro/laravel-cities)[ RSS](/packages/ijeffro-laravel-cities/feed)WikiDiscussions master Synced 2mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Laravel Cities
==============

[](#laravel-cities)

[![Latest Stable Version](https://camo.githubusercontent.com/ef3cafba8a13fd28ac653576f468278373726c21770636a5ea3a6d77324926dd/68747470733a2f2f706f7365722e707567782e6f72672f696a656666726f2f6c61726176656c2d6369746965732f762f737461626c65)](https://packagist.org/packages/ijeffro/laravel-cities)[![Total Downloads](https://camo.githubusercontent.com/0e4acc67c8858c86f8f1526ce42aa04f005be9b83c301129a38af4a5cc996105/68747470733a2f2f706f7365722e707567782e6f72672f696a656666726f2f6c61726176656c2d6369746965732f646f776e6c6f616473)](https://packagist.org/packages/ijeffro/laravel-cities)[![Latest Unstable Version](https://camo.githubusercontent.com/60a0d7d75878a20f07ee70e7751893e3ea4d5e26ff5b189184f41a95f7234e32/68747470733a2f2f706f7365722e707567782e6f72672f696a656666726f2f6c61726176656c2d6369746965732f762f756e737461626c65)](https://packagist.org/packages/ijeffro/laravel-cities)[![License](https://camo.githubusercontent.com/8019635bd0617f90b013f5fe6b4cc6582316891b7af9c2dac07661dbf4c7ab7e/68747470733a2f2f706f7365722e707567782e6f72672f696a656666726f2f6c61726176656c2d6369746965732f6c6963656e7365)](https://packagist.org/packages/ijeffro/laravel-cities)

Laravel Cities is a bundle for Laravel, providing Iata Code ISO 3166\_3 and country codes for all the cities.

**Please note that the dev-master version is for Laravel 5 only**

Installation
------------

[](#installation)

Run `composer require ijeffro/laravel-cities dev-master` in your Laravel root directory to install the latest version.

Or add `ijeffro/laravel-cities` to `composer.json`.

```
"ijeffro/laravel-cities": "dev-master"

```

Run `composer update` to pull down the latest version of City List.

Edit `app/config/app.php` and add the `provider` and `filter`

```
'providers' => [
    ijeffro\Cities\CitiesServiceProvider::class,
]

```

Now add the alias.

```
'aliases' => [
    'Cities' => ijeffro\Cities\CitiesFacade::class,
]

```

Model
-----

[](#model)

You can start by publishing the configuration. This is an optional step, it contains the table name and does not need to be altered. If the default name `cities` suits you, leave it. Otherwise run the following command

```
$ php artisan vendor:publish

```

Next generate the migration file:

```
$ php artisan cities:migration
$ composer dump-autoload

```

It will generate the `_setup_cities_table.php` migration and the `CitiesSeeder.php` seeder. To make sure the data is seeded insert the following code in the `seeds/DatabaseSeeder.php`

```
//Seed the cities
$this->call('CitiesSeeder');
$this->command->info('Seeded the cities!');

```

You may now run it with the artisan migrate command:

```
$ php artisan migrate --seed

```

After running this command the filled cities table will be available

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance18

Infrequent updates — may be unmaintained

Popularity30

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity41

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.

### Community

Maintainers

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

---

Top Contributors

[![ijeffro](https://avatars.githubusercontent.com/u/14099877?v=4)](https://github.com/ijeffro "ijeffro (7 commits)")

### Embed Badge

![Health badge](/badges/ijeffro-laravel-cities/health.svg)

```
[![Health](https://phpackages.com/badges/ijeffro-laravel-cities/health.svg)](https://phpackages.com/packages/ijeffro-laravel-cities)
```

PHPackages © 2026

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