PHPackages                             claz/wishi - 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. [Framework](/categories/framework)
4. /
5. claz/wishi

ArchivedProject[Framework](/categories/framework)

claz/wishi
==========

An agnostic package to get different countries, states and counties.

v1.0.2.1(9y ago)19279[1 PRs](https://github.com/andela-tolotin/locator/pulls)MITPHPPHP >=5.5.9

Since Jun 9Pushed 6y ago5 watchersCompare

[ Source](https://github.com/andela-tolotin/locator)[ Packagist](https://packagist.org/packages/claz/wishi)[ RSS](/packages/claz-wishi/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (4)Dependencies (6)Versions (30)Used By (0)

Locator
=======

[](#locator)

---

[![Coverage Status](https://camo.githubusercontent.com/041969dc2c5fb73ff2a162536351e57e6eab4ec13f4f885ae7d69f23abb9c95e/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f616e64656c612d746f6c6f74696e2f6765742d636f756e7472792d696e666f2f62616467652e7376673f6272616e63683d646576656c6f70)](https://coveralls.io/github/andela-tolotin/get-country-info?branch=develop)[![Build Status](https://camo.githubusercontent.com/6b00773bbf9521f3b7e83085b67f4703bf39ad48d1c2f5a924b85153915f4b0b/68747470733a2f2f7472617669732d63692e6f72672f616e64656c612d746f6c6f74696e2f6c6f6361746f722e7376673f6272616e63683d646576656c6f70)](https://travis-ci.org/andela-tolotin/locator)[![StyleCI](https://camo.githubusercontent.com/3bf9047e3cb5dd9bfb8ae811ced320b125f8849b027d6f46216616044efe2bf4/68747470733a2f2f7374796c6563692e696f2f7265706f732f36303632343130392f736869656c64)](https://styleci.io/repos/60624109)
If you have ever needed basic information about countries, and their states, then Locator is for you. Locator is a PHP package that works with the Yahoo API. It returns data that you need just by calling one method. There is a Service Provider and a Facade to make it easy to integrate with your Laravel project. It can also be used with other PHP frameworks like Lumen, CakePHP, Zend, etc. Version 1.0.0 only provides information about the following:

- Countries
- States in the country
- Counties in the state

Dependencies
------------

[](#dependencies)

---

- PHP 5.5+
- Composer 1.4+
- Apache

Getting Started
---------------

[](#getting-started)

---

To use this package with a PHP project, first require the package using composer.

```
composer require claz/wishi
```

- Note that you must be registered in Yahoo as a developer. Add your Yahoo details to your environment variables.

```
YAHOO_CLIENT_ID=*********************************
```

### Using plain PHP

[](#using-plain-php)

If you are using this project with a plain PHP project, follow the following steps:

- Run `composer dumpautoload` if required.
- Require autoload.php and load the package with its dependencies.

```
require_once ('vendor/autoload.php')

use Wishi\Controllers\Locator;
```

- Instantiate the Locator class and you are good to go.

```
$locator = new Locator();
```

### Using with Laravel

[](#using-with-laravel)

If you are using this project with Laravel, follow the following steps:

- Open app.config in config folder and,
- Register the ServiceProvider inside `config.php`

```
Wishi\Providers\LocatorServiceProvider::class,
```

- To use the Facade, simple add it to the same file.

```
Locator => Wishi\Facades\Locator::class,
```

- Import the Facade into your project.

```
use Locator;
```

### Example

[](#example)

---

- To get all the countries.

```
// With normal PHP applications
$countries = $locator->getCountries();

// With the Facade in Laravel applications
$countries = Locator::getCountries();

var_dump($countries); // Collection of countries
```

- To get all the states in a country.

```
// With normal PHP applications
$states = $locator->getStates('Nigeria');

// With the Facade in Laravel applications
$states = Locator::getStates('Nigeria');

var_dump($states); // Collection of states
```

- To get all the counties in a state.

```
// With normal PHP applications
$counties = $locator->getCounties('Lagos');

// With the Facade in Laravel applications
$counties = Locator::getCounties('Lagos');

var_dump($counties); // Collection of counties
```

One very common use is illustrated below in a Laravel project that lists all the state in the Nigeria.

```

@foreach(Locator::getStates('Nigeria') as $state)
     {{ $state->name }}
@endforeach

```

License
-------

[](#license)

---

This project uses the MIT License feel free to contribute.

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity18

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity69

Established project with proven stability

 Bus Factor1

Top contributor holds 50.5% 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 ~0 days

Total

4

Last Release

3581d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/9338a1c768c2e964e80b8d14adcdd91bcc0fd74f487661c348f5483c5acc3f23?d=identicon)[andela-tolotin](/maintainers/andela-tolotin)

---

Top Contributors

[![olotintemitope](https://avatars.githubusercontent.com/u/14159435?v=4)](https://github.com/olotintemitope "olotintemitope (56 commits)")[![elchroy](https://avatars.githubusercontent.com/u/17028608?v=4)](https://github.com/elchroy "elchroy (54 commits)")[![olakehinde](https://avatars.githubusercontent.com/u/25386385?v=4)](https://github.com/olakehinde "olakehinde (1 commits)")

---

Tags

phpframeworklaravel

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/claz-wishi/health.svg)

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

###  Alternatives

[laravel/framework

The Laravel Framework.

34.6k509.9M17.0k](/packages/laravel-framework)[laravel/dusk

Laravel Dusk provides simple end-to-end testing and browser automation.

1.9k36.7M259](/packages/laravel-dusk)[laravel-zero/framework

The Laravel Zero Framework.

3371.4M369](/packages/laravel-zero-framework)[laravel/vapor-cli

The Laravel Vapor CLI

31310.7M8](/packages/laravel-vapor-cli)[nunomaduro/laravel-desktop-notifier

Send notifications to your desktop from your Laravel commands. An JoliNotif wrapper for Laravel 5.

4781.7M8](/packages/nunomaduro-laravel-desktop-notifier)[defstudio/pest-plugin-laravel-expectations

A plugin to add laravel tailored expectations to Pest

98548.9k4](/packages/defstudio-pest-plugin-laravel-expectations)

PHPackages © 2026

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