PHPackages                             brightweb/countries - 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. brightweb/countries

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

brightweb/countries
===================

Laravel package for countries, states, and cities

1.0.0(2y ago)01.0k↓77.8%MITPHPPHP ^8.0

Since May 27Pushed 2y ago1 watchersCompare

[ Source](https://github.com/Bright11/laravel-country-list-package)[ Packagist](https://packagist.org/packages/brightweb/countries)[ RSS](/packages/brightweb-countries/feed)WikiDiscussions main Synced 3w ago

READMEChangelogDependenciesVersions (2)Used By (0)

BrightWeb/Countries Documentation
---------------------------------

[](#brightwebcountries-documentation)

Welcome to the documentation for BrightWeb/Countries, a Laravel package designed to provide comprehensive data about countries, states, cities, and currency symbols. With over 246 countries supported, this package aims to streamline the process of managing geographic and currency-related information within your Laravel applications.

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

[](#installation)

### To get started with BrightWeb/Countries, follow these simple steps:

[](#to-get-started-with-brightwebcountries-follow-these-simple-steps)

Install the package via Composer:

composer require brightweb/countries
------------------------------------

[](#composer-require-brightwebcountries)

Run the migration to populate the database with country, state, and city data:

php artisan migrate

Usage
-----

[](#usage)

Once the package is installed and the database is populated, you can start leveraging its functionality within your Laravel application.

Retrieving Countries
--------------------

[](#retrieving-countries)

To retrieve a list of all countries, you can use the Country model provided by the package:

use BrightWeb\\Countries\\Models\\Country;

$countries = Country::all();

This will return a collection of all countries along with their associated data such as states, cities, and currency symbols.

Retrieving States and Cities
----------------------------

[](#retrieving-states-and-cities)

States and cities are related to countries through foreign key relationships. You can retrieve states and cities belonging to a specific country like so.

Retrieve states of a country
----------------------------

[](#retrieve-states-of-a-country)

$states = Country::find($countryId)->states;

Retrieve cities of a state
--------------------------

[](#retrieve-cities-of-a-state)

$cities = State::find($stateId)->cities;

$cities = $country->cities;

Retrieving Currency Symbols
---------------------------

[](#retrieving-currency-symbols)

$currencySymbol = Country::find($countryId)->currency;

Database Structure
------------------

[](#database-structure)

The database structure of the BrightWeb/Countries package consists of the following tables:

countries: Contains information about countries including their names and currency symbols.

states: Stores data about states or provinces within countries.

cities: Holds information about cities within states or provinces.

Contributing
------------

[](#contributing)

Contributions to the BrightWeb/Countries package are welcome! If you encounter any bugs, have feature requests, or would like to contribute code, please feel free to open an issue or submit a pull request on GitHub.

Support
-------

[](#support)

For any questions, concerns, or support requests, please don't hesitate to reach out to our me at .

License
-------

[](#license)

BrightWeb/Countries is open-source software licensed under the MIT License.

Credits
-------

[](#credits)

This package was developed and is maintained by the BrightWeb team. Special thanks to all contributors who have helped improve this package.

Thank you for choosing BrightWeb/Countries for your Laravel application! We hope it serves you well in managing geographic and currency-related data efficiently.

###  Health Score

25

—

LowBetter than 36% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity46

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

Unknown

Total

1

Last Release

758d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/73190344?v=4)[Chika](/maintainers/Chika)[@chika](https://github.com/chika)

---

Top Contributors

[![Bright11](https://avatars.githubusercontent.com/u/34070274?v=4)](https://github.com/Bright11 "Bright11 (2 commits)")

---

Tags

laravelcountriesgeographystatescitiesbrightwebchikanwazuo

### Embed Badge

![Health badge](/badges/brightweb-countries/health.svg)

```
[![Health](https://phpackages.com/badges/brightweb-countries/health.svg)](https://phpackages.com/packages/brightweb-countries)
```

###  Alternatives

[pragmarx/countries

PHP Countries and Currencies

1.9k3.4M22](/packages/pragmarx-countries)[pragmarx/countries-laravel

Countries for Laravel

1471.1M2](/packages/pragmarx-countries-laravel)[dougsisk/laravel-country-state

Country & state helper for Laravel.

1681.8M](/packages/dougsisk-laravel-country-state)[dipeshsukhia/laravel-country-state-city-data

Country State City Data Provider

8231.3k1](/packages/dipeshsukhia-laravel-country-state-city-data)[usamamuneerchaudhary/country-city-state

Country City State Data Provider for Laravel 12+

242.7k](/packages/usamamuneerchaudhary-country-city-state)[gerardojbaez/geodata

Laravel 5.2 package that provides basic geographical data like Countries, Regions and Cities.

3112.0k](/packages/gerardojbaez-geodata)

PHPackages © 2026

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