PHP download

Download the PHP package raiolanetworks/atlas without Composer

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

Table of contents
Download raiolanetworks/atlas
More information about raiolanetworks/atlas
Files in raiolanetworks/atlas

Vendor raiolanetworks
Package atlas
Short Description Get the data from the most recondite place with 'Atlas'
License MIT
Homepage https://github.com/RaiolaNetworks/Atlas

Keywords laravel countries country city cities atlas raiolanetworks

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 raiolanetworks/atlas

Informations about the package atlas

Get the data from the most recondite place with 'Atlas'

With 'Atlas' you will be able to create new tables in the database and fill them with information about countries, states, cities, timezones and more.

Requirements

PHP 8.3+
Laravel 12+

Get to know us

Installation

Install the package via Composer:

Optionally publish the config file to customise table names or toggle entities:

Run the migrations and seed the database:

The command will migrate the tables for every entity enabled in config('atlas.entities') (all enabled by default) and let you choose which seeders to run. The process may take a few minutes due to the large number of cities.

To re-seed the data after a package upgrade:

Other publishable resources

Note: Migrations are auto-loaded by the package. Do not publish them with --tag="atlas-migrations" unless you have a specific reason — published copies will cause "table already exists" errors.

Usage

Internally, the package works with Laravel models, which allows you to work with this model as if they were models of your own project.

For example, if you want to get all the countries in Africa:

State hierarchy

States support multi-level administrative divisions. Use admin_level to distinguish between primary regions (level 1) and subdivisions (level 2+):

Scope and limitations

The hierarchy support is intentionally uneven — read this before relying on it:

admin_level, topLevel() and adminLevel() work for every country. They classify each division as primary (level 1) or subdivision (level 2), which is enough to keep dropdowns to first-level divisions.
parent() / children() only return data for the countries where parent_id is populated (340 divisions): Spain, France, Italy, Belgium, Ireland, Sri Lanka, Fiji, Bosnia & Herzegovina, Equatorial Guinea and Saint Kitts & Nevis. For any other country parent_id is null, so parent() returns null and children() returns an empty collection.
topLevel() does not guarantee unique names within a country. A few countries have two co-equal first-level divisions that share a name — e.g. Minsk oblast + Minsk city (BY), Almaty region + Almaty city (KZ), Moscow oblast + Moscow city (RU), Zagreb county + Zagreb city (HR), cities vs counties in Taiwan, state cities vs municipalities in Latvia. These are genuinely different places (not parent/child), so both correctly stay at level 1. Disambiguate them by type or state_code:

Upgrading

If you are upgrading between major versions, please see UPGRADE.md for the list of breaking changes and migration steps.

Changelog

Please see CHANGELOG for more information on what has changed recently.

Credits

License

The MIT License (MIT). Please see License File for more information.

All versions of atlas with dependencies

PHP Build Version

Package Version

Version 3.0.2 Release 16. Jul 2026
create-project require 0 people chose require and
0 people chose create-project.

Download

Download latest version of atlas from vendor raiolanetworks

Requires php Version ^8.3
laravel/framework Version ^12.60|^13.10
laravel/prompts Version ^0.3
halaxa/json-machine Version ^1.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 raiolanetworks/atlas contains the following files

Loading the files please wait ...