v0.2.2

This release sends all addresses to the proxycheck.io API using the HTTP POST method. Prior to this release only when checking multiple addresses (IPs or emails) would the POST method be utilised. Now with this version, the POST method is used all the time, even when checking a singular address.

This change improves the reliability of checking email addresses which contain special characters that may be interpreted as part of the URL structure or omitted entirely by the web server during URL interpretation.

This release contains no regressions and no change to your code is needed.

v0.2.1

This release corrects an exception which will occur if you're checking an IP address which doesn't have country information available.

v0.2.0

This release includes full support for the checking of email addresses in addition to the previous IP address checking capability.

Using the library you can check emails in the exact same way you previously checked IP addresses, merely by supplying the email instead of an IP when performing a check. You can even perform both IP and email checks in a single request using the multi-checking capability introduced in the previous version of this library.

When performing an email check you will still receive the block and block_reason results in the returned array unless you're performing a multi-check where these don't apply and will both contain na. Like the previous versions of the API you'll receive the full result from proxycheck.io as an array which you can then handle with your own software.

In addition to adding support for email checking there is a new option called MASK_ADDRESS and when set to 1 the library will automatically anonymise the local-part of the email address before sending it to proxycheck.io to be checked. This works when checking singular addresses and an array of addresses.

When performing an address mask the local-part of the email will be changed to anonymous. For example [email protected] would be altered to [email protected] before being sent to proxycheck.io for checking.

We do not expect any breakages when upgrading from previous versions of the API.

v0.1.9

This release enables an array of addresses to be checked in a single request to proxycheck.io allowing for you to perform a check on multiple addresses in the most efficient way possible. When passing multiple addresses within the $ip variable to be checked in this manner the limit is 10,000 addresses in a single request.

This change does not break prior implementations which means singular addresses can still be passed within the $ip variable as a string and they will be handled properly by the library as they always have been.

However when you provide an array with multiple addresses in the $ip variable the block and block_reason array values will contain na instead of their normal output. This is due to these values being global in scope to the whole request and thus not being applicable to an array of addresses which may have conflicting block types and block reasons.

v0.1.8

This release changes the parameter order for our makeRequest() function due to PHP8+ deprecating our previous arrangement. This should not break the library on previous versions of PHP while making the code compatible with future versions.

This change also stops a warning that will appear when using PHP 8.x with the library due to above noted deprecation.

v0.1.7

This release corrects a minor issue with the previous release that meant custom tags supplied with requests were not sent to proxycheck.io and thus wouldn't appear in your positive detection log on the website.

v0.1.6

This release reformats the library to meet PSR-12 specifications and corrects an issue where your API Key would not be utilised if you failed to supply the DAY_RESTRICTOR parameter within your options array when performing requests to the proxycheck API.

It also improves the cURL implementation by use of function scoping and support for HTTP method arguments.

This is a recommended upgrade due to the API Key issue it fixes. There are no expected compatibility issues or feature regressions compared to the previous v0.1.5 release.

v0.1.5

This release adds much better support for errors caused by missing parameters being supplied to all functions present in the proxycheck class.

This means from this release onward you shouldn't see any PHP errors related to missing option parameters due to us adding new features to our functions that you're not making use of.

v0.1.4

This release adds support for viewing risk scores and attack history through the addition of a new RISK_DATA parameter within the options you can pass to the check class.

View the main readme to see an example of how to use the risk score with your requests and also an example result.

v0.1.3

This release adds support for viewing the stats present within the customer dashboard on our website.
It also adds local country whitelisting support and improved country support in general by allowing you to specify countries by isocode in addition to the prior country name support.
It also improves error handling when some options were not supplied to the check function.