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.

#Rinvex Country

Rinvex Country is a Laravel package designed to provide comprehensive details about countries worldwide. It includes data for all 250 countries, covering aspects such as names, capitals, demonym, ISO codes, dialling codes, currencies, flags, and emojis, among other attributes.

#Key Features

• Comprehensive Country Details: Access detailed information about each country including official names, ISO codes, geo-coordinates, currencies, and more.
• Flexible Retrieval: Fetch data for a single country or multiple countries with conditions.
• Rich Data Attributes: Includes diverse attributes like borders, languages, emoji flags, and currency details.
• Framework Agnostic: Compatible with any PHP framework, requiring only PHP version ^7.0.
• Easy Installation: Can be easily installed via Composer.

#Installation

Install the package through Composer:

composer require rinvex/countries

#Usage

// Retrieve single country details
$egypt = country('eg');
echo $egypt->getName(); // Outputs the name of Egypt
echo $egypt->getEmoji(); // Outputs the emoji flag of Egypt
 
// Retrieve multiple countries or with conditions
$countries = countries(); // Fetch all countries
$oceanianCountries = \Rinvex\Country\CountryLoader::where('geo.continent', ['OC' => 'Oceania']); // Specific condition

#Advanced Usage

Access detailed attributes and perform complex queries to fetch customized data sets:

// Advanced details retrieval
echo $egypt->getOfficialName();
echo $egypt->getCurrencies();
 
// Use conditions to filter data
$whereCountries = \Rinvex\Country\CountryLoader::where('geo.continent', ['OC' => 'Oceania']);

#Documentation

The package includes detailed documentation on various features such as advanced usage scenarios, data sources, and how to contribute to the package development.

#Support and Contributions

Support is provided via multiple channels including Slack, Email, and Twitter. Contributions are welcomed and the contribution guidelines can be found in the project's repository.

For more details, visit the package repository on GitHub.

This Laravel package is handy for developers needing to utilize country-specific data efficiently and supports a broad range of applications from location-based services to international e-commerce solutions.