PHPackages sierratecnologia/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. sierratecnologia/countries ActiveLibrary[Utility & Helpers](/categories/utility) sierratecnologia/countries ========================== SierraTecnologia Countries 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. v6.1.2(6y ago)0621MITPHPPHP ^7.2.0 Since Aug 20Pushed 2y agoCompare [ Source](https://github.com/SierraTecnologia/countries)[ Packagist](https://packagist.org/packages/sierratecnologia/countries)[ Docs](https://sierratecnologia.com)[ RSS](/packages/sierratecnologia-countries/feed)WikiDiscussions master Synced today READMEChangelogDependencies (3)Versions (34)Used By (1) SierraTecnologia Country ======================== [](#sierratecnologia-country) **SierraTecnologia 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. [![Packagist](https://camo.githubusercontent.com/1ab5f1fc336f932ff3fe1aa10cf2a8c7d18e1c1456c1df08c4aa5eef2aef0cca/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7369657272617465636e6f6c6f6769612f636f756e74726965732e7376673f6c6162656c3d5061636b6167697374267374796c653d666c61742d737175617265)](https://packagist.org/packages/sierratecnologia/countries)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/0531d5833dae3199e5a2e44c0bd7b00da2378b5783b3e5692171ddeeffde9753/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f7369657272617465636e6f6c6f6769612f636f756e74726965732e7376673f6c6162656c3d5363727574696e697a6572267374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/sierratecnologia/countries/)[![Travis](https://camo.githubusercontent.com/afb1196273f4881e83ee4f5f5569ffb7e1905ba30bdfc1adf70e4d8b6cec386e/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f7369657272617465636e6f6c6f6769612f636f756e74726965732e7376673f6c6162656c3d5472617669734349267374796c653d666c61742d737175617265)](https://travis-ci.org/sierratecnologia/countries)[![StyleCI](https://camo.githubusercontent.com/a2bbbed12b37a7ce74d7560f65703edd7389e5162795b363e696c9441fedfadb/68747470733a2f2f7374796c6563692e696f2f7265706f732f36363033373031392f736869656c64)](https://styleci.io/repos/66037019)[![License](https://camo.githubusercontent.com/6e9c0c38305a9c81adede530f19b8cdddb1bd31ca187a2e65c33e8108fcc39c9/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f7369657272617465636e6f6c6f6769612f636f756e74726965732e7376673f6c6162656c3d4c6963656e7365267374796c653d666c61742d737175617265)](https://github.com/sierratecnologia/countries/blob/develop/LICENSE) Usage ----- [](#usage) Install via `composer require sierratecnologia/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 = \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 **^7.0**. Awesome, huh? 😃 Table Of Contents ----------------- [](#table-of-contents) - [Advanced Usage](#advanced-usage) - [Features Explained](#features-explained) - [Data Sources](#data-sources) - [Upgrade](#upgrade) - [Changelog](#changelog) - [Support](#support) - [Contributing & Protocols](#contributing--protocols) - [Security Vulnerabilities](#security-vulnerabilities) - [About SierraTecnologia](#about-sierratecnologia) - [License](#license) Advanced Usage -------------- [](#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(); // {"ara":{"official":"جمهورية مصر العربية","common":"مصر"}} $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,"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 ------------------ [](#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 forma - `eu_member` - European Union Member - `vat_rates` - Value-Added Tax - `emoji` - Emoji Flag Data Sources ------------ [](#data-sources) - Currency Data (27th Sep, 2016): - Emoji Flags (27th Sep, 2016): - World Borders (27th Sep, 2016): [http://thematicmapping.org/downloads/world\_borders.php](http://thematicmapping.org/downloads/world_borders.php) - GeoJson & SVG Flags (27th Sep, 2016): - Main Country Data, Regions, and Divisions (27th Sep, 2016): - Other Resources: - - - - - - - [https://github.com/alexrabarts/iso\_country\_codes](https://github.com/alexrabarts/iso_country_codes) - - Upgrade ------- [](#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 --------- [](#changelog) Refer to the [Changelog](CHANGELOG.md) for a full history of the project. Support ------- [](#support) The following support channels are available at your fingertips: - [Chat on Slack](https://bit.ly/sierratecnologia-slack) - [Help on Email](mailto:help@sierratecnologia.com) - [Follow on Twitter](https://twitter.com/sierratecnologia) Contributing & Protocols ---------------------------- [](#contributing--protocols) Thank you for considering contributing to this project! The contribution guide can be found in [CONTRIBUTING.md](CONTRIBUTING.md). Bug reports, feature requests, and pull requests are very welcome. - [Versioning](CONTRIBUTING.md#versioning) - [Pull Requests](CONTRIBUTING.md#pull-requests) - [Coding Standards](CONTRIBUTING.md#coding-standards) - [Feature Requests](CONTRIBUTING.md#feature-requests) - [Git Flow](CONTRIBUTING.md#git-flow) Security Vulnerabilities ------------------------ [](#security-vulnerabilities) If you discover a security vulnerability within this project, please send an e-mail to [help@sierratecnologia.com](help@sierratecnologia.com). All security vulnerabilities will be promptly addressed. About SierraTecnologia ---------------------- [](#about-sierratecnologia) SierraTecnologia 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 ------- [](#license) This software is released under [The MIT License (MIT)](LICENSE). (c) 2016-2020 SierraTecnologia LLC, Some rights reserved. ### Health Score 30 — LowBetter than 64% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity8 Limited adoption so far Community15 Small or concentrated contributor base Maturity69 Established project with proven stability Bus Factor1 Top contributor holds 89.6% 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 ~108 days Recently: every ~308 days Total 26 Last Release 845d ago Major Versions v2.0.0 → v3.0.02016-12-12 v3.1.0 → v4.0.02018-09-21 v4.0.0 → v5.0.02018-10-05 v5.0.2 → v6.0.02019-03-03 v6.1.2 → v10.0.x-dev2020-05-22 PHP version history (8 changes)v1.0.0PHP >=5.5.9 v3.0.0PHP ^7.0 v3.1.0PHP ^7.0.0 v4.0.0PHP ^7.1.3 v6.0.0PHP ^7.2.0 0.2.2.x-devPHP >=7.0 0.4.x-devPHP ^7.4 0.4.0PHP ^7.2|^8.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/c0a11577f9e4f7db7533432c22786439b3155ec7bc06be9760be7260c4ce1e0d?d=identicon)[ricardosierra](/maintainers/ricardosierra) --- Top Contributors [![Omranic](https://avatars.githubusercontent.com/u/406705?v=4)](https://github.com/Omranic "Omranic (198 commits)")[![ricardosierra](https://avatars.githubusercontent.com/u/5499444?v=4)](https://github.com/ricardosierra "ricardosierra (14 commits)")[![vinkla](https://avatars.githubusercontent.com/u/499192?v=4)](https://github.com/vinkla "vinkla (3 commits)")[![optiman](https://avatars.githubusercontent.com/u/2707476?v=4)](https://github.com/optiman "optiman (2 commits)")[![netcode](https://avatars.githubusercontent.com/u/286371?v=4)](https://github.com/netcode "netcode (1 commits)")[![madacol](https://avatars.githubusercontent.com/u/6379896?v=4)](https://github.com/madacol "madacol (1 commits)")[![andreybolonin](https://avatars.githubusercontent.com/u/2576509?v=4)](https://github.com/andreybolonin "andreybolonin (1 commits)")[![alfonsobries](https://avatars.githubusercontent.com/u/17262776?v=4)](https://github.com/alfonsobries "alfonsobries (1 commits)") --- Tags languagescountriessvgflagsSimpleFlexiblecountryemojicurrenciesgeographicdiallingdemonymSierraTecnologia ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/sierratecnologia-countries/health.svg) ``` [![Health](https://phpackages.com/badges/sierratecnologia-countries/health.svg)](https://phpackages.com/packages/sierratecnologia-countries) ``` ### Alternatives [rinvex/countries Rinvex Countries 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.7k7.4M48](/packages/rinvex-countries)[components/flag-icon-css A curated collection of all country flags in SVG — plus the CSS for easier integration. 12.0k1.6M23](/packages/components-flag-icon-css)[pragmarx/countries PHP Countries and Currencies 1.9k3.3M18](/packages/pragmarx-countries)[lipis/flag-icons A curated collection of all country flags in SVG — plus the CSS for easier integration. 12.0k27.5k4](/packages/lipis-flag-icons)[annexare/countries-list Continents & countries: ISO 3166-1 alpha-2 code, name, ISO 639-1 languages, capital, currency, native name, phone. JSON, CSV and SQL. 1.3k220.8k1](/packages/annexare-countries-list)[juanparati/iso-codes A PHP library that provides ISO codes, currencies, languages, timezones and additional geopolitical information 17146.4k](/packages/juanparati-iso-codes) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)