grmule/php-ziptastic

A simple class for accessing the Ziptastic API (https://www.getziptastic.com/)

PHP-Ziptastic

A simple PHP class used to access the Ziptastic API., _(*1)

Sample usage:, _(*2)

$zt = new PHPZiptastic\Ziptastic(49504);

print $zt->city; // Grand Rapids

print $zt->lookup(34231)->city; // Sarasota

print $zt->lookup(44870); // Bloomingville, OH

print json_encode($zt); // {"city":"Bloomingville","state":"OH","zip":"44870"}

Errors and Exceptions

By default, errors (zip not found, malformed zip passed) will place a message in the $error property, and return a self-reference. This looks like:, _(*3)

print $zt->lookup(12344)->city; // null
print $zt->error; // Invalid zip code

If you would like to catch an exception instead, pass TRUE as a second constructor parameter:, _(*4)

$zt = new Ziptastic(null, true);
$zt->lookup(12344); // exception thrown here

OR, _(*5)

$zt = new Ziptastic(12344, true); // exception thrown here

For all errors, the exception throw is the base PHP Exception class., _(*6)

Installation

Include Ziptastic.php or install the composer package., _(*7)

Ziptastic

Ziptastic is a simple API that allows people to ask which Country,State and City are associated with a Zip Code., _(*8)

More info at http://daspecster.github.com/ziptastic/, _(*9)

Many thanks to ElevenBaseTwo (http://blog.elevenbasetwo.com/) for shortening our forms!, _(*10)