Laravel Location ▲
This Package offers a simple way to get Countries, Cities and States that you may need for your Application, most especially for dropdown menus.
Step One - Install via Composer
Require the package via composer into your project
composer require ichtrojan/laravel-location
Step Two - Publish Configurations
Laravel location provides you with an easy way of customizing the tables used for storing Countries, States and Cities. Also, you can customisethe route prefix and middleware. To customize these you need to publish the configuration file. To publish the configuration file, run:
php artisan vendor:publish --tag=laravel-location
You will have
config/location.php available for you to edit. The default configurations are:
<?php return [ 'countries_table' => 'countries', 'cities_table' => 'cities', 'states_table' => 'states', 'routes' => [ 'prefix' => 'location', 'middleware' => 'web' ] ];
You can go ahead and customize the
route prefix and
middleware as you need before running the Migration.
Step Three - Running Migrations
before you do this make sure your correct Database credentials are set in the
php artisan migrate
Finally, run the Package seeders
php artisan db:seed --class=Ichtrojan\\Location\\Seeds\\LocationDatabaseSeeder
The routes below are prefixed with
locationwhich is the default configuration set in the
config/location.phpfile. If mofified, replace the prefixin your route with the correct prefix.
||return all countries|
||return a single country by its ID|
||return all states|
||return a single state by its ID|
||return all states in a country using the country ID|
||return all cities|
||return a single city by its ID|
||return all cities in a state using the state ID|
Free for all, if you find an issue with the package or if a group of people somehow created a new country please send in a PR.