PHP download

Download the PHP package oc/world-countries without Composer

On this page you can find all versions of the php package oc/world-countries. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

Table of contents
Download oc/world-countries
More information about oc/world-countries
Files in oc/world-countries

Vendor oc
Package world-countries
Short Description Framework-agnostic access to world countries and ISO 3166-2 regions from bundled JSON datasets
License MIT
Homepage https://octacrafts.com

Keywords php geography countries regions iso-3166 iso-3166-2 world-countries

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:

If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.

Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
To use Composer is sometimes complicated. Especially for beginners.
Composer needs much resources. Sometimes they are not available on a simple webspace.
If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.

Please rate this library. Is it a good library?

Example code of oc/world-countries

Informations about the package world-countries

oc/world-countries

Framework-agnostic access to world countries and ISO 3166-2 regions/subdivisions from bundled JSON datasets.

Maintained by OctaCrafts.

No database. No external API. No runtime downloads. Everything works entirely from local JSON files shipped with the package.

About OctaCrafts

OctaCrafts is a global IT systems and software engineering company that builds scalable digital ecosystems for businesses worldwide. From idea to launch, the team delivers enterprise-grade solutions focused on long-term growth, performance, and reliability.

What we do:

Web Development & Design — modern, responsive, high-performance websites
SaaS & ERP Solutions — custom platforms that automate workflows and centralize operations
Mobile Apps Development — scalable Android, iOS, and cross-platform applications
DevOps & Deployment — secure cloud infrastructure, automation, and monitoring
Web Maintenance — ongoing security updates, backups, and technical support
Infographics & Motion Graphics — visual content and animations for clear communication

Beyond client projects, OctaCrafts maintains open-source PHP libraries under the oc/* package family on GitHub @octacrafts. Each ecosystem follows a core-plus-wrapper pattern: framework-agnostic cores for plain PHP and any PSR-compliant app, with dedicated integrations for popular frameworks.

oc/world-countries is the framework-agnostic core for country and region data. For Laravel projects, use oc-world-countries-laravel. Symfony and other framework wrappers are planned.

Requirements

PHP 8.2+
ext-json
ext-mbstring

Installation

Quick Start

Usage Examples

Countries

Regions

API Reference

`WorldCountries`

Method	Return Type	Description
`countries()`	`list<Country>`	All countries
`country(string $alpha2)`	`?Country`	Find country by alpha-2 code
`countryByAlpha3(string $alpha3)`	`?Country`	Find country by alpha-3 code
`hasCountry(string $code)`	`bool`	Check if country exists (alpha-2 or alpha-3)
`regions(string $countryCode)`	`list<Region>`	All regions for a country
`region(string $countryCode, string $regionCode)`	`?Region`	Find a specific region
`hasRegion(string $countryCode, string $regionCode)`	`bool`	Check if region exists
`searchCountries(string $query)`	`list<Country>`	Search countries by name or code
`searchRegions(string $countryCode, string $query)`	`list<Region>`	Search regions by name or code
`countryOptions()`	`array<string, string>`	Alpha-2 code to country name map
`regionOptions(string $countryCode)`	`array<string, string>`	Region code to region name map

DTOs

All public methods return typed, immutable DTOs — never raw JSON arrays.

Oc\WorldCountries\DTOs\Country

string $alpha2
string $alpha3
string $name
string $numeric
?string $flag

Oc\WorldCountries\DTOs\Region

string $countryAlpha2
string $countryAlpha3
string $code
string $name
string $type

Advanced Usage

The package uses constructor dependency injection with sensible defaults. You can inject custom repository implementations for testing or framework wrappers:

Package Goals

Framework agnostic — works in plain PHP, Laravel, Symfony, Laminas, and any PSR-compliant application
Offline first — all data bundled as JSON, loaded once and cached in memory
Type safe — readonly DTOs, strict types, no magic arrays
Production ready — validated datasets, meaningful exceptions, comprehensive test coverage
Wrapper friendly — clean core API designed for future Laravel and Symfony integration packages

Testing

License

MIT License. See LICENSE for details.

OctaCrafts — Scalable IT Systems & AI-Driven Digital Ecosystems

octacrafts.com · [email protected] · +1 (855) 424 4706

All versions of world-countries with dependencies

PHP Build Version

Package Version

Version v1.0.0 Release 12. Jun 2026
create-project require 0 people chose require and
0 people chose create-project.

Download

Download latest version of world-countries from vendor oc

Requires php Version ^8.2
ext-json Version *
ext-mbstring Version *

Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package oc/world-countries contains the following files

Loading the files please wait ...