PHPackages                             emmadonjo/naija - 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. emmadonjo/naija

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

emmadonjo/naija
===============

Naija is a PHP package that provides data about States, Local Government Areas, cities, and towns in Nigeria.

v1.4.0(2w ago)21.0kMITPHPPHP &gt;=8CI passing

Since Jul 31Pushed 3w ago1 watchersCompare

[ Source](https://github.com/emmadonjo/naija)[ Packagist](https://packagist.org/packages/emmadonjo/naija)[ RSS](/packages/emmadonjo-naija/feed)WikiDiscussions main Synced 3d ago

READMEChangelog (7)Dependencies (2)Versions (11)Used By (0)

[![Build Status](https://github.com/emmadonjo/naija/actions/workflows/tests.yml/badge.svg)](https://github.com/emmadonjo/naija/actions)[![Total Downloads](https://camo.githubusercontent.com/c3a7332dec25b67024043a8176be370f498f83333c85676f7ebcd8a30165cbd9/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f656d6d61646f6e6a6f2f6e61696a61)](https://packagist.org/packages/emmadonjo/naija)[![Latest Stable Version](https://camo.githubusercontent.com/24ea3052935c19883b40a27f1432740da09c78b834d022f591491e8dcffb5863/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f656d6d61646f6e6a6f2f6e61696a61)](https://packagist.org/packages/emmadonjo/naija)[![License](https://camo.githubusercontent.com/fd267e36247a8cf1004fe39c09d8eafc56365f3bea16603dd9577f7a000348cb/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f656d6d61646f6e6a6f2f6e61696a61)](https://packagist.org/packages/emmadonjo/naija)

Naija is a PHP package that provides data about States, Local Government Areas, cities, and towns in Nigeria.

This package is inspired by .

With this package you can retrieve the following state-related information:

- Name
- Capital
- Political Zone
- Creation Date
- Population - Male and female
- Website
- Logo
- Flag
- Nick Name
- Languages
- Local Governments Areas
- Areas - villages, towns, and cities

Usage
-----

[](#usage)

Install via:

```
    composer require emmadonjo/naija
```

```
use Emmadonjo\Naija\Naija;

// get list of states with minimal information
$states = Naija::states();

// get the comprehensive information of a state
$state = Naija::state('Abia');

// get all the attributes of a state
$state->getAttributes();

// get name
$state->getName();

// get nickname
$state->getNickName();

// get official name
$state->getOfficialName();

// get short code
$state->getShortCode();

// get capital
$state->getCapital();

// get geo political zone
$state->getGeoPoliticalZone();

// get date created
$state->getDateCreated();

// get population
$state->getPopulation();

// get website
$state->getWebsite();

// get logo
$state->getLogo();

// get flag
$state->getFlag();

// get languages
$state->getLanguages();

// get LGAs
$state->getLgas();

// get areas - villages, cities, and towns
$state->getAreas();
```

**Display assets - logos and flags**To display logos and flags of states, you can copy the assets to the `images` folder in the accessible location of your application.

For example, if you are developing with laravel, copy:

- `resources/logos` to `public/images/logos`, and
- `resources/flags` to `public/images/flags`

Then you can access the assets as follows:

- `/images/logos/abia.png`
- `/images/flags/abia.png`

To Do
-----

[](#to-do)

- Populate areas (villages, cities, and towns) for most of the remaining states

Sources
-------

[](#sources)

- **Wikipedia**

    - [https://en.wikipedia.org/wiki/States\_of\_Nigeria](https://en.wikipedia.org/wiki/States_of_Nigeria)
    - [https://en.wikipedia.org/wiki/List\_of\_nicknames\_of\_Nigerian\_states](https://en.wikipedia.org/wiki/List_of_nicknames_of_Nigerian_states)
    - [https://en.wikipedia.org/wiki/List\_of\_villages\_in\_Osun\_State](https://en.wikipedia.org/wiki/List_of_villages_in_Osun_State)
    - [https://en.wikipedia.org/wiki/List\_of\_villages\_in\_Adamawa\_State](https://en.wikipedia.org/wiki/List_of_villages_in_Adamawa_State)
    - [https://en.wikipedia.org/wiki/Akwa\_Ibom\_State](https://en.wikipedia.org/wiki/Akwa_Ibom_State)
    - [https://en.wikipedia.org/wiki/List\_of\_villages\_in\_Akwa\_Ibom\_State](https://en.wikipedia.org/wiki/List_of_villages_in_Akwa_Ibom_State)
    - [https://en.wikipedia.org/wiki/Anambra\_State](https://en.wikipedia.org/wiki/Anambra_State)
    -
    -
    -
    - [https://en.wikipedia.org/wiki/Bauchi\_State](https://en.wikipedia.org/wiki/Bauchi_State)
    - [https://en.wikipedia.org/wiki/List\_of\_villages\_in\_Bauchi\_State](https://en.wikipedia.org/wiki/List_of_villages_in_Bauchi_State)
    - [https://en.wikipedia.org/wiki/Bayelsa\_State](https://en.wikipedia.org/wiki/Bayelsa_State)
    - [https://en.wikipedia.org/wiki/List\_of\_villages\_in\_Bayelsa\_State](https://en.wikipedia.org/wiki/List_of_villages_in_Bayelsa_State)
    -
    - [https://en.wikipedia.org/wiki/Ogbia\_Local\_Government\_Area](https://en.wikipedia.org/wiki/Ogbia_Local_Government_Area)
    - [https://en.wikipedia.org/wiki/Southern\_Ijaw\_Local\_Government\_Area](https://en.wikipedia.org/wiki/Southern_Ijaw_Local_Government_Area)
    - [https://en.wikipedia.org/wiki/Benue\_State](https://en.wikipedia.org/wiki/Benue_State)
    - [https://en.wikipedia.org/wiki/List\_of\_villages\_in\_Benue\_State](https://en.wikipedia.org/wiki/List_of_villages_in_Benue_State)
    -
    -
    - [https://en.wikipedia.org/wiki/Borno\_State](https://en.wikipedia.org/wiki/Borno_State)
    - [https://en.wikipedia.org/wiki/List\_of\_villages\_in\_Borno\_State](https://en.wikipedia.org/wiki/List_of_villages_in_Borno_State)
    -
    - [https://en.wikipedia.org/wiki/Hawul\_Local\_Government\_Area](https://en.wikipedia.org/wiki/Hawul_Local_Government_Area)
    - [https://en.wikipedia.org/wiki/Cross\_River\_State](https://en.wikipedia.org/wiki/Cross_River_State)
    - [https://en.wikipedia.org/wiki/List\_of\_villages\_in\_Cross\_River\_State](https://en.wikipedia.org/wiki/List_of_villages_in_Cross_River_State)
    - [https://en.wikipedia.org/wiki/Abi,\_Cross\_River](https://en.wikipedia.org/wiki/Abi,_Cross_River)
    -
    -
    - [https://en.wikipedia.org/wiki/Yala,\_Nigeria](https://en.wikipedia.org/wiki/Yala,_Nigeria)
    - [https://en.wikipedia.org/wiki/Delta\_State](https://en.wikipedia.org/wiki/Delta_State)
    - [https://en.wikipedia.org/wiki/List\_of\_villages\_in\_Delta\_State](https://en.wikipedia.org/wiki/List_of_villages_in_Delta_State)
    - [https://en.wikipedia.org/wiki/Aniocha\_North](https://en.wikipedia.org/wiki/Aniocha_North)
    - [https://en.wikipedia.org/wiki/Aniocha\_South](https://en.wikipedia.org/wiki/Aniocha_South)
    -
    -
    - [https://en.wikipedia.org/wiki/Ethiope\_East](https://en.wikipedia.org/wiki/Ethiope_East)
    - [https://en.wikipedia.org/wiki/Ika\_North\_East](https://en.wikipedia.org/wiki/Ika_North_East)
    - [https://en.wikipedia.org/wiki/Ika\_South](https://en.wikipedia.org/wiki/Ika_South)
    - [https://en.wikipedia.org/wiki/Isoko\_North](https://en.wikipedia.org/wiki/Isoko_North)
    - [https://en.wikipedia.org/wiki/Isoko\_South](https://en.wikipedia.org/wiki/Isoko_South)
    - [https://en.wikipedia.org/wiki/Ndokwa\_West](https://en.wikipedia.org/wiki/Ndokwa_West)
    - [https://en.wikipedia.org/wiki/Ughelli\_North](https://en.wikipedia.org/wiki/Ughelli_North)
    - [https://en.wikipedia.org/wiki/Ughelli\_South](https://en.wikipedia.org/wiki/Ughelli_South)
    -
    - [https://en.wikipedia.org/wiki/Warri\_South\_West](https://en.wikipedia.org/wiki/Warri_South_West)
    - [https://en.wikipedia.org/wiki/Ebonyi\_State](https://en.wikipedia.org/wiki/Ebonyi_State)
    - [https://en.wikipedia.org/wiki/List\_of\_villages\_in\_Ebonyi\_State](https://en.wikipedia.org/wiki/List_of_villages_in_Ebonyi_State)
    - [https://en.wikipedia.org/wiki/Afikpo\_North](https://en.wikipedia.org/wiki/Afikpo_North)
    - [https://en.wikipedia.org/wiki/Afikpo\_South](https://en.wikipedia.org/wiki/Afikpo_South)
    - [https://en.wikipedia.org/wiki/Ezza\_South](https://en.wikipedia.org/wiki/Ezza_South)
    - [https://en.wikipedia.org/wiki/Ikwo\_(local\_government)](https://en.wikipedia.org/wiki/Ikwo_(local_government))
    -
    - [https://en.wikipedia.org/wiki/Izzi\_(Ebonyi)](https://en.wikipedia.org/wiki/Izzi_(Ebonyi))
    -
    -
    - [https://en.wikipedia.org/wiki/Onicha,\_Ebonyi](https://en.wikipedia.org/wiki/Onicha,_Ebonyi)
    - [https://en.wikipedia.org/wiki/Edo\_State](https://en.wikipedia.org/wiki/Edo_State)
    - [https://en.wikipedia.org/wiki/List\_of\_villages\_in\_Edo\_State](https://en.wikipedia.org/wiki/List_of_villages_in_Edo_State)
    - [https://en.wikipedia.org/wiki/Akoko\_Edo](https://en.wikipedia.org/wiki/Akoko_Edo)
    -
    - [https://en.wikipedia.org/wiki/Esan\_Central](https://en.wikipedia.org/wiki/Esan_Central)
    - [https://en.wikipedia.org/wiki/Esan\_North-East](https://en.wikipedia.org/wiki/Esan_North-East)
    - [https://en.wikipedia.org/wiki/Esan\_South-East](https://en.wikipedia.org/wiki/Esan_South-East)
    - [https://en.wikipedia.org/wiki/Esan\_West](https://en.wikipedia.org/wiki/Esan_West)
    - [https://en.wikipedia.org/wiki/Etsako\_Central](https://en.wikipedia.org/wiki/Etsako_Central)
    - [https://en.wikipedia.org/wiki/Etsako\_East](https://en.wikipedia.org/wiki/Etsako_East)
    - [https://en.wikipedia.org/wiki/Etsako\_West](https://en.wikipedia.org/wiki/Etsako_West)
    -
    - [https://en.wikipedia.org/wiki/Ikpoba\_Okha](https://en.wikipedia.org/wiki/Ikpoba_Okha)
    -
    -
    - [https://en.wikipedia.org/wiki/Ovia\_North-East](https://en.wikipedia.org/wiki/Ovia_North-East)
    - [https://en.wikipedia.org/wiki/Ovia\_South-West](https://en.wikipedia.org/wiki/Ovia_South-West)
    - [https://en.wikipedia.org/wiki/Owan\_East](https://en.wikipedia.org/wiki/Owan_East)
    - [https://en.wikipedia.org/wiki/Owan\_West](https://en.wikipedia.org/wiki/Owan_West)
    -
    - [https://en.wikipedia.org/wiki/Ekiti\_State](https://en.wikipedia.org/wiki/Ekiti_State)
    - [https://en.wikipedia.org/wiki/List\_of\_villages\_in\_Ekiti\_State](https://en.wikipedia.org/wiki/List_of_villages_in_Ekiti_State)
    - [https://en.wikipedia.org/wiki/Ado\_Ekiti](https://en.wikipedia.org/wiki/Ado_Ekiti)
    - [https://en.wikipedia.org/wiki/Ekiti\_East](https://en.wikipedia.org/wiki/Ekiti_East)
    -
    - [https://en.wikipedia.org/wiki/Ekiti\_South-West](https://en.wikipedia.org/wiki/Ekiti_South-West)
    - [https://en.wikipedia.org/wiki/Ekiti\_West](https://en.wikipedia.org/wiki/Ekiti_West)
    -
    -
    - [https://en.wikipedia.org/wiki/Ijero\_Ekiti](https://en.wikipedia.org/wiki/Ijero_Ekiti)
    -
    -
    -
    -
    -
    -
    - [https://en.wikipedia.org/wiki/Oye,\_Ekiti](https://en.wikipedia.org/wiki/Oye,_Ekiti)
    - [https://en.wikipedia.org/wiki/Moba,\_Nigeria](https://en.wikipedia.org/wiki/Moba,_Nigeria)
    - [https://en.wikipedia.org/wiki/Enugu\_State](https://en.wikipedia.org/wiki/Enugu_State)
    - [https://en.wikipedia.org/wiki/List\_of\_villages\_in\_Enugu\_State](https://en.wikipedia.org/wiki/List_of_villages_in_Enugu_State)
    -
    -
    - [https://en.wikipedia.org/wiki/Enugu\_East](https://en.wikipedia.org/wiki/Enugu_East)
    - [https://en.wikipedia.org/wiki/Enugu\_North](https://en.wikipedia.org/wiki/Enugu_North)
    - [https://en.wikipedia.org/wiki/Enugu\_South](https://en.wikipedia.org/wiki/Enugu_South)
    -
    - [https://en.wikipedia.org/wiki/Igbo\_Etiti](https://en.wikipedia.org/wiki/Igbo_Etiti)
    - [https://en.wikipedia.org/wiki/Igbo\_Eze\_North](https://en.wikipedia.org/wiki/Igbo_Eze_North)
    - [https://en.wikipedia.org/wiki/Igbo\_Eze\_South](https://en.wikipedia.org/wiki/Igbo_Eze_South)
    - [https://en.wikipedia.org/wiki/Isi\_Uzo](https://en.wikipedia.org/wiki/Isi_Uzo)
    - [https://en.wikipedia.org/wiki/Nkanu\_East](https://en.wikipedia.org/wiki/Nkanu_East)
    - [https://en.wikipedia.org/wiki/Nkanu\_West](https://en.wikipedia.org/wiki/Nkanu_West)
    -
    - [https://en.wikipedia.org/wiki/Oji\_River](https://en.wikipedia.org/wiki/Oji_River)
    -
    - [https://en.wikipedia.org/wiki/Udi,\_Enugu](https://en.wikipedia.org/wiki/Udi,_Enugu)
    - [https://en.wikipedia.org/wiki/Uzo\_Uwani](https://en.wikipedia.org/wiki/Uzo_Uwani)
    - [https://en.wikipedia.org/wiki/Federal\_Capital\_Territory\_(Nigeria)](https://en.wikipedia.org/wiki/Federal_Capital_Territory_(Nigeria))
    -
    - [https://en.wikipedia.org/wiki/Abaji,\_Nigeria](https://en.wikipedia.org/wiki/Abaji,_Nigeria)
    - [https://en.wikipedia.org/wiki/Abuja\_Municipal\_Area\_Council](https://en.wikipedia.org/wiki/Abuja_Municipal_Area_Council)
    -
    -
    -
    - [https://en.wikipedia.org/wiki/Kwali\_Area\_Council](https://en.wikipedia.org/wiki/Kwali_Area_Council)
    - [https://en.wikipedia.org/wiki/Gombe\_State](https://en.wikipedia.org/wiki/Gombe_State)
    - [https://en.wikipedia.org/wiki/List\_of\_villages\_in\_Gombe\_State](https://en.wikipedia.org/wiki/List_of_villages_in_Gombe_State)
    - [https://en.wikipedia.org/wiki/Akko,\_Nigeria](https://en.wikipedia.org/wiki/Akko,_Nigeria)
    - [https://en.wikipedia.org/wiki/Balanga,\_Nigeria](https://en.wikipedia.org/wiki/Balanga,_Nigeria)
    -
    -
    -
    -
    -
    -
    -
    -
    -
    - [https://en.wikipedia.org/wiki/Imo\_State](https://en.wikipedia.org/wiki/Imo_State)
    - [https://en.wikipedia.org/wiki/List\_of\_villages\_in\_Imo\_State](https://en.wikipedia.org/wiki/List_of_villages_in_Imo_State)
    - [https://en.wikipedia.org/wiki/Aboh\_Mbaise](https://en.wikipedia.org/wiki/Aboh_Mbaise)
    - [https://en.wikipedia.org/wiki/Ahiazu\_Mbaise](https://en.wikipedia.org/wiki/Ahiazu_Mbaise)
    - [https://en.wikipedia.org/wiki/Ehime\_Mbano](https://en.wikipedia.org/wiki/Ehime_Mbano)
    - [https://en.wikipedia.org/wiki/Ezinihitte\_Mbaise](https://en.wikipedia.org/wiki/Ezinihitte_Mbaise)
    - [https://en.wikipedia.org/wiki/Ideato\_North](https://en.wikipedia.org/wiki/Ideato_North)
    - [https://en.wikipedia.org/wiki/Ideato\_South](https://en.wikipedia.org/wiki/Ideato_South)
    -
    -
    - [https://en.wikipedia.org/wiki/Isiala\_Mbano](https://en.wikipedia.org/wiki/Isiala_Mbano)
    - [https://en.wikipedia.org/wiki/Isu,\_Imo](https://en.wikipedia.org/wiki/Isu,_Imo)
    -
    - [https://en.wikipedia.org/wiki/Ngor\_Okpala](https://en.wikipedia.org/wiki/Ngor_Okpala)
    -
    -
    -
    -
    -
    -
    -
    -
    - [https://en.wikipedia.org/wiki/Orlu,\_Imo](https://en.wikipedia.org/wiki/Orlu,_Imo)
    -
    - [https://en.wikipedia.org/wiki/Oru\_East](https://en.wikipedia.org/wiki/Oru_East)
    - [https://en.wikipedia.org/wiki/Oru\_West](https://en.wikipedia.org/wiki/Oru_West)
    - [https://en.wikipedia.org/wiki/Mgbidi,\_Imo](https://en.wikipedia.org/wiki/Mgbidi,_Imo)
    - [https://en.wikipedia.org/wiki/Owerri\_Municipal](https://en.wikipedia.org/wiki/Owerri_Municipal)
    - [https://en.wikipedia.org/wiki/Owerri\_North](https://en.wikipedia.org/wiki/Owerri_North)
    - [https://en.wikipedia.org/wiki/Owerri\_West](https://en.wikipedia.org/wiki/Owerri_West)
- **NIPC** (Nigerian Investment Promotion Commission)

    -
    -
    -
    -
    -
    -
- **INEC Nigeria**

    -
    - [https://www.inecnigeria.org/wp-content/uploads/2019/02/PU\_Directory\_Revised\_January\_2015\_Akwa\_Ibom.pdf](https://www.inecnigeria.org/wp-content/uploads/2019/02/PU_Directory_Revised_January_2015_Akwa_Ibom.pdf)
    - [https://www.inecnigeria.org/wp-content/uploads/2019/02/PU\_Directory\_Revised\_January\_2015\_Ebonyi.pdf](https://www.inecnigeria.org/wp-content/uploads/2019/02/PU_Directory_Revised_January_2015_Ebonyi.pdf)
    -
    -
    -
- **Nigeria Housing Market**

    -
    -
    -
    -
    -
    -
    -
    -
    -
- **Legit.ng**

    -
    -
- **Media Nigeria**

    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
- **Current Affairs NG**

    -
- **Mindat.org**

    -
- **Soluap**

    -
- **Geo MyCyber**

    -
    -
    -
    -
    -
    -
    -
    -
    -
    - [https://geo.mycyber.org/nigeria/gombe\_1/](https://geo.mycyber.org/nigeria/gombe_1/)
    -
    -
    -
    -
    -
    -
    -
- **Cross River Hub**

    -
- **Akwa Ibom State Government**

    -
- **Bauchi State Government**

    -
- **Cross River State Government**

    -
- **Ebonyi State Government**

    -
- **Edo State Government**

    -
- **Ekiti State Government**

    -
- **Enugu State Government**

    -
- **Federal Capital Territory Administration (FCTA)**

    -
- **Gombe State Government**

    -
- **Imo State Government**

    -
- **Premium Times Nigeria**

    -
- **Vanguard Nigeria**

    -

###  Health Score

45

—

FairBetter than 91% of packages

Maintenance96

Actively maintained with recent releases

Popularity22

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

Every ~85 days

Total

9

Last Release

17d ago

### Community

Maintainers

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

---

Top Contributors

[![emmadonjo](https://avatars.githubusercontent.com/u/22492808?v=4)](https://github.com/emmadonjo "emmadonjo (46 commits)")

---

Tags

naijanaijastatesnigeriaphp

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/emmadonjo-naija/health.svg)

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

###  Alternatives

[hofff/contao-calendarfield

Frontend text field with datepicker for Contao Open Source CMS

2033.8k3](/packages/hofff-contao-calendarfield)[imliam/shareable-link

Conveniently generate shareable URLs for various social media websites

102.5k](/packages/imliam-shareable-link)

PHPackages © 2026

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