Download the PHP package khudayberdiyev/uzbekistan-regions without Composer

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

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 khudayberdiyev/uzbekistan-regions

Informations about the package uzbekistan-regions

Uzbekistan Regions

English · O'zbekcha

tests

Regions, districts and quarters (mahalla) of Uzbekistan for Laravel: Eloquent models, migrations, the full SOATO dataset and a ready-to-use REST API — in Uzbek Latin, Uzbek Cyrillic and Russian.

The dataset ships with the package: 14 regions, 209 districts and cities, 2 641 quarters.

Installation

Create the tables and load the data:

To change any default, publish the config file:

Working with the models

Every region and district is classified, so a picker can show only what it needs:

The type comes from the SOATO code itself — the fifth digit is 4 for a city and 2 for a district — so it stays correct as the dataset grows.

All three models expose two query scopes — the API is built on the very same ones:

Referencing them from your own models:

API

The package registers these read-only endpoints automatically:

Method URI Returns
GET /api/v1/regions list of regions
GET /api/v1/regions/{id} region + districts + quarters
GET /api/v1/districts districts, filterable by ?region_id=
GET /api/v1/districts/{id} district + region + quarters
GET /api/v1/quarters quarters, filterable by ?district_id= / ?region_id=
GET /api/v1/quarters/{id} quarter + district + region

Query parameters: type (region / city / republic for regions, district / city for districts), search, sort (id, name, soato_id), order (asc / desc) and per_page — when present, the response is paginated.

The language is selected with the Accept-Language header: uz (default), oz, ru.

Responses use the standard Laravel resource format:

With per_page the usual links and meta blocks are added.

Data

The names and SOATO codes come from the administrative-territorial classifier of Uzbekistan. This particular compilation was built from MIMAXUZ/uzbekistan-regions-data, taken in April 2025 and corrected since — see database/data/SOURCE.md for what was changed and for the open question about that repository's GPL-3.0 license.

Configuration

config/uzbekistan-regions.php:

Tests

CI runs the suite on PHP 8.2, 8.3 and 8.4 against Laravel 12, and once more against PostgreSQL — the search scope uses ILIKE there and cased LIKE variants everywhere else. Laravel 11 is still allowed by the version constraint but is no longer covered by CI: every 11.x release now carries unpatched security advisories, and Composer refuses to install it.

License

The code is MIT. For the data, see database/data/SOURCE.md.

All versions of uzbekistan-regions with dependencies

PHP Build Version
Package Version
Requires php Version ^8.2
illuminate/support Version ^11.0 || ^12.0
illuminate/database Version ^11.0 || ^12.0
illuminate/http Version ^11.0 || ^12.0
illuminate/routing Version ^11.0 || ^12.0
illuminate/console Version ^11.0 || ^12.0
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 khudayberdiyev/uzbekistan-regions contains the following files

Loading the files please wait ...