An open API service indexing awesome lists of open source software.

https://github.com/iftekhersunny/country

Sun Country is the package that helps you to get country name and dialing code by the country ISO 3166-1 Alpha-2 code.
https://github.com/iftekhersunny/country

country country-codes country-names

Last synced: 6 months ago
JSON representation

Sun Country is the package that helps you to get country name and dialing code by the country ISO 3166-1 Alpha-2 code.

Awesome Lists containing this project

README

        

## Sun Country

[![Build Status](https://travis-ci.org/IftekherSunny/Country.svg?branch=master)](https://travis-ci.org/IftekherSunny/Country) [![Total Downloads](https://poser.pugx.org/sun/country/downloads)](https://packagist.org/packages/sun/country) [![Latest Stable Version](https://poser.pugx.org/sun/country/v/stable)](https://packagist.org/packages/sun/country) [![Latest Unstable Version](https://poser.pugx.org/sun/country/v/unstable)](https://packagist.org/packages/sun/country) [![License](https://poser.pugx.org/sun/country/license)](https://packagist.org/packages/sun/country)

Sun Country is the package that helps you to get country name and dialing code by the country ISO 3166-1 Alpha-2 code.

## Installation Process

Just copy Country folder somewhere into your project directory. Then include Sun Country autoload file.

```php
require_once('/path/to/Country/autoload.php');
```

Sun Country is also available via Composer/Packagist.

```
composer require sun/country
```

## Basic Uses

#### Get all countries name and dialing code

```php
$country = new Sun\Country;
$country->get();
```

#### Get a country name and dialing code

```php
$country = new Sun\Country;
$country->get('BD');
```

#### Get multiple countries name and dialing code

```php
$country = new Sun\Country;
$country->get(['BD', 'US']);
```

#### Get a country name and dialing code using Alpha 2 code as property

```php
$country = new Sun\Country;
$country->bd;
```

#### Get a country name

```php
$country = new Sun\Country;
$country->getName('BD');
```

#### Get a country dialing code

```php
$country = new Sun\Country;
$country->getDialingCode('BD');
```

#### Get a country name using country geo ip address

```php
$country = new Sun\Country;
$country->getCountryNameByGeoIp('203.202.251.42');
```

## Integration In Laravel Framework

Add the ServiceProvider to the providers array in config/app.php

```php
Sun\Provider\CountryServiceProvider::class,
```

Add the facade to the aliases array in config/app.php

```php
'Country' => Sun\Facade\CountryFacade::class,
```

## Integration In Planet Framework

Add the provider in the config/provider.php file.

```php
Sun\Provider\CountryProvider::class,
```

Add the alien in the config/alien.php file.

```php
'Country' => Sun\Alien\CountryAlien::class,
```

## License
This package is licensed under the [MIT License](https://github.com/iftekhersunny/Country/blob/master/LICENSE)