��ѧۧݧ�ӧ�� ާ֧ߧ֧էا֧�

��ѧۧݧ�ӧ�� ާ֧ߧ֧էا֧� - ��֧էѧܧ�ڧ��ӧѧ�� - /home/alphpwcp/public_html/us/alphachat/lib/core/lhexternal/GeoIp2/WebService/Client.php

��ѧ٧ѧ�
<?php namespace GeoIp2\WebService; use GeoIp2\Exception\AddressNotFoundException; use GeoIp2\Exception\AuthenticationException; use GeoIp2\Exception\GeoIp2Exception; use GeoIp2\Exception\HttpException; use GeoIp2\Exception\InvalidRequestException; use GeoIp2\Exception\OutOfQueriesException; use GeoIp2\ProviderInterface; use Guzzle\Common\Exception\RuntimeException; use Guzzle\Http\Client as GuzzleClient; use Guzzle\Http\Exception\ClientErrorResponseException; use Guzzle\Http\Exception\ServerErrorResponseException; /** * This class provides a client API for all the GeoIP2 web service's * end points. The end points are Country, City, City/ISP/Org, and Omni. Each * end point returns a different set of data about an IP address, with Country * returning the least data and Omni the most. * * Each web service end point is represented by a different model class, and * these model classes in turn contain multiple Record classes. The record * classes have attributes which contain data about the IP address. * * If the web service does not return a particular piece of data for an IP * address, the associated attribute is not populated. * * The web service may not return any information for an entire record, in * which case all of the attributes for that record class will be empty. * * Usage * * The basic API for this class is the same for all of the web service end * points. First you create a web service object with your MaxMind * <code>$userId</code> and <code>$licenseKey</code>, then you call the method * corresponding to a specific end point, passing it the IP address you want * to look up. * * If the request succeeds, the method call will return a model class for * the end point you called. This model in turn contains multiple record * classes, each of which represents part of the data returned by the web * service. * * If the request fails, the client class throws an exception. / class Client implements ProviderInterface { private $userId; private $licenseKey; private $locales; private $host; private $guzzleClient; /* * Constructor. * * @param int $userId Your MaxMind user ID * @param string $licenseKey Your MaxMind license key * @param array $locales List of locale codes to use in name property * from most preferred to least preferred. * @param string $host Optional host parameter * @param object $guzzleClient Optional Guzzle client to use (to facilitate * unit testing). / public function __construct( $userId, $licenseKey, $locales = array('en'), $host = 'geoip.maxmind.com', $guzzleClient = null ) { $this->userId = $userId; $this->licenseKey = $licenseKey; $this->locales = $locales; $this->host = $host; // To enable unit testing $this->guzzleClient = $guzzleClient; } /* * This method calls the GeoIP2 City endpoint. * * @param string $ipAddress IPv4 or IPv6 address as a string. If no * address is provided, the address that the web service is called * from will be used. * * @return \GeoIp2\Model\City * * @throws \GeoIp2\Exception\AddressNotFoundException if the address you * provided is not in our database (e.g., a private address). * @throws \GeoIp2\Exception\AuthenticationException if there is a problem * with the user ID or license key that you provided. * @throws \GeoIp2\Exception\OutOfQueriesException if your account is out * of queries. * @throws \GeoIp2\Exception\InvalidRequestException} if your request was * received by the web service but is invalid for some other reason. * This may indicate an issue with this API. Please report the error to * MaxMind. * @throws \GeoIp2\Exception\HttpException if an unexpected HTTP error * code or message was returned. This could indicate a problem with the * connection between your server and the web service or that the web * service returned an invalid document or 500 error code. * @throws \GeoIp2\Exception\GeoIp2Exception This serves as the parent * class to the above exceptions. It will be thrown directly if a 200 * status code is returned but the body is invalid. / public function city($ipAddress = 'me') { return $this->responseFor('city', 'City', $ipAddress); } /* * This method calls the GeoIP2 Country endpoint. * * @param string $ipAddress IPv4 or IPv6 address as a string. If no * address is provided, the address that the web service is called * from will be used. * * @return \GeoIp2\Model\Country * * @throws \GeoIp2\Exception\AddressNotFoundException if the address you * provided is not in our database (e.g., a private address). * @throws \GeoIp2\Exception\AuthenticationException if there is a problem * with the user ID or license key that you provided. * @throws \GeoIp2\Exception\OutOfQueriesException if your account is out * of queries. * @throws \GeoIp2\Exception\InvalidRequestException} if your request was * received by the web service but is invalid for some other reason. * This may indicate an issue with this API. Please report the error to * MaxMind. * @throws \GeoIp2\Exception\HttpException if an unexpected HTTP error * code or message was returned. This could indicate a problem with the * connection between your server and the web service or that the web * service returned an invalid document or 500 error code. * @throws \GeoIp2\Exception\GeoIp2Exception This serves as the parent * class to the above exceptions. It will be thrown directly if a 200 * status code is returned but the body is invalid. / public function country($ipAddress = 'me') { return $this->responseFor('country', 'Country', $ipAddress); } /* * This method calls the GeoIP2 City/ISP/Org endpoint. * * @param string $ipAddress IPv4 or IPv6 address as a string. If no * address is provided, the address that the web service is called * from will be used. * * @return \GeoIp2\Model\CityIspOrg * * @throws \GeoIp2\Exception\AddressNotFoundException if the address you * provided is not in our database (e.g., a private address). * @throws \GeoIp2\Exception\AuthenticationException if there is a problem * with the user ID or license key that you provided. * @throws \GeoIp2\Exception\OutOfQueriesException if your account is out * of queries. * @throws \GeoIp2\Exception\InvalidRequestException} if your request was * received by the web service but is invalid for some other reason. * This may indicate an issue with this API. Please report the error to * MaxMind. * @throws \GeoIp2\Exception\HttpException if an unexpected HTTP error * code or message was returned. This could indicate a problem with the * connection between your server and the web service or that the web * service returned an invalid document or 500 error code. * @throws \GeoIp2\Exception\GeoIp2Exception This serves as the parent * class to the above exceptions. It will be thrown directly if a 200 * status code is returned but the body is invalid. / public function cityIspOrg($ipAddress = 'me') { return $this->responseFor('city_isp_org', 'CityIspOrg', $ipAddress); } /* * This method calls the GeoIP2 Omni endpoint. * * @param string $ipAddress IPv4 or IPv6 address as a string. If no * address is provided, the address that the web service is called * from will be used. * * @return \GeoIp2\Model\Omni * * @throws \GeoIp2\Exception\AddressNotFoundException if the address you * provided is not in our database (e.g., a private address). * @throws \GeoIp2\Exception\AuthenticationException if there is a problem * with the user ID or license key that you provided. * @throws \GeoIp2\Exception\OutOfQueriesException if your account is out * of queries. * @throws \GeoIp2\Exception\InvalidRequestException} if your request was * received by the web service but is invalid for some other reason. * This may indicate an issue with this API. Please report the error to * MaxMind. * @throws \GeoIp2\Exception\HttpException if an unexpected HTTP error * code or message was returned. This could indicate a problem with the * connection between your server and the web service or that the web * service returned an invalid document or 500 error code. * @throws \GeoIp2\Exception\GeoIp2Exception This serves as the parent * class to the above exceptions. It will be thrown directly if a 200 * status code is returned but the body is invalid. */ public function omni($ipAddress = 'me') { return $this->responseFor('omni', 'Omni', $ipAddress); } private function responseFor($endpoint, $class, $ipAddress) { $uri = implode('/', array($this->baseUri(), $endpoint, $ipAddress)); $client = $this->guzzleClient ? $this->guzzleClient : new GuzzleClient(); $request = $client->get($uri, array('Accept' => 'application/json')); $request->setAuth($this->userId, $this->licenseKey); $this->setUserAgent($request); try { $response = $request->send(); } catch (ClientErrorResponseException $e) { $this->handle4xx($e->getResponse(), $uri); } catch (ServerErrorResponseException $e) { $this->handle5xx($e->getResponse(), $uri); } if ($response && $response->isSuccessful()) { $body = $this->handleSuccess($response, $uri); $class = "GeoIp2\\Model\\" . $class; return new $class($body, $this->locales); } else { $this->handleNon200($response, $uri); } } private function handleSuccess($response, $uri) { if ($response->getContentLength() == 0) { throw new GeoIp2Exception( "Received a 200 response for $uri but did not " . "receive a HTTP body." ); } try { return $response->json(); } catch (RuntimeException $e) { throw new GeoIp2Exception( "Received a 200 response for $uri but could not decode " . "the response as JSON: " . $e->getMessage() ); } } private function handle4xx($response, $uri) { $status = $response->getStatusCode(); if ($response->getContentLength() > 0) { if (strstr($response->getContentType(), 'json')) { try { $body = $response->json(); if (!isset($body['code']) \|\| !isset($body['error'])) { throw new GeoIp2Exception( 'Response contains JSON but it does not specify ' . 'code or error keys: ' . $response->getBody() ); } } catch (RuntimeException $e) { throw new HttpException( "Received a $status error for $uri but it did not " . "include the expected JSON body: " . $e->getMessage(), $status, $uri ); } } else { throw new HttpException( "Received a $status error for $uri with the " . "following body: " . $response->getBody(), $status, $uri ); } } else { throw new HttpException( "Received a $status error for $uri with no body", $status, $uri ); } $this->handleWebServiceError( $body['error'], $body['code'], $status, $uri ); } private function handleWebServiceError($message, $code, $status, $uri) { switch ($code) { case 'IP_ADDRESS_NOT_FOUND': case 'IP_ADDRESS_RESERVED': throw new AddressNotFoundException($message); case 'AUTHORIZATION_INVALID': case 'LICENSE_KEY_REQUIRED': case 'USER_ID_REQUIRED': throw new AuthenticationException($message); case 'OUT_OF_QUERIES': throw new OutOfQueriesException($message); default: throw new InvalidRequestException( $message, $code, $status, $uri ); } } private function handle5xx($response, $uri) { $status = $response->getStatusCode(); throw new HttpException( "Received a server error ($status) for $uri", $status, $uri ); } private function handleNon200($response, $uri) { $status = $response->getStatusCode(); throw new HttpException( "Received a very surprising HTTP status " . "($status) for $uri", $status, $uri ); } private function setUserAgent($request) { $userAgent = $request->getHeader('User-Agent'); $userAgent = "GeoIP2 PHP API ($userAgent)"; $request->setHeader('User-Agent', $userAgent); } private function baseUri() { return 'https://' . $this->host . '/geoip/v2.0'; } }

| ver. 1.4 | Github | . | PHP 8.2.30 | ��֧ߧ֧�ѧ�ڧ� ��ѧߧڧ��: 0.01 | proxy | phpinfo | ��ѧ��ۧܧ�