raiolanetworks/atlas

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

1.0.1 2024-10-10 08:11 UTC

Requires

• php: ^8.2
• illuminate/contracts: ^10.0||^11.0
• laravel/framework: 11.*
• laravel/prompts: ^0.1.25
• spatie/laravel-package-tools: ^1.14.0

Requires (Dev)

• larastan/larastan: ^2.0.1
• laravel/pint: ^1.14
• nunomaduro/collision: ^8.1.1||^7.10.0
• orchestra/testbench: ^9.5
• pestphp/pest: ^2.34
• pestphp/pest-plugin-arch: ^2.7
• pestphp/pest-plugin-laravel: ^2.3

MIT

• Martín Gómez
• Victor Escribano

• laravel
• countries
• country
• city
• cities
• atlas
• raiolanetworks

README

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.

Get to know us

Installation

You can install the package via composer:

composer require raiolanetworks/atlas

You can publish the migrations with:

php artisan vendor:publish --tag="atlas-migrations"

Also, you can publish the config file with:

php artisan vendor:publish --tag="atlas-config"

Finally, you can publish the data jsons file with:

php artisan vendor:publish --tag="atlas-jsons"

For run the migrations and fill the tables you should run:

php artisan atlas:install

This will migrate the database tables previously allowed in the configuration file in the entities section. (By default, all are allowed)

When the command is executed, it will give the option to select which seeders to run.

The process may take a few minutes as the number of cities is very large.

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:

use Raiolanetworks\Atlas\Models\Country;

class MyClass
{
	public function getAllAfricaCountries(): Collection
	{
		Country::whereRegion('Africa')
			->orderBy('name')
			->get();
		}
}

Changelog

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

Credits

• Martín Gómez
• Víctor Escribano

License

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