PHPackages                             claytongf/laravel-world-seed - 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 &amp; Helpers](/categories/utility)
4. /
5. claytongf/laravel-world-seed

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

claytongf/laravel-world-seed
============================

A Laravel package that contains information about countries, states, cities, airports, currencies, languages and timezones

v1.1.2(1y ago)11.7kMITPHPPHP ^8.0

Since Mar 31Pushed 1y ago1 watchersCompare

[ Source](https://github.com/claytongf/laravel-world-seed)[ Packagist](https://packagist.org/packages/claytongf/laravel-world-seed)[ Docs](https://github.com/claytongf/laravel-world-seed)[ RSS](/packages/claytongf-laravel-world-seed/feed)WikiDiscussions main Synced 3w ago

READMEChangelogDependencies (1)Versions (15)Used By (0)

World Seed Package for Laravel
==============================

[](#world-seed-package-for-laravel)

This Laravel package provides data about countries, states, cities, currencies, languages, airports, translations, and timezones.

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

[](#installation)

### Install Using Composer

[](#install-using-composer)

```
composer require claytongf/laravel-world-seed
```

### Laravel

[](#laravel)

Publish the configuration file:

```
php artisan vendor:publish --provider="Claytongf\\WorldSeed\\Providers\\WorldSeedServiceProvider"
```

### Migrations

[](#migrations)

After publishing, you can run the migrations and the tables will be created.

```
php artisan migrate
```

Configurations
--------------

[](#configurations)

The config/world.php file (published in the previous step) allows customization of table names, relationship table names, relationship column names, countries to seed, progress bar display, and a list of countries being processed.

> \[!NOTE\] &gt; *Model selection for seeding is not yet customizable and will be available in future releases. Setting 'countries' or other models to true or false will not affect seeding.*

Available Commands
------------------

[](#available-commands)

### World Seed

[](#world-seed)

Seed the entire database.

Important

Run Migrations first!

```
php artisan world:add-country
```

Warning

Seeding the entire dataset can take a while.

Tip

For faster seeding, use the command below or specify country codes in the config/world.php file.

### Seed Specific Country

[](#seed-specific-country)

Add specific countries using their ISO2 or ISO3 codes:

```
php artisan world:add-country US # or USA
php artisan world:add-country USA MEX CAN # Multiple countries
php artisan world:add-country BR MEX FR ESP # Mixed ISO2 and ISO3 codes
```

Duplicate entries will be ignored.

### Remove Specific Country

[](#remove-specific-country)

Remove countries using their ISO2 or ISO3 codes:

```
php artisan world:remove-country CAN # or CA
php artisan world:remove-country CAN BRA MEX # Multiple countries
php artisan world:remove-country CA BR MX # Mixed ISO2 and ISO3 codes
```

Attempts to remove already removed countries will be ignored. For example, if you try to remove MX, CA, and BR, but MX has already been removed, the command will proceed to remove CA and BR.

### Seed Airports

[](#seed-airports)

Seed all the airports available.

Important

Seed countries first, otherwise no airports will be shown.

```
php artisan world:add-airport
```

Warning

Seeding all airports can take a while, though less time than seeding countries.

Tip

For faster seeding, use the command below or specify airport codes in the config/world.php file.

### Seed Specific Airport

[](#seed-specific-airport)

Add specific airports using their IATA or ICAO codes:

```
php artisan world:add-airport YYZ # or CYYZ
php artisan world:add-airport YYZ YYN ORL # Multiple airports
php artisan world:add-airport CYYZ ORL CGH # Mixed IATA and ICAO codes
```

Duplicate entries will be ignored.

### Remove Specific Airports

[](#remove-specific-airports)

Remove airports using their IATA or ICAO codes:

```
php artisan world:remove-airport YYZ # or CYYZ
php artisan world:remove-airport YYZ YYN ORL # Multiple airports
php artisan world:add-airport CYYZ CYYN CGH # Mixed IATA and ICAO codes
```

If an airport is already removed, it will not affect the other airports removal. Per example: if you want to remove the airports with YYZ, YYN and ORL codes, but ORL has already been removed before, the command will ignore the removed airport and continue to remove the other ones.

Retrieving Data
---------------

[](#retrieving-data)

Data retrieval currently follows standard Laravel conventions. Improved methods will be implemented in future versions.

### Models Available

[](#models-available)

- Country
- State
- City
- Currency
- Language
- Timezone
- Translation
- Airport

### Relationships

[](#relationships)

- City
    - BelongsTo State
    - BelongsTo Country
    - BelongsToMany Airport
- State
    - BelongsTo Country
- Country
    - BelongsToMany Currency
    - BelongsToMany Language
    - BelongsToMany Timezone
    - HasMany Translation
- Currency
    - BelongsToMany Country
- Language
    - BelongsToMany Country
- Timezone
    - BelongsToMany Country
- Translation
    - BelongsTo Country
- Airport
    - BelongsToMany City

Suggestions are welcome!

Package in development
----------------------

[](#package-in-development)

This package is currently in its initial version. All suggestions are welcome.

Data Integrity
--------------

[](#data-integrity)

Important

The dataset may contain inconsistencies, such as airports not linked to any city. Due to the volume of data, addressing all such issues may be time-consuming. Please report any inconsistencies you encounter.

Future Implementations
----------------------

[](#future-implementations)

- Seeding Countries, States, or Cities individually
- Optional seeding of Languages, Timezones, Currencies, and Translations
- Improved data retrieval methods

Buy me a Coffee..... or Pizza
-----------------------------

[](#buy-me-a-coffee-or-pizza)

[Buy me a Coffee or Pizza](https://www.buymeacoffee.com/botaficha)

###  Health Score

34

—

LowBetter than 75% of packages

Maintenance44

Moderate activity, may be stable

Popularity24

Limited adoption so far

Community4

Small or concentrated contributor base

Maturity50

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 ~0 days

Total

14

Last Release

446d ago

Major Versions

v0.1.7 → v1.0.02025-04-01

### Community

Maintainers

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

### Embed Badge

![Health badge](/badges/claytongf-laravel-world-seed/health.svg)

```
[![Health](https://phpackages.com/badges/claytongf-laravel-world-seed/health.svg)](https://phpackages.com/packages/claytongf-laravel-world-seed)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3345.1M337](/packages/psalm-plugin-laravel)[illuminate/pipeline

The Illuminate Pipeline package.

9348.3M267](/packages/illuminate-pipeline)[illuminate/pagination

The Illuminate Pagination package.

10533.5M991](/packages/illuminate-pagination)[illuminate/redis

The Illuminate Redis package.

8314.4M362](/packages/illuminate-redis)[illuminate/cookie

The Illuminate Cookie package.

224.5M132](/packages/illuminate-cookie)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)

PHPackages © 2026

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