countries

Rinvex Country is a simple and lightweight package for retrieving country details with flexibility. A whole bunch of data including name, demonym, capital, iso codes, dialling codes, geo data, currencies, flags, emoji, and other attributes for all 250 countries worldwide at your fingertips.

1,712

218

1,712

View on GitHub

Top Related Projects

countries

1,884

Laravel countries and currencies

country-list

5,233

:globe_with_meridians: List of all countries with names and ISO 3166-1 codes in all languages and data formats.

Countries

1,254

Countries, Languages & Continents data (capital and currency, native name, calling codes).

world_countries

1,469

Constantly updated lists of world countries and their associated alpha-2, alpha-3 and numeric country codes as defined by the ISO 3166 standard, available in CSV, JSON , PHP, SQL and XML formats, in multiple languages and with national flags included; also available are the ISO 3166-2 codes of provinces/ states associated with the countries

countries-states-cities-database

8,835

🌍 Discover our global repository of countries, states, and cities! 🏙️ Get comprehensive data in JSON, SQL, PSQL, SQLSERVER, MONGODB, SQLITE, XML, YAML, and CSV formats. Access ISO2, ISO3 codes, country code, capital, native language, timezones (for countries), and more. #countries #states #cities

Quick Overview

Rinvex Countries is a comprehensive PHP package that provides detailed information about countries worldwide. It offers a rich dataset including country names, codes, calling codes, currencies, flags, emoji, and various other attributes, making it an invaluable resource for developers working on applications requiring country-related data.

Pros

Extensive dataset with a wide range of country information
Regular updates to keep the data current and accurate
Easy integration with Laravel and other PHP projects
Flexible API for retrieving and filtering country data

Cons

Large dataset may increase application size if not used selectively
Requires PHP 7.4 or higher, which may not be suitable for older projects
Some advanced features may have a learning curve for new users
Dependency on other Rinvex packages might complicate setup for some users

Code Examples

Retrieving all countries:

use Rinvex\Country\CountryLoader;

$countries = CountryLoader::countries();

Getting information for a specific country:

use Rinvex\Country\CountryLoader;

$usa = CountryLoader::country('US');
echo $usa->getName(); // United States
echo $usa->getOfficialName(); // United States of America

Filtering countries by continent:

use Rinvex\Country\CountryLoader;

$europeanCountries = CountryLoader::where('continent.code', 'EU');

Getting Started

Install the package via Composer:

composer require rinvex/countries

If you're using Laravel, add the service provider to config/app.php:

'providers' => [
    // ...
    Rinvex\Country\Providers\CountryServiceProvider::class,
]

Publish the config file:

php artisan vendor:publish --tag="rinvex-countries-config"

Use the package in your code:

use Rinvex\Country\CountryLoader;

$countries = CountryLoader::countries();
$usa = CountryLoader::country('US');

Competitor Comparisons

countries

1,884

Laravel countries and currencies

Pros of Countries

More comprehensive data set, including additional information like timezones, currencies, and languages
Regular updates and active maintenance
Extensive documentation and examples

Cons of Countries

Larger file size due to more extensive data
Potentially more complex to use for simple country-related tasks
May require more setup and configuration

Code Comparison

Countries:

use PragmaRX\Countries\Package\Countries;

$countries = new Countries();
$brazil = $countries->where('name.common', 'Brazil')->first();
echo $brazil->capital[0]; // Brasília

countries:

use Rinvex\Country\Country;

$brazil = country('br');
echo $brazil->getCapital(); // Brasilia

Summary

Both repositories offer country-related data and functionality for PHP applications. Countries provides a more extensive dataset with additional features, while countries focuses on simplicity and ease of use. The choice between the two depends on the specific requirements of your project and the level of detail needed in country information.

country-list

5,233

:globe_with_meridians: List of all countries with names and ISO 3166-1 codes in all languages and data formats.

Pros of country-list

Extensive language support with translations for country names in 260+ languages
Data available in multiple formats (JSON, CSV, XML, YAML)
Regularly updated with new country information

Cons of country-list

Limited to basic country data (names and codes)
Lacks additional geographical or demographic information
No built-in methods for data manipulation or filtering

Code Comparison

country-list (JSON format):

{
  "AF": "Afghanistan",
  "AL": "Albania",
  "DZ": "Algeria"
}

countries:

$afghanistan = Country::where('iso_3166_1_alpha2', 'AF')->first();
echo $afghanistan->name; // Afghanistan
echo $afghanistan->capital; // Kabul
echo $afghanistan->currency; // AFN

Summary

country-list excels in providing multilingual country names in various formats, making it ideal for projects requiring extensive language support. However, it's limited to basic country information.

countries offers a more comprehensive dataset with additional geographical and demographic details, along with built-in methods for data manipulation. It's better suited for projects needing in-depth country information and advanced querying capabilities.

Choose country-list for simple, multilingual country name listings, and countries for more complex, data-rich country-related functionalities.

Countries

1,254

Countries, Languages & Continents data (capital and currency, native name, calling codes).

Pros of Countries

Lightweight and simple data structure
Supports multiple languages for country names
Includes additional data like capital cities and currencies

Cons of Countries

Less comprehensive data compared to countries
Fewer customization options and features
Limited documentation and examples

Code Comparison

Countries:

const countries = require('countries-list');
console.log(countries.countries.US);

countries:

use Rinvex\Country\Country;
$country = new Country('us');
echo $country->getName();

Summary

Countries offers a lightweight solution with multi-language support and basic country data. It's suitable for simple use cases and projects requiring minimal country information. However, it lacks the extensive features and customization options provided by countries.

countries provides a more comprehensive dataset, including detailed information like subdivisions, timezones, and postal code formats. It offers greater flexibility and is better suited for complex applications requiring in-depth country data.

The choice between the two depends on the specific requirements of your project, with Countries being more suitable for lightweight needs and countries for more robust, feature-rich applications.

world_countries

1,469

Pros of world_countries

Simpler structure with flat JSON files for easy parsing
Includes more detailed geographical data (borders, coordinates)
Offers data in multiple formats (JSON, CSV, SQL, XML)

Cons of world_countries

Less comprehensive data set compared to countries
Fewer localization options for country names
Less frequent updates and maintenance

Code Comparison

countries:

use Rinvex\Country\Country;

$country = new Country('us');
echo $country->getName();
echo $country->getOfficialName();
echo $country->getCapital();

world_countries:

$countries = json_decode(file_get_contents('countries.json'), true);
$us = $countries['US'];
echo $us['name'];
echo $us['capital'];

Summary

countries offers a more comprehensive and structured approach to country data, with extensive localization options and regular updates. It provides an object-oriented interface for easy integration into PHP projects.

world_countries, on the other hand, offers a simpler, more lightweight solution with flat data files in multiple formats. It includes some additional geographical data but lacks the depth and localization options of countries.

The choice between the two depends on the specific needs of the project, with countries being more suitable for complex applications requiring extensive country data, and world_countries being a good fit for simpler use cases or projects using multiple programming languages.

countries-states-cities-database

8,835

Pros of countries-states-cities-database

Includes more detailed data, such as states and cities
Offers data in multiple formats (JSON, SQL, CSV, XML)
Regular updates and contributions from the community

Cons of countries-states-cities-database

Larger file size due to more comprehensive data
May require more processing for simple country-only use cases
Less focused on providing a programming interface

Code Comparison

countries-states-cities-database:

{
  "id": 101,
  "name": "India",
  "iso3": "IND",
  "iso2": "IN",
  "numeric_code": "356",
  "phone_code": "91",
  "capital": "New Delhi",
  "currency": "INR",
  "currency_name": "Indian rupee",
  "currency_symbol": "₹",
  "tld": ".in",
  "native": "भारत",
  "region": "Asia",
  "subregion": "Southern Asia",
  "timezones": [
    {
      "zoneName": "Asia/Kolkata",
      "gmtOffset": 19800,
      "gmtOffsetName": "UTC+05:30",
      "abbreviation": "IST",
      "tzName": "Indian Standard Time"
    }
  ],
  "translations": {
    "kr": "인도",
    "pt-BR": "Índia",
    "pt": "Índia",
    "nl": "India",
    "hr": "Indija",
    "fa": "هند",
    "de": "Indien",
    "es": "India",
    "fr": "Inde",
    "ja": "インド",
    "it": "India",
    "cn": "印度"
  },
  "latitude": "20.00000000",
  "longitude": "77.00000000",
  "emoji": "🇮🇳",
  "emojiU": "U+1F1EE U+1F1F3"
}

countries:

<?php

return [
    'name' => [
        'common' => 'India',
        'official' => 'Republic of India',
        'native' => [
            'eng' => [
                'official' => 'Republic of India',
                'common' => 'India',
            ],
            'hin' => [
                'official' => 'भारत गणराज्य',
                'common' => 'भारत',
            ],
            'tam' => [
                'official' => 'இந்தியக் குடியரசு',
                'common' => 'இந்தியா',
            ],
        ],
    ],
    'demonym' => 'Indian',
    'capital' => 'New Delhi',
    'iso_3166_1_alpha2' => 'IN',
    'iso_3166_1_alpha3' => 'IND',
    'iso_3166_1_numeric' => '356',
    'currency' => [
        'INR' => [
            'name' => 'Indian Rupee',
            'symbol' => '₹',
        ],
    ],
    'tld' => [
        '.in',
    ],
    'alt_spellings' => [
        'IN',
        'Bhārat',
        'Republic of India',
        'Bharat Ganrajya',
    ],
    'languages' => [
        'eng' => 'English',
        'hin' => 'Hindi',
        'tam' => 'Tamil',
    ],
    'geo' => [
        'continent' => [
            'AS' => 'Asia',
        ],
        'postal_code' => true,
        'latitude' => '20 00 N',
        'latitude_dec' => '20.963949203491211',
        'longitude' => '77 00 E',
        'longitude_dec' => '78.6595458

Convert designs to code with AI

Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.

Try Visual Copilot

README

Rinvex Country

Rinvex Country is a simple and lightweight package for retrieving country details with flexibility. A whole bunch of data including name, demonym, capital, iso codes, dialling codes, geo data, currencies, flags, emoji, and other attributes for all 250 countries worldwide at your fingertips.

Usage

Install via composer require rinvex/countries, then use intuitively:

// Get single country
$egypt = country('eg');

// Get country name                                 // Get country native name
echo $egypt->getName();                             echo $egypt->getNativeName();

// Get country official name                        // Get country ISO 3166-1 alpha2 code
echo $egypt->getOfficialName();                     echo $egypt->getIsoAlpha2();

// Get country area                                 // Get country borders
echo $egypt->getArea();                             echo $egypt->getBorders();

// Get country currencies                           // Get country languages
echo $egypt->getCurrencies();                       echo $egypt->getLanguages();

// Get country emoji                                // Get country flag
echo $egypt->getEmoji();                            echo $egypt->getFlag();


// Get all countries                                // Get countries with where condition (continent: Oceania)
$countries = countries();                           $whereCountries = \Rinvex\Country\CountryLoader::where('geo.continent', ['OC' => 'Oceania']);

Note: This package is framework-agnostic, so it's compatible with any PHP framework whatsoever without any dependencies at all, except for the PHP version itself ^8.1. Awesome, huh? :smiley:

Advanced Usage
Features Explained
Data Sources
Upgrade
Changelog
Support
Contributing & Protocols
Security Vulnerabilities
About Rinvex
License

Advanced Usage

Get country attributes (self-descriptive):

$egypt = country('eg');

// Egypt                                            // ÙØµØ±
$egypt->getName();                                  $egypt->getNativeName();

// Arab Republic of Egypt                           // Ø¬ÙÙÙØ±ÙØ© ÙØµØ± Ø§ÙØ¹Ø±Ø¨ÙØ©
$egypt->getOfficialName();                          $egypt->getNativeOfficialName();

// Egyptian                                         // Cairo
$egypt->getDemonym();                               $egypt->getCapital();

// EG                                               // EGY
$egypt->getIsoAlpha2();                             $egypt->getIsoAlpha3();

// 818                                              // .eg
$egypt->getIsoNumeric();                            $egypt->getTld();

// [".eg",".ÙØµØ±"]                                   // ["EG","Arab Republic of Egypt"]
$egypt->getTlds();                                  $egypt->getAltSpellings();

// Arabic                                           // {"ara":"Arabic"}
$egypt->getLanguage();                              $egypt->getLanguages();

// Africa                                           // true
$egypt->getContinent();                             $egypt->usesPostalCode();

// 27 00 N                                          // 30 00 E
$egypt->getLatitude();                              $egypt->getLongitude();

// 26.756103515625                                  // 29.86229705810547
$egypt->getLatitudeDesc();                          $egypt->getLongitudeDesc();

// 31.916667                                        // 36.333333
$egypt->getMaxLatitude();                           $egypt->getMaxLongitude();

// 20.383333                                        // 24.7
$egypt->getMinLatitude();                           $egypt->getMinLongitude();

// 1002450                                          // Africa
$egypt->getArea();                                  $egypt->getRegion();

// Northern Africa                                  // EMEA
$egypt->getSubregion();                             $egypt->getWorldRegion();

// 002                                              // 015
$egypt->getRegionCode();                            $egypt->getSubregionCode();

// false                                            // ["ISR","LBY","SDN"]
$egypt->isLandlocked();                             $egypt->getBorders();

// Yes                                              // 20
$egypt->isIndependent();                            $egypt->getCallingCode();

// ["20"]                                           // 0
$egypt->getCallingCodes();                          $egypt->getNationalPrefix();

// 9                                                // [9]
$egypt->getNationalNumberLength();                  $egypt->getNationalNumberLengths();

// 2                                                // [2]
$egypt->getNationalDestinationCodeLength();         $egypt->getnationaldestinationcodelengths();

// "00"                                             // {{recipient}}\n{{street}}\n{{postalcode}} {{city}}\n{{country}}
$egypt->getInternationalPrefix();                   $egypt->getAddressFormat();

// 357994                                           // H2
$egypt->getGeonameid();                             $egypt->getEdgar();

// EGY                                              // ua
$egypt->getItu();                                   $egypt->getMarc();

// EG                                               // ET
$egypt->getWmo();                                   $egypt->getDs();

// EGY                                              // EG
$egypt->getFifa();                                  $egypt->getFips();

// 40765                                            // EGY
$egypt->getGaul();                                  $egypt->getIoc();

// EGY                                              // 651
$egypt->getCowc();                                  $egypt->getCown();

// 59                                               // 469
$egypt->getFao();                                   $egypt->getImf();

// MAF                                              // null
$egypt->getAr5();                                   $egypt->isEuMember();

// null                                             // ðªð¬
$egypt->getVatRates();                              $egypt->getEmoji();

// GeoJson data returned as string                  // SVG data returned as string
$egypt->getGeoJson();                               $egypt->getFlag();

// Divisions returned as array                      // {"official":"Ø¬ÙÙÙØ±ÙØ© ÙØµØ± Ø§ÙØ¹Ø±Ø¨ÙØ©","common":"ÙØµØ±"}
$egypt->getDivisions();                             $egypt->getTranslation();

// ['Africa/Cairo']                                 // ['ar_EG']
$egypt->getTimezones();                             $egypt->getLocales();

// Other                                            // {"ara":{"official":"Ø¬ÙÙÙØ±ÙØ© ÙØµØ± Ø§ÙØ¹Ø±Ø¨ÙØ©","common":"ÙØµØ±"}}
$egypt->getDataProtection()                         $egypt->getNativeNames();

// {"iso_4217_code":"EGP","iso_4217_numeric":818,"iso_4217_name":"Egyptian Pound","iso_4217_minor_unit":2}
$egypt->getCurrency();

// {"EGP":{"iso_4217_code":"EGP","iso_4217_numeric":818,"iso_4217_name":"Egyptian Pound","iso_4217_minor_unit":2}}
$egypt->getCurrencies();

// {"ara":{"official":"Ø¬ÙÙÙØ±ÙØ© ÙØµØ± Ø§ÙØ¹Ø±Ø¨ÙØ©","common":"ÙØµØ±"},"cym":{"official":"Arab Republic of Egypt","common":"Yr Aifft"},"deu":{"official":"Arabische Republik Ãgypten","common":"Ãgypten"},"fra":{"official":"RÃ©publique arabe d'Ãgypte","common":"Ãgypte"},"hrv":{"official":"Arapska Republika Egipat","common":"Egipat"},"ita":{"official":"Repubblica araba d'Egitto","common":"Egitto"},"jpn":{"official":"ã¨ã¸ããÂ·ã¢ã©ãå±åå½","common":"ã¨ã¸ãã"},"nld":{"official":"Arabische Republiek Egypte","common":"Egypte"},"por":{"official":"RepÃºblica Ãrabe do Egipto","common":"Egito"},"rus":{"official":"ÐÑÐ°Ð±ÑÐºÐ°Ñ Ð ÐµÑÐ¿ÑÐ±Ð»Ð¸ÐºÐ° ÐÐ³Ð¸Ð¿ÐµÑ","common":"ÐÐ³Ð¸Ð¿ÐµÑ"},"spa":{"official":"RepÃºblica Ãrabe de Egipto","common":"Egipto"},"fin":{"official":"Egyptin arabitasavalta","common":"Egypti"}}
$egypt->getTranslations();

// {"continent":{"AF":"Africa"},"postal_code":true,"latitude":"27 00 N","latitude_dec":"26.756103515625","longitude":"30 00 E","longitude_dec":"29.86229705810547","max_latitude":"31.916667","max_longitude":"36.333333","min_latitude":"20.383333","min_longitude":"24.7","area":1002450,"region":"Africa","subregion":"Northern Africa","world_region":"EMEA","region_code":"002","subregion_code":"015","landlocked":false,"borders":["ISR","LBY","SDN"],"independent":"Yes"}
$egypt->getGeodata();

// {"geonameid":357994,"edgar":"H2","itu":"EGY","marc":"ua","wmo":"EG","ds":"ET","fifa":"EGY","fips":"EG","gaul":40765,"ioc":"EGY","cowc":"EGY","cown":651,"fao":59,"imf":469,"ar5":"MAF","address_format":"{{recipient}}\n{{street}}\n{{postalcode}} {{city}}\n{{country}}","eu_member":null,"data_protection":"Other","vat_rates":null,"emoji":"ðªð¬"}
$egypt->getExtra();

// {"name":"Al Iskandariyah","alt_names":["El Iskandariya","al-Iskandariyah","al-IskandarÄ«yah","Alexandria","Alexandrie","Alexandria"],"geo":{"latitude":31.2000924,"longitude":29.9187387,"min_latitude":31.1173177,"min_longitude":29.8233701,"max_latitude":31.330904,"max_longitude":30.0864016}}
$egypt->getDivision("ALX");

Note: When retrieving single country, you'll get the full country details just like the previous example. But when retrieving all countries, you'll get a short-listed result set with common country details for better performance.

Features Explained

Country data are all stored here: resources/data/countries.json.
name
- common - common name in english
- official - official name in english
- native - list of all native names
  - key: three-letter ISO 639-3 language alpha code
  - value: name object
    - key: official - official name translation
    - key: common - common name translation
demonym - name of residents
capital - capital city
iso_3166_1_alpha2 - code ISO 3166-1 alpha-2
iso_3166_1_alpha3 -code ISO 3166-1 alpha-3
iso_3166_1_numeric - code ISO 3166-1 numeric
currency - ISO 4217 currency code(s)
- key: three-letter ISO 4217 currency code
- value: currency object
  - key: iso_4217_code - three-letter ISO 4217 currency alpha code
  - key: iso_4217_numeric - three-number ISO 4217 currency numeric code
  - key: iso_4217_name - official ISO 4217 currency name
  - key: iso_4217_minor_unit - minor currency unit
tld - country code top-level domain
alt_spellings - alternative spellings
languages - list of official languages
- key: three-letter ISO 639-3 language code
- value: name of the language in english
translations - list of name translations
- key: three-letter ISO 639-3 language code
- value: name object
  - key: official - official name translation
  - key: common - common name translation
geo
- continent - continents that country lies in
  - key: two-letter continent code
  - value: name of the continent in english
- postal_code - whether the country uses postal codes
- latitude - short form of latitude coordinate point
- latitude_desc - described latitude coordinate point
- longitude - short form of longitude coordinate point
- longitude_desc - described longitude coordinate point
- max_latitude - maximum latitude coordinate point
- max_longitude - maximum longitude coordinate point
- min_latitude - minimum latitude coordinate point
- min_longitude - minimum longitude coordinate point
- area - land area in kmÂ²
- region - geographical region
- subregion - geographical sub-region
- world_region - geographical world region
- region_code - geographical region numeric code
- subregion_code - geographical sub-region numeric code
- landlocked - landlock status
- borders - land borders
- independent - independent status
dialling
- calling_code - calling code(s)
- national_prefix - national prefix
- national_number_lengths - national number lengths
- national_destination_code_lengths - national destination code lengths
- international_prefix - international prefix
extra
- geonameid - Geoname ID
- edgar - Electronic Data Gathering, Analysis, and Retrieval system
- itu - Codes assigned by the International Telecommunications Union
- marc - MAchine-Readable Cataloging codes from the Library of Congress
- wmo - Country abbreviations by the World Meteorological Organization
- ds - Distinguishing signs of vehicles in international traffic
- fifa - Codes assigned by the FÃ©dÃ©ration Internationale de Football Association
- fips - Codes from the U.S. Federal Information Processing Standard
- gaul - Global Administrative Unit Layers from the Food and Agriculture Organization
- ioc - Codes assigned by the International Olympics Committee
- cowc - Correlates of War character
- cown - Correlates of War numeric
- fao - Food and Agriculture Organization
- imf - International Monetary Fund
- ar5 - Fifth Assessment Report (AR5)
- address_format - Address format
- eu_member - European Union Member
- data_protection - Data Protection
- vat_rates - Value-Added Tax
- emoji - Emoji Flag

Data Sources

Currency Data (27th Sep, 2016): http://www.currency-iso.org
Emoji Flags (27th Sep, 2016): http://unicode.org/emoji/charts/full-emoji-list.html
World Borders (27th Sep, 2016): http://thematicmapping.org/downloads/world_borders.php
GeoJson & SVG Flags (27th Sep, 2016): https://github.com/mledoze/countries/tree/master/data
Main Country Data, Regions, and Divisions (27th Sep, 2016): https://github.com/hexorx/countries
Other Resources:

Upgrade

Upgrading To v3.x From v2.x

No major changes, same API with 100% backward compatibility. Note that PHP v7.0 is now minimum requirement.
Upgrading To v2.x From v1.x

Whole package re-written from scratch, just drop any previous code and start using the new clean, and intuitive API.

Changelog

Refer to the Changelog for a full history of the project.

Support

The following support channels are available at your fingertips:

Contributing & Protocols

Thank you for considering contributing to this project! The contribution guide can be found in CONTRIBUTING.md.

Bug reports, feature requests, and pull requests are very welcome.

Security Vulnerabilities

If you discover a security vulnerability within this project, please send an e-mail to help@rinvex.com. All security vulnerabilities will be promptly addressed.

About Rinvex

Rinvex is a software solutions startup, specialized in integrated enterprise solutions for SMEs established in Alexandria, Egypt since June 2016. We believe that our drive The Value, The Reach, and The Impact is what differentiates us and unleash the endless possibilities of our philosophy through the power of software. We like to call it Innovation At The Speed Of Life. Thatâs how we do our share of advancing humanity.

License

This software is released under The MIT License (MIT).

Top Related Projects

Convert designs to code with AI

Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.

Try Visual Copilot

Top Related Projects

Quick Overview

Pros

Cons

Code Examples

Getting Started

Competitor Comparisons

Pros of Countries

Cons of Countries

Code Comparison

Summary

Pros of country-list

Cons of country-list

Code Comparison

Summary

Pros of Countries

Cons of Countries

Code Comparison

Summary

Pros of world_countries

Cons of world_countries

Code Comparison

Summary

Pros of countries-states-cities-database

Cons of countries-states-cities-database

Code Comparison

Convert designs to code with AI

README

Rinvex Country

Usage

Table Of Contents

Advanced Usage

Features Explained

Data Sources

Upgrade

Changelog

Support

Contributing & Protocols

Security Vulnerabilities

About Rinvex

License

Top Related Projects

Convert designs to code with AI