Proyectos de Subversion Moodle

<?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 Plus and Insights web services 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 Plus and Insights web services 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 Plus and Insights web services 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

 * 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 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 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 Insights.

 * @property-read bool $isResidentialProxy This is true if the IP address is

 * on a suspected anonymizing network and belongs to a residential ISP. This

 * property is only available from GeoIP2 Insights.

 * @property-read bool $isSatelliteProvider *Deprecated.* Due to the

 * increased coverage by mobile carriers, very few satellite providers now

 * 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 Insights.

 * @property-read string|null $isp The name of the ISP associated with the IP

 * address. This attribute is only available from the City Plus 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 Plus and Insights web services and the GeoIP2 Enterprise database.

 * @property-read string|null $mobileCountryCode The [mobile country code

 * (MCC)](https://en.wikipedia.org/wiki/Mobile_country_code) associated with

 * the IP address and ISP. This property is available from the City Plus and

 * Insights web services and the GeoIP2 Enterprise database.

 * @property-read string|null $mobileNetworkCode The [mobile network code

 * (MNC)](https://en.wikipedia.org/wiki/Mobile_country_code) associated with

 * the IP address and ISP. This property is available from the City Plus 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

 * 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 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>consumer_privacy_network

 *    <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

     *

     * @var array<string>

     */

    protected $validAttributes = [

        'autonomousSystemNumber',

        'autonomousSystemOrganization',

        'connectionType',

        'domain',

        'ipAddress',

        'isAnonymous',

        'isAnonymousProxy',

        'isAnonymousVpn',

        'isHostingProvider',

        'isLegitimateProxy',

        'isp',

        'isPublicProxy',

        'isResidentialProxy',

        'isSatelliteProvider',

        'isTorExitNode',

        'mobileCountryCode',

        'mobileNetworkCode',

        'network',

        'organization',

        'staticIpScore',

        'userCount',

        'userType',

    ];

    public function __construct(?array $record)

    {

        if (!isset($record['network']) && isset($record['ip_address'], $record['prefix_len'])) {

            $record['network'] = Util::cidr($record['ip_address'], $record['prefix_len']);

        }

        parent::__construct($record);

    }

}