Update 6-30-2010:

I recently updated the class to enable caching the xml response from the Petfinder server. This should provide a nice little speed boost even though it was already pretty fast . Caching is enabled by default, and caches expires in 3 minutes. The folder “cache_files” in zip folder must have write permissions. As shown in the instructions, you can change the paths of cache files.

This class will parse the returned xml as a data array. This libary requires just 4 easy steps to get data:

1. Add api-password to class
2. Add api-key to class
3. Pass configuration values as an array
4. Call the method in the class

Here is an example of how to use the php class

include_once('class.petfinder.php'); //include class
$pet = new Petfinder(); //create Petfinder object
$pet->setKey('12345'); //your api-key
$pet->setPass('abcdef'); //your api-secret
$pet->set(array('cache_expire' => 360)); //(optional) Time in secs to expire  default shown
$pet->set(array('cache_path' => 'full_path_to_cache_folder')) //(optional) Set cache path 
$pet->set(array('cache_enable' => FALSE)); //(optional) Disable cache feature 
 
$config = array('location '=> '44805', 'animal' => 'dog'); //associative array of values to pass to class. array keys must match arguments from API
$pet->initialize($config) //pass values to the class
$data = $pet->petFind(); //call API method which are accessed by camel casing them (pet.find=petFind)

The xml data is returned as an associative array. The array has been mapped to the xml layout returned by PetFinder. Echo out the variable and you will see the returned status code, the array of returned values, and the xml response data from PetFinder.

Download

If you would like to donate, you may do so by using Paypal.

Here’s how you will use this library in Codeigniter. First, extract the zip file and place the contents into your /application/libraries folder within your codeigniter folder structure.

Example code:

$this->load->library('geshi'); //load geshi class
 
$config['set_language'] = 'php'; //REQUIRED set language to parse
$config['set_source'] = 'foreach($test as $item){ echo "hello";}'; //REQUIRED set source code to parse
$this->geshi->initialize($config);
 
echo $this->geshi->output(); //output from geshi alias of parse_code

You can pass any geshi method or variable in the config array. Just name the key the same as the method or variable you are setting, and the value to what you would like to pass.