Download the PHP package midnite81/geolocation without Composer
On this page you can find all versions of the php package midnite81/geolocation. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download midnite81/geolocation
More information about midnite81/geolocation
Files in midnite81/geolocation
Package geolocation
Short Description A laravel package which wraps the IP Info DB and IP2Location Services
License MIT
Informations about the package geolocation
Geolocation
A IP Info DB integration for Laravel
Versioning
Version | Branch | PHP | Laravel | Notes |
---|---|---|---|---|
^4.0 | master/v4 | >=8.1 | >=8 | Update to include wrap Ip2Location in addition to IpInfoDb, moved to php 8.1 |
^3.0 | v3 | >=7.4 | >=6 | Facade has been removed and guzzle dependency has been updated to version 7 |
^2.0 | v2 | >=5.6 | >=5 | Corrects issues with composer 2.0 |
^1.0 | v1 | >=5.6 | >=5 | First release - not compatible with composer 2.0 |
Upgrading to v4.0
Please note:
- version 4 brings in the ability to wrap both the IpInfoDb service (as was available in previous versions) and the Ip2Location service. IpInfoDb are not accepting new registrations and are asking users to register at Ip2Location instead.
- version 4 minimum requirements are php 8.1 to make use of the additional features php 8.1 brings, such as enums and better type safety.
- version 4 has an updated config file. If you are upgrading, I would suggest checking out the config file and updating your local instance of it.
- a change has been made to the caching from minutes to seconds.
Installation
If installing on anything below PHP 8.1, please checkout the v2 or v3 branch and follow the instructions on the readme for that branch. Please note ip2location is not supported on previous versions of this package
This package requires PHP 8.1+, and includes a Laravel Service Provider.
To install through composer include the package in your composer.json
.
"midnite81/geolocation": "^4.0"
Run composer install
or composer update
to download the dependencies, or you can run
composer require midnite81/geolocation
.
Laravel Integration
This package makes use of Laravel's auto package loader, so you shouldn't need to add this
to your config/app.php file. However, if you've disabled this then you'll need to add the
GeoLocation service provider to the list of service providers
in app/config/app.php
.
'providers' => [
Midnite81\GeoLocation\GeoLocationServiceProvider::class
];
Publish the config and migration files using
php artisan vendor:publish --provider="Midnite81\GeoLocation\GeoLocationServiceProvider"
Configuration File
Once you have published the config files, you will find a geolocation.php
file in the
config
folder. You should look through these settings and update these where necessary.
Env
You will need to add the following to your .env
file and update these with your own
settings. Please note you will only need to fill in the api key for the service you are using.
Get your GeoLocation API Key
Before using this package you'll need to obtain an API Key from either IpInfoDb which is no longer accepting new registrations or Ip2Location.
Once you have signed up you will need to add your api key to the relevant .env
key; GEOLOCATION_IPINFODB_API_KEY
for
IpInfoDb or GEOLOCATION_IP2LOCATION_API_KEY
for Ip2Location.
Caching
This package allows you to cache responses, however it is your responsibility to ensure you're not breaking any terms and conditions of use.
Rate Limiting
This package does not set any rate limiting internally. You should ensure that your application adheres to any rate limiting set by your chosen provider.
Example Usage and Available Methods and Properties
- IpInfoDb example usage and available methods
- Ip2Location example usage and available methods
All versions of geolocation with dependencies
guzzlehttp/guzzle Version ^7.0
ext-json Version *
midnite81/core Version ^1.0