Returns geo data based on IP - uses Maxmind databases (free/commercial)
Installs: 2 881
Open Issues: 0
- geoip2/geoip2: ~2.9
- typo3/cms-core: ^8.7 || ^9.5
- typo3/cms-scheduler: ^8.7 || ^9.5
- typo3-ter/ip2geo: 1.0.1
This package is auto-updated.
Last update: 2023-06-06 17:26:41 UTC
What does it do?
This extension provides scheduler job to download maxmind database (free or commercial) and some small class with methods to get interesting content like country, continent etc.
How to install?
Install using composer:
composer require sourcebroker/ip2geo
Go to Scheduler module and add new job "Download geolocation database"
While adding scheduler job you need two parameters:
Database name. This can an be any string. Example: "freeCountry", "commercialCountry". This name will be used later in php code like
Download URL. Maxmind database download link.
- For country lite database the url is: https://geolite.maxmind.com/download/geoip/database/GeoLite2-Country.tar.gz
- For city lite database the url is: https://geolite.maxmind.com/download/geoip/database/GeoLite2-City.tar.gz
- If the links above does not work here is the page at maxmind with list databases: https://dev.maxmind.com/geoip/geoip2/geolite2/
Run the scheduler and check folder
/uploads/tx_ip2geo/. The database should be downloaded there.
How to use?
In your code get the data with following call:
For country database:
$countryCode = GeoIp::getInstance('freeCountry')->getCountryCode(); // assuming you named database with "freeCountry" in scheduler task
For IP 184.108.40.206 you will get "DE" as response:
For city database:
$locationData = GeoIp::getInstance('freeCity')->getLocation(); // assuming you named database with "freeCity" in scheduler task
For IP 220.127.116.11 you will get following data as response:
Array ( [continentCode] => EU [countryCode] => DE [countryName] => Germany [city] => Berlin [postalCode] => 10178 [latitude] => 52.5196 [longitude] => 13.4069 )
You can set some options for this extension in
$GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['ip2geo']. You can use
typo3conf/LocalConfiguration file to store this values.
defaultLocalIPFor local development you IP is usually 127.0.0.1 and this IP of course does not exist in Maxmind database. For this situation Maxminf API will return "The address 127.0.0.1 is not in the database.". You can fix it by setting default IP if the IP is detected as 127.0.0.1. Example configuration:
'EXTCONF' => [ 'ip2geo' => [ 'defaultLocalIP' => '18.104.22.168', ], ],
fakeIpHeaderNameThis is a name of header which you can use to overwrite the value of IP. This value must be unique so nobody except you can overwrite IP. TIP: a nice chrome extension for setting headers is "ModHeader". Example:
'EXTCONF' => [ 'ip2geo' => [ 'fakeIpHeaderName' => 'myFakeIpHeader1991718263162831', ], ],
fakeIpHeaderName has precedence over
defaultLocalIP when both are set.