PackageTrack
Sign in Get early access

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.

v9.1.0 8.4M downloads/mo #1602 most downloaded on Packagist rinvex/countries

What this package is like to depend on

Last release 1 years ago

14 Jul 2025

Release timing varies

gaps range from 1 weeks to 2.2 years

Nearly every release is documented

notes for 26 of 26 stable releases

Nothing withdrawn

no release was ever pulled

10 years old

26 releases · first in 2016

0 releases in the last 12 months

see the full history below

Release timeline

26 releases · Aug 2016 to Jul 2025
2017 2018 2019 2020 2021 2022 2023 2024 2025 2026
Release Pre-release

Releases

latest 26
  1. v9.1.0 14 Jul 2025
    Release notes

    • PHP Version Compatibility & Requirements

      • 9a47cc8 - Require PHP v8.2 minimum version
      • 3416043 - Fix PHP version (#255)
      • fa976c0 - Compatibility with PHP 8.4: deprecate implicitly nullable parameter types (#265)

    • Code Quality & Type Safety Improvements

      • ca7abbe - Use strict type checking in in_array() to avoid type juggling bugs
      • 6fb548b - MixedTypeRector
      • 7710c4f - NullToStrictStringFuncCallArgRector

    • Return Type and Function Signature Improvements

      • f6dcd9e, 6cd34ad, d72ce87, fefc087, 4bf2f6a, f2ed70f - Various rectors to infer/add return types and remove useless tags
      • 475f754, 1b3cceb - Add return types to arrow functions and tests with void returns

    • Code Modernization / Rector Refactors

      • 51d3b05 - AnnotationToAttributeRector
      • 6efcef7 - RenameVariableToMatchNewTypeRector
      • 383c390 - ClosureToArrowFunctionRector
      • db96141 - InlineIfToExplicitIfRector
      • a0ea10a - ImportFQNRector

    • Code Cleanup

      • 63b2472 - Remove useless param and return tags
      • 8b28041 - Drop incomplete and unused tests/services
      • 460c266 - Use __() instead of trans() for naming consistency
      • ebef160 - Update supplementary files

    • Tooling & Dependency Updates

      • 8ed4c3e - Update phpunit/phpunit requirement
      • d4f17e3, 80e1e22 - Apply fixes from StyleCI
    Open source →
  2. v9.0.1 02 May 2023
    Release notes
    • fd95e94: Update phpunit to v10.1 from v9.5
    Open source →
  3. v9.0.0 08 Jan 2023
    Release notes
    • Drop PHP v8.0 support and update composer dependencies
    • Replace strlen with mb_strlen
    Open source →
  4. v8.1.2 29 Dec 2022
    Release notes
    • pl: ISO 3166-2 subdivision codes fixed (#225)
    Open source →
  5. v8.1.1 01 May 2022
    Release notes
    • Fix currency validator rule to check if the key is 3 capital char string
    • Fix country validator rule to check if the key is 2 lower char string
    • Add country data protection (#217)
    • Rename Belarus country german name from Weißrussland (#214 & #211)
    Open source →
  6. v8.1.0 05 Oct 2021
    Release notes
    • UK is no longer a EU member state (longlist) (#179)
    • Fix letter case for language case (fix #117 & #118)
    • Fix array access on bool when retrieving short list of countries (fix #132 & #181)
    • Fix the official Portuguese name of Portugal to República Portuguesa (fix #143 - thanks @lbassuncao)
    • Update and optimize country flags
    • Update country currencies to include only the official currency (fix #52 #55 #72)
    • Fix Mexico subregion to North America Instead of Central America (fix #124)
    • If Italy native official name in shortlist (fix #192)
    • Replace not allowed integer WMO code values with null to omit php type errors
    • Replace not allowed integer DS code values with null to omit php type errors
    • Replace not allowed integer FIPS code values with null to omit php type errors
    • Replace not allowed integer IOC code values with null to omit php type errors
    • Replace not allowed integer COWC code values with null to omit php type errors
    • Replace not allowed integer AR5 code values with null to omit php type errors
    • Fix Antarctica currency to null
    • Fix issues with currencies longlist retrieval (fix #167)
    Open source →
  7. v8.0.0 22 Aug 2021
    Release notes
    • Drop PHP v7 support
    • Update composer dependencies
    • Upgrade to GitHub-native Dependabot (#183)
    • Fixed bug that prevents default value to be returned from get method when attribute exists but is null (#177)
    Open source →
  8. v7.3.2 25 Dec 2020
    Release notes
    • Add support for PHP v8
    Open source →
  9. v7.3.1 22 Dec 2020
    Release notes
    • Typo (#171)
    • Update composer dependencies
    • UK is no longer a EU member state (#164)
    Open source →
  10. v7.3.0 17 Jul 2020
    Release notes
    • Fix updated ioc codes for Singapore & Lebanon (fix #146)
    • Add test cases for timezones and locales (Thanks @ker0x #66 #11)
    • Add methods getTimezones and getLocales (#66) (Fixes #11)
    • Update dutch reduced VAT rate (#139)
    Open source →
  11. v7.2.0 17 Jul 2020
    Release notes
    • Filter, sort, and check currencies uniqueness and fix returned array keys (BREAKING CHANGE!)
    • Fix currencies validation rule
    Open source →
  12. v7.1.0 16 Jul 2020
    Release notes
    • Add currency Laravel validation rule
    • Fix wrong currencies method naming (BREAKING CHANGE!)
    Open source →
  13. v7.0.1 04 Apr 2020
    Release notes
    • Drop laravel/helpers usage as it's no longer used
    Open source →
  14. v7.0.0 15 Mar 2020
    Release notes
    • Upgrade to Laravel v7.1.x & PHP v7.4.x
    Open source →
  15. v6.1.2 13 Mar 2020
    Release notes
    • Tweak TravisCI config
    • Add currencies listing (#130) a89f5d9
    • solve testing wrong files paths (#131)
    • Arrange currencies to return default currency for each country - Sort shortlist and longlist by country code / key & Add currency to shortlist
    • Tweak currency loader to support both longlist & shortlist
    • Update StyleCI config
    • Enforce consistency
    Open source →
  16. v6.1.1 23 Sep 2019
    Release notes
    • Add missing laravel/helpers composer package
    Open source →
  17. v6.1.0 02 Jun 2019
    Release notes
    • Update composer deps
    • Drop PHP 7.1 travis test
    Open source →
  18. v6.0.0 03 Mar 2019
    Release notes
    • Rename environment variable QUEUE_DRIVER to QUEUE_CONNECTION
    • Require PHP 7.2 & Laravel 5.8
    • Apply PHPUnit 8 updates
    Open source →
  19. v5.0.2 23 Dec 2018
    Release notes
    • Fix dialing code for Caribbean Netherlands, Curaçao","official, Saint Helena (fix #79)
    • Mexico City is no longer called Distrito Federal
    • New currency code: VEF became VES
    Open source →
  20. v5.0.1 22 Dec 2018
    Release notes
    • Update composer dependencies
    • Add PHP 7.3 support to travis
    • Mexico City is no longer called Distrito Federal
    Open source →
  21. v5.0.0 05 Oct 2018
    Release notes
    • Enforce Consistency
    • Rename package to rinvex/countries
    Open source →
  22. v4.0.0 21 Sep 2018
    Release notes
    • Simplify code by using PHP7 null coalescing operator
    • Fix stupid gitattributes export-ignore issues
    • Rename country variable to countryCode for naming consistency
    • Remove file header docblock
    • Push forward PHPUnit version
    • Update composer config
    • Fix deprecated PHPUnit TestCase namespace
    • Disable travis email notifications
    • Fix git export-ignore dotfiles
    • Support the new StyleCI CSS/JS beta features
    • Add PHPUnitPrettyResultPrinter
    • Enforce consistency
    • Require PHP 7.1.0 at least
    • Tweak composer file
    • Typehint method returns
    • Fix wrong method return types
    • Update minimum required PHP version
    • Update composer packages
    • Update travis php versions
    • Add Laravel Auto Discovery support and validation rule
    • Add missing Kosovo emoji
    • Drop StyleCI multi-language support (paid feature now!)
    • Prepare and tweak testing configuration
    • Update PHPUnit options
    Open source →
  23. v3.1.0 07 Mar 2017
    Release notes
    • Format country code to small case before retrieval
    • Change internal methods visibility to protected
    • Update StyleCI fixers and other supplementary files
    • Enforce strict type declaration
    • Enforce consistency and rename Country Loader class
    • Execute reflections once per test class
    • Fix strict type declaration issues and tweak code
    • Update Ukrainian phone prefixes and native name fix
    Open source →
  24. v3.0.0 12 Dec 2016
    Release notes
    • Drop PHP 5.6 support
    • Drop leaking dependency
    • Require PHP 7.0 as a minimum requirement
    • Fix wrong CountryLoaderException namespace (close #43)
    • Add test suites for Loader class & helper methods (close #42)
    • Apply few tweaks and enhancements
    • Fix wrong tests namespace
    • Add missing test cases
    • Arrange country files into specific data domains
    • Update .styleci.yml and .gitignore config
    • Refactor documentation for easy reading
    • Enforce clean git export archive
    • fixed ukrainian data
    • Drop LTS support
    Open source →
  25. v2.0.0 27 Nov 2016
    Release notes
    • Rewrite from scratch, add massively extensive country data
      • Add emoji flags & their unicode attributes (close #6)
      • Add GeoJson data (close #20)
      • Add SVG flags (close #19)
      • Add separate country files (close #13)
      • Compress longlist for production usage
      • Add countries short list
      • Re-write form scratch for better & more intuitive API
      • Add country divisions (close #22)
      • Separate country translations into individual files (close #24)
      • Add unit testing suite
      • Add useful helpers
      • Drop illuminate dependencies
      • Refactor documentation
    Open source →
  26. v1.0.0 20 Aug 2016
    Release notes
    • Tag first release.
    Open source →

Every package, every release, already written down.

The archive is open and free. Watching your own project is what we are building next.

Browse the archive