Ipinfo::checkErrors() - Code Metrics - Inspection of "Merge pull request #35 from DavidePastore/throw-ex..." - DavidePastore/ipinfo - Measure and Improve Code Quality continuously with Scrutinizer

Passed

Push — master ( 5779d7...0ea5da )

by Davide

created 2018-11-01 15:32 UTC

Ipinfo::checkErrors() A

↳ Parent: Ipinfo

Complexity

Conditions	3
Paths	3

Size

Total Lines

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	6
CRAP Score	3

Importance

Changes

Metric	Value
dl	0
loc	8
ccs	6
cts	6
cp	1
c	0
b	0
f	0
rs	10
cc	3
nc	3
nop	1
crap	3

<?php

namespace DavidePastore\Ipinfo;

use DavidePastore\Ipinfo\Exception\InvalidTokenException;
use DavidePastore\Ipinfo\Exception\RateLimitExceedException;

/**
 * ipinfo.io service wrapper.
 *
 * @author davidepastore
 */
class Ipinfo
{
    /**
     * The base url of the ipinfo service.
     *
     * @var string
     */
    const BASE_URL = 'https://ipinfo.io/';

    /**
     * The ip string.
     *
     * @var string
     */
    const IP = 'ip';

    /**
     * The hostname string.
     *
     * @var string
     */
    const HOSTNAME = 'hostname';

    /**
     * The loc string.
     *
     * @var string
     */
    const LOC = 'loc';

    /**
     * The org string.
     *
     * @var string
     */
    const ORG = 'org';

    /**
     * The city string.
     *
     * @var string
     */
    const CITY = 'city';

    /**
     * The region string.
     *
     * @var string
     */
    const REGION = 'region';

    /**
     * The country string.
     *
     * @var string
     */
    const COUNTRY = 'country';

    /**
     * The phone string.
     *
     * @var string
     */
    const PHONE = 'phone';

    /**
     * The geo string.
     *
     * @var string
     */
    const GEO = 'geo';

    /**
     * The postal string.
     *
     * @var string
     */
    const POSTAL = 'postal';

    /**
     * All the settings.
     *
     * @var array
     */
    protected $settings;

    /**
     * Create an Ipinfo instance.
     *
     * @param array $settings An array with all the settings.
     *                        Supported keys are:
     *                        - token: string the developer token;
     *                        - debug: boolean active or not the debug.
     */
    public function __construct($settings = array())
    {
        //Merge user settings
        $this->settings = array_merge(array(
                'token' => '',
                'debug' => false,
        ), $settings);
    }

    /**
     * Get all the info about your own ip address.
     *
     * @return \DavidePastore\Ipinfo\Host The Host object with all the info.
     */
    public function getYourOwnIpDetails()
    {
        $response = $this->makeCurlRequest($this::BASE_URL.'json');
        $response = $this->jsonDecodeResponse($response);

        return new Host($response);
    }

    /**
     * Get all the info about an ip address.
     *
     * @param string $ipAddress The ip address.
     *
     * @return \DavidePastore\Ipinfo\Host The Host object with all the info.
     */
    public function getFullIpDetails($ipAddress)
    {
        $response = $this->makeCurlRequest($this::BASE_URL.$ipAddress);
        $response = $this->jsonDecodeResponse($response);

        return new Host($response);
    }

    /**
     * Get a specific field value.
     *
     * @param string $ipAddress The ip address.
     * @param string $field     The field.
     *
     * @return string|\DavidePastore\Ipinfo\Host The value of the given field for the given ip.
     *                                           This could returns an Host object if you call it with for the field
     *                                           \DavidePastore\Ipinfo\Ipinfo::GEO.
     */
    public function getSpecificField($ipAddress, $field)

    {
        $response = $this->makeCurlRequest($this::BASE_URL.$ipAddress.'/'.$field);
        $response = $this->checkGeo($field, $response);

        return $response;
    }

    /**
     * Get a specific field value of your own ip address.
     *
     * @param string $field The field.
     *
     * @return string|\DavidePastore\Ipinfo\Host The value of the given field for your own ip.
     *                                           This could returns an Host object if you call it with for the field
     *                                           \DavidePastore\Ipinfo\Ipinfo::GEO.
     */
    public function getYourOwnIpSpecificField($field)

    {
        $response = $this->makeCurlRequest($this::BASE_URL.$field);
        $response = $this->checkGeo($field, $response);

        return $response;
    }

    /**
     * Use the /geo call to get just the geolocation information, which will often be
     * faster than getting the full response.
     *
     * @param string $ipAddress The ip address.
     *
     * @return \DavidePastore\Ipinfo\Host
     */
    public function getIpGeoDetails($ipAddress)
    {
        return $this->getSpecificField($ipAddress, $this::GEO);

    }

    /**
     * Check if the response is GEO and set the parameters accordingly.
     *
     * @param string $field    The field value.
     * @param string $response The response from the server.
     *
     * @return Ambigous <\DavidePastore\Ipinfo\Host, string> Returns an Host object if the request is
     *                  of the GEO type, a string otherwise. If the field value is different from the GEO type, it will
     *                  delete the last character ('\n').
     */
    private function checkGeo($field, $response)
    {
        if ($field == $this::GEO) {
            $response = $this->jsonDecodeResponse($response);
            $response = new Host($response);
        } else {
            $this->checkErrors($response);
            $response = substr($response, 0, -1);
        }

        return $response;
    }

    /**
     * Make a curl request.
     *
     * @param string $address The address of the request.
     *
     * @return string Returns the response from the request.
     */
    private function makeCurlRequest($address)
    {
        $curl = curl_init();

        if (!empty($this->settings['token'])) {
            $address .= '?token='.$this->settings['token'];
        }

        if ($this->settings['debug']) {
            echo 'Request address: '.$address."\n";
        }

        curl_setopt_array($curl, array(
            CURLOPT_RETURNTRANSFER => 1,
            CURLOPT_URL => $address,
            CURLOPT_CAINFO => __DIR__ . "/cacert.pem"
        ));

        $response = curl_exec($curl);

        if ($response === false && $this->settings['debug']) {
            $error = curl_error($curl);
            echo "The error is".$error;
        }

        curl_close($curl);

        return $response;
    }

    /**
     * Returns the json decoded associative array.
     * @param  string $response Response from the http call.
     * @return array           Returns the associative array with the response.
     * @throws RateLimitExceedException    If you exceed the rate limit.
     * @throws InvalidTokenException If the used token is invalid.
     */
    private function jsonDecodeResponse($response)
    {
        if ($response) {
            // Check if the response contains an error message
            $this->checkErrors($response);
            $response = json_decode($response, true);
        } else {
            $response = array();
        }
        return $response;
    }

    /**
     * Check if the given response has some kind of errors.
     * @param string $response The response to check.
     * @throws RateLimitExceedException    If you exceed the rate limit.
     * @throws InvalidTokenException If the used token is invalid.
     */
    private function checkErrors($response)
    {
        if (strpos($response, 'Rate limit exceeded.') !== false) {
            throw new RateLimitExceedException("You exceed the rate limit.", $response);
        } elseif (strpos($response, 'Unknown token.') !== false) {
            throw new InvalidTokenException("The used token is invalid.", $response);
        }
    }
}


1			<?php
2
3			namespace DavidePastore\Ipinfo;
4
5			use DavidePastore\Ipinfo\Exception\InvalidTokenException;
6			use DavidePastore\Ipinfo\Exception\RateLimitExceedException;
7
8			/**
9			* ipinfo.io service wrapper.
10			*
11			* @author davidepastore
12			*/
13			class Ipinfo
14			{
15			/**
16			* The base url of the ipinfo service.
17			*
18			* @var string
19			*/
20			const BASE_URL = 'https://ipinfo.io/';
21
22			/**
23			* The ip string.
24			*
25			* @var string
26			*/
27			const IP = 'ip';
28
29			/**
30			* The hostname string.
31			*
32			* @var string
33			*/
34			const HOSTNAME = 'hostname';
35
36			/**
37			* The loc string.
38			*
39			* @var string
40			*/
41			const LOC = 'loc';
42
43			/**
44			* The org string.
45			*
46			* @var string
47			*/
48			const ORG = 'org';
49
50			/**
51			* The city string.
52			*
53			* @var string
54			*/
55			const CITY = 'city';
56
57			/**
58			* The region string.
59			*
60			* @var string
61			*/
62			const REGION = 'region';
63
64			/**
65			* The country string.
66			*
67			* @var string
68			*/
69			const COUNTRY = 'country';
70
71			/**
72			* The phone string.
73			*
74			* @var string
75			*/
76			const PHONE = 'phone';
77
78			/**
79			* The geo string.
80			*
81			* @var string
82			*/
83			const GEO = 'geo';
84
85			/**
86			* The postal string.
87			*
88			* @var string
89			*/
90			const POSTAL = 'postal';
91
92			/**
93			* All the settings.
94			*
95			* @var array
96			*/
97			protected $settings;
98
99			/**
100			* Create an Ipinfo instance.
101			*
102			* @param array $settings An array with all the settings.
103			* Supported keys are:
104			* - token: string the developer token;
105			* - debug: boolean active or not the debug.
106			*/
107	11		public function __construct($settings = array())
108			{
109			//Merge user settings
110	11		$this->settings = array_merge(array(
111	11		'token' => '',
112	11		'debug' => false,
113	11		), $settings);
114	11		}
115
116			/**
117			* Get all the info about your own ip address.
118			*
119			* @return \DavidePastore\Ipinfo\Host The Host object with all the info.
120			*/
121	2		public function getYourOwnIpDetails()
122			{
123	2		$response = $this->makeCurlRequest($this::BASE_URL.'json');
124	2		$response = $this->jsonDecodeResponse($response);
125
126	1		return new Host($response);
127			}
128
129			/**
130			* Get all the info about an ip address.
131			*
132			* @param string $ipAddress The ip address.
133			*
134			* @return \DavidePastore\Ipinfo\Host The Host object with all the info.
135			*/
136	2		public function getFullIpDetails($ipAddress)
137			{
138	2		$response = $this->makeCurlRequest($this::BASE_URL.$ipAddress);
139	2		$response = $this->jsonDecodeResponse($response);
140
141	2		return new Host($response);
142			}
143
144			/**
145			* Get a specific field value.
146			*
147			* @param string $ipAddress The ip address.
148			* @param string $field The field.
149			*
150			* @return string\|\DavidePastore\Ipinfo\Host The value of the given field for the given ip.
151			* This could returns an Host object if you call it with for the field
152			* \DavidePastore\Ipinfo\Ipinfo::GEO.
153			*/
154	6	View Code Duplication	public function getSpecificField($ipAddress, $field)
			0 ignored issues – show Duplication introduced 2018-08-12 17:57 UTC by Report Bug Copy Issue Report This method seems to be duplicated in your project. Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation. You can also find more detailed suggestions in the “Code” section of your repository. Loading history...
155			{
156	6		$response = $this->makeCurlRequest($this::BASE_URL.$ipAddress.'/'.$field);
157	6		$response = $this->checkGeo($field, $response);
158
159	5		return $response;
160			}
161
162			/**
163			* Get a specific field value of your own ip address.
164			*
165			* @param string $field The field.
166			*
167			* @return string\|\DavidePastore\Ipinfo\Host The value of the given field for your own ip.
168			* This could returns an Host object if you call it with for the field
169			* \DavidePastore\Ipinfo\Ipinfo::GEO.
170			*/
171	1	View Code Duplication	public function getYourOwnIpSpecificField($field)
			0 ignored issues – show Duplication introduced 2018-08-12 17:57 UTC by Report Bug Copy Issue Report This method seems to be duplicated in your project. Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation. You can also find more detailed suggestions in the “Code” section of your repository. Loading history...
172			{
173	1		$response = $this->makeCurlRequest($this::BASE_URL.$field);
174	1		$response = $this->checkGeo($field, $response);
175
176	1		return $response;
177			}
178
179			/**
180			* Use the /geo call to get just the geolocation information, which will often be
181			* faster than getting the full response.
182			*
183			* @param string $ipAddress The ip address.
184			*
185			* @return \DavidePastore\Ipinfo\Host
186			*/
187	2		public function getIpGeoDetails($ipAddress)
188			{
189	2		return $this->getSpecificField($ipAddress, $this::GEO);
			0 ignored issues – show Bug Compatibility introduced 2016-07-08 12:58 UTC by Report Bug Copy Issue Report The expression `$this->getSpecificField($ipAddress, $this::GEO);` of type `string\|DavidePastore\Ipinfo\Host` adds the type `string` to the return on line 189 which is incompatible with the return type documented by `DavidePastore\Ipinfo\Ipinfo::getIpGeoDetails` of type `DavidePastore\Ipinfo\Host`. Loading history...
190			}
191
192			/**
193			* Check if the response is GEO and set the parameters accordingly.
194			*
195			* @param string $field The field value.
196			* @param string $response The response from the server.
197			*
198			* @return Ambigous <\DavidePastore\Ipinfo\Host, string> Returns an Host object if the request is
199			* of the GEO type, a string otherwise. If the field value is different from the GEO type, it will
200			* delete the last character ('\n').
201			*/
202	7		private function checkGeo($field, $response)
203			{
204	7		if ($field == $this::GEO) {
205	2		$response = $this->jsonDecodeResponse($response);
206	2		$response = new Host($response);
207	2		} else {
208	5		$this->checkErrors($response);
209	4		$response = substr($response, 0, -1);
210			}
211
212	6		return $response;
213			}
214
215			/**
216			* Make a curl request.
217			*
218			* @param string $address The address of the request.
219			*
220			* @return string Returns the response from the request.
221			*/
222	11		private function makeCurlRequest($address)
223			{
224	11		$curl = curl_init();
225
226	11		if (!empty($this->settings['token'])) {
227	2		$address .= '?token='.$this->settings['token'];
228	2		}
229
230	11		if ($this->settings['debug']) {
231	1		echo 'Request address: '.$address."\n";
232	1		}
233
234	11		curl_setopt_array($curl, array(
235	11		CURLOPT_RETURNTRANSFER => 1,
236	11		CURLOPT_URL => $address,
237	11		CURLOPT_CAINFO => __DIR__ . "/cacert.pem"
238	11		));
239
240	11		$response = curl_exec($curl);
241
242	11		if ($response === false && $this->settings['debug']) {
243			$error = curl_error($curl);
244			echo "The error is".$error;
245			}
246
247	11		curl_close($curl);
248
249	11		return $response;
250			}
251
252			/**
253			* Returns the json decoded associative array.
254			* @param string $response Response from the http call.
255			* @return array Returns the associative array with the response.
256			* @throws RateLimitExceedException If you exceed the rate limit.
257			* @throws InvalidTokenException If the used token is invalid.
258			*/
259	6		private function jsonDecodeResponse($response)
260			{
261	6		if ($response) {
262			// Check if the response contains an error message
263	5		$this->checkErrors($response);
264	4		$response = json_decode($response, true);
265	4		} else {
266	1		$response = array();
267			}
268	5		return $response;
269			}
270
271			/**
272			* Check if the given response has some kind of errors.
273			* @param string $response The response to check.
274			* @throws RateLimitExceedException If you exceed the rate limit.
275			* @throws InvalidTokenException If the used token is invalid.
276			*/
277	10		private function checkErrors($response)
278			{
279	10		if (strpos($response, 'Rate limit exceeded.') !== false) {
280	1		throw new RateLimitExceedException("You exceed the rate limit.", $response);
281	9		} elseif (strpos($response, 'Unknown token.') !== false) {
282	1		throw new InvalidTokenException("The used token is invalid.", $response);
283			}
284	8		}
285			}
286

DavidePastore / ipinfo

Push — master ( 5779d7...0ea5da )

Ipinfo::checkErrors() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like