How can I use country list data in a Node.js or JavaScript project?

Download the JSON or CSV files directly from the repository and import them; no PHP is needed for consumption, though building requires Docker and PHP tooling.

Country list vs ISO 3166-1 raw data: which should I use?

Country list saves time with pre-processed, multilingual formats, but for the most current official data, ISO sources may be better if you need to handle updates manually.

How to add a custom language or update country names in country-list?

Use the provided Docker build script after modifying source files; contributions are managed via GitHub, but the process requires familiarity with the toolchain.

Does country list include currency or timezone information?

No, it only covers country names and ISO codes. For currency data, refer to the author's related 'Currency List' project, and use other libraries for time zones.

What's the best format for quickly populating a database with country data?

Use the SQL formats (MySQL, PostgreSQL, SQLite) provided, as they include ready-to-run scripts for direct database insertion without extra parsing.

How often is the country list updated with new countries or changes?

Updates are community-driven via the build script; there's no fixed schedule, so check the GitHub repository for recent activity or fork to maintain your own version.

Open-Awesome

Country List

MITHTML

A comprehensive collection of country names and ISO 3166-1 codes in multiple languages and data formats.

GitHub

5.3k stars1.5k forks0 contributors

What is Country List?

Country List is a PHP library and dataset that provides a comprehensive list of all countries with their official names and ISO 3166-1 codes. It solves the problem of sourcing and maintaining accurate, up-to-date country information for software applications that require internationalization or geographic data.

Target Audience

Developers building applications with international user bases, such as e-commerce platforms, registration forms, analytics tools, or any software needing country selection or localization features.

Value Proposition

It offers a reliable, standardized, and easily integrable dataset in multiple formats and languages, saving developers from the tedious and error-prone task of manually collecting and updating country information.

Overview

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

Use Cases

Best For

Populating country dropdowns in web forms
Localizing country names for multilingual applications
Validating country codes in data processing pipelines
Seeding databases with standardized country data
Building geographic data visualizations
Integrating country data into APIs or microservices

Not Ideal For

Applications requiring real-time updates to geopolitical boundaries or newly recognized countries
Projects needing additional geographic data like capitals, populations, or time zones
Teams avoiding PHP dependencies or Docker-based build tooling
Simple prototypes where a minimal, hardcoded list of major countries suffices

Pros & Cons

Pros

Broad Language Support

Provides country names in dozens of languages, enabling easy localization as shown in the extensive data directory with separate folders for each language.

Multiple Output Formats

Offers data in over 10 formats including JSON, YAML, and SQL, making integration straightforward across various platforms and tech stacks.

ISO Standard Compliance

Includes both alpha-2 and alpha-3 country codes per ISO 3166-1, ensuring accuracy and compatibility with international systems.

Customizable Build Process

Features a Docker-based build script to regenerate datasets, allowing for updates and contributions without manual data handling.

Cons

PHP-Centric Distribution

Primarily distributed as a Composer package with PHP-focused documentation, which may complicate usage in non-PHP environments despite format availability.

Static Data Model

Data is pre-generated and not dynamically updated, so changes require manual rebuilding or waiting for new releases, limiting real-time adaptability.

Limited Feature Scope

Focuses solely on country names and codes, lacking integrated data like currencies or locales, requiring additional libraries for full internationalization.

Frequently Asked Questions

Related Projects

PHPGeo

Simple Yet Powerful Geo Library for PHP

Stars1,612

Forks199

Last commit6 months ago

GeoTools

Geo-related tools PHP 7.3+ library built atop Geocoder and React libraries

Stars1,406

Forks128

Last commit4 months ago

GeoJSON

GeoJSON implementation for PHP

Stars306

Forks47

Last commit2 years ago

A geocoding library

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub