Search moodle.org's
Developer Documentation

See Release Notes
Long Term Support Release

  • Bug fixes for general core bugs in 4.1.x will end 13 November 2023 (12 months).
  • Bug fixes for security issues in 4.1.x will end 10 November 2025 (36 months).
  • PHP version: minimum PHP 7.4.0 Note: minimum PHP version has increased since Moodle 4.0. PHP 8.0.x is supported too.

Differences Between: [Versions 310 and 401] [Versions 39 and 401] [Versions 401 and 402] [Versions 401 and 403]

(no description)

File Size: 273 lines (10 kb)
Included or required:0 times
Referenced: 0 times
Includes or requires: 0 files

Defines 1 class

Reader:: (14 methods):
  __construct()
  city()
  country()
  anonymousIp()
  asn()
  connectionType()
  domain()
  enterprise()
  isp()
  modelFor()
  flatModelFor()
  getRecord()
  metadata()
  close()


Class: Reader  - X-Ref

Instances of this class provide a reader for the GeoIP2 database format.
IP addresses can be looked up using the database specific methods.

## Usage ##

The basic API for this class is the same for every database. First, you
create a reader object, specifying a file name. You then call the method
corresponding to the specific database, passing it the IP address you want
to look up.

If the request succeeds, the method call will return a model class for
the method you called. This model in turn contains multiple record classes,
each of which represents part of the data returned by the database. If
the database does not contain the requested information, the attributes
on the record class will have a `null` value.

If the address is not in the database, an
{@link \GeoIp2\Exception\AddressNotFoundException} exception will be
thrown. If an invalid IP address is passed to one of the methods, a
SPL {@link \InvalidArgumentException} will be thrown. If the database is
corrupt or invalid, a {@link \MaxMind\Db\Reader\InvalidDatabaseException}
will be thrown.
__construct(string $filename,array $locales = ['en'])   X-Ref
Constructor.

param: string $filename the path to the GeoIP2 database file
param: array  $locales  list of locale codes to use in name property

city(string $ipAddress)   X-Ref
This method returns a GeoIP2 City model.

param: string $ipAddress an IPv4 or IPv6 address as a string

country(string $ipAddress)   X-Ref
This method returns a GeoIP2 Country model.

param: string $ipAddress an IPv4 or IPv6 address as a string

anonymousIp(string $ipAddress)   X-Ref
This method returns a GeoIP2 Anonymous IP model.

param: string $ipAddress an IPv4 or IPv6 address as a string

asn(string $ipAddress)   X-Ref
This method returns a GeoLite2 ASN model.

param: string $ipAddress an IPv4 or IPv6 address as a string

connectionType(string $ipAddress)   X-Ref
This method returns a GeoIP2 Connection Type model.

param: string $ipAddress an IPv4 or IPv6 address as a string

domain(string $ipAddress)   X-Ref
This method returns a GeoIP2 Domain model.

param: string $ipAddress an IPv4 or IPv6 address as a string

enterprise(string $ipAddress)   X-Ref
This method returns a GeoIP2 Enterprise model.

param: string $ipAddress an IPv4 or IPv6 address as a string

isp(string $ipAddress)   X-Ref
This method returns a GeoIP2 ISP model.

param: string $ipAddress an IPv4 or IPv6 address as a string

modelFor(string $class, string $type, string $ipAddress)   X-Ref
No description

flatModelFor(string $class, string $type, string $ipAddress)   X-Ref
No description

getRecord(string $class, string $type, string $ipAddress)   X-Ref
No description

metadata()   X-Ref

return: \MaxMind\Db\Reader\Metadata object for the database

close()   X-Ref
Closes the GeoIP2 database and returns the resources to the system.