Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 4.0.x will end 8 May 2023 (12 months).
  • Bug fixes for security issues in 4.0.x will end 13 November 2023 (18 months).
  • PHP version: minimum PHP 7.3.0 Note: the minimum PHP version has increased since Moodle 3.10. PHP 7.4.x is also supported.
<?php

> declare(strict_types=1); namespace GeoIp2\Record; >
use GeoIp2\Util; /** * Contains data for the traits record associated with an IP address. * * This record is returned by all location services and databases. * * @property-read int|null $autonomousSystemNumber The autonomous system number * associated with the IP address. See * https://en.wikipedia.org/wiki/Autonomous_system_(Internet%29. This attribute * is only available from the City and Insights web service and the GeoIP2 * Enterprise database. * @property-read string|null $autonomousSystemOrganization The organization * associated with the registered autonomous system number for the IP address. * See https://en.wikipedia.org/wiki/Autonomous_system_(Internet%29. This * attribute is only available from the City and Insights web service and the * GeoIP2 Enterprise database. * @property-read string|null $connectionType The connection type may take the * following values: "Dialup", "Cable/DSL", "Corporate", "Cellular". * Additional values may be added in the future. This attribute is only * available in the GeoIP2 Enterprise database. * @property-read string|null $domain The second level domain associated with the * IP address. This will be something like "example.com" or "example.co.uk", * not "foo.example.com". This attribute is only available from the * City and Insights web service and the GeoIP2 Enterprise * database. * @property-read string $ipAddress The IP address that the data in the model * is for. If you performed a "me" lookup against the web service, this * will be the externally routable IP address for the system the code is * running on. If the system is behind a NAT, this may differ from the IP * address locally assigned to it. This attribute is returned by all end * points. * @property-read bool $isAnonymous This is true if the IP address belongs to * any sort of anonymous network. This property is only available from GeoIP2 * Precision Insights. * @property-read bool $isAnonymousProxy *Deprecated.* Please see our GeoIP2 * Anonymous IP database * (https://www.maxmind.com/en/geoip2-anonymous-ip-database) to determine * whether the IP address is used by an anonymizing service. * @property-read bool $isAnonymousVpn This is true if the IP address is * registered to an anonymous VPN provider. If a VPN provider does not register * subnets under names associated with them, we will likely only flag their IP * ranges using the isHostingProvider property. This property is only available * from GeoIP2 Precision Insights. * @property-read bool $isHostingProvider This is true if the IP address belongs * to a hosting or VPN provider (see description of isAnonymousVpn property). * This property is only available from GeoIP2 Precision Insights. * @property-read bool $isLegitimateProxy This attribute is true if MaxMind * believes this IP address to be a legitimate proxy, such as an internal * VPN used by a corporation. This attribute is only available in the GeoIP2 * Enterprise database. * @property-read bool $isPublicProxy This is true if the IP address belongs to * a public proxy. This property is only available from GeoIP2 Precision * Insights.
> * @property-read bool $isResidentialProxy This is true if the IP address is * @property-read bool $isSatelliteProvider *Deprecated.* Due to the > * on a suspected anonymizing network and belongs to a residential ISP. This * increased coverage by mobile carriers, very few satellite providers now > * property is only available from GeoIP2 Precision Insights.
* serve multiple countries. As a result, the output does not provide * sufficiently relevant data for us to maintain it. * @property-read bool $isTorExitNode This is true if the IP address is a Tor * exit node. This property is only available from GeoIP2 Precision Insights. * @property-read string|null $isp The name of the ISP associated with the IP * address. This attribute is only available from the City and Insights web * services and the GeoIP2 Enterprise database. * @property-read string $network The network in CIDR notation associated with * the record. In particular, this is the largest network where all of the * fields besides $ipAddress have the same value. * @property-read string|null $organization The name of the organization associated * with the IP address. This attribute is only available from the City and * Insights web services and the GeoIP2 Enterprise database. * @property-read float|null $staticIPScore An indicator of how static or * dynamic an IP address is. This property is only available from GeoIP2 * Precision Insights. * @property-read int|null $userCount The estimated number of users sharing * the IP/network during the past 24 hours. For IPv4, the count is for the * individual IP. For IPv6, the count is for the /64 network. This property is * only available from GeoIP2 Precision Insights. * @property-read string|null $userType <p>The user type associated with the IP * address. This can be one of the following values:</p> * <ul> * <li>business * <li>cafe * <li>cellular * <li>college * <li>content_delivery_network * <li>dialup * <li>government * <li>hosting * <li>library * <li>military * <li>residential * <li>router * <li>school * <li>search_engine_spider * <li>traveler * </ul> * <p> * This attribute is only available from the Insights web service and the * GeoIP2 Enterprise database. * </p> */ class Traits extends AbstractRecord { /** * @ignore */ protected $validAttributes = [ 'autonomousSystemNumber', 'autonomousSystemOrganization', 'connectionType', 'domain', 'ipAddress', 'isAnonymous', 'isAnonymousProxy', 'isAnonymousVpn', 'isHostingProvider', 'isLegitimateProxy', 'isp', 'isPublicProxy',
> 'isResidentialProxy',
'isSatelliteProvider', 'isTorExitNode', 'network', 'organization', 'staticIpScore', 'userCount', 'userType', ];
< public function __construct($record)
> public function __construct(?array $record)
{ if (!isset($record['network']) && isset($record['ip_address']) && isset($record['prefix_len'])) { $record['network'] = Util::cidr($record['ip_address'], $record['prefix_len']); } parent::__construct($record); } }