<?php
//
// PHP5 Flickr_API 
// Should be mostly API compatible with Cal Henderson's PEAR::Flickr_API
// but uses Curl and SimpleXML
//
// Rasmus Lerdorf, August 2005
// http://toys.lerdorf.com/archives/34-Flickr-API-Fun.html

// Slightly modified by Marty Spellerberg, May 2010
// http://www.martyspellerberg.com

class Flickr_API {
    private $_cfg = array('api_key'         => '',
                          'api_secret'      => '',
                          'endpoint'        => 'http://www.flickr.com/services/rest/',
                          'auth_endpoint'   => 'http://www.flickr.com/services/auth/?',
                          'upload_endpoint' => 'http://www.flickr.com/services/upload/',
                          'conn_timeout'    => 20,
                          'io_timeout'      => 60 );

    function __construct($params = array()) {
        if(isset($params['token'])) $this->token = $params['token'];
        foreach($params as $k => $v) {
            $this->_cfg[$k] = $v;
        }
        if(!$this->_cfg['api_key'] || !$this->_cfg['api_secret']) {
            throw new Exception("You must supply an api_key and an api_secret");
        }
    }

    function callMethod($method, $params = array()) {
        $this->_err_code = 0;
        $this->_err_msg = '';

        $req = curl_init();

        if($method=='upload') {
            $photo = $params['photo'];
            unset($params['photo']);
        } else {
            $params['method'] = $method;
        }
        $params['api_key'] = $this->_cfg['api_key'];
        $params['api_sig'] = $this->signArgs($params);

        if($method=='upload') {
            $params['photo'] = '@'.$photo;
            curl_setopt($req, CURLOPT_URL, $this->_cfg['upload_endpoint']);
            curl_setopt($req, CURLOPT_TIMEOUT, 0);
#            curl_setopt($req, CURLOPT_INFILESIZE, filesize($photo));
        } else {
            curl_setopt($req, CURLOPT_URL, $this->_cfg['endpoint']);
            curl_setopt($req, CURLOPT_TIMEOUT, $this->_cfg['io_timeout']);
            curl_setopt($req, CURLOPT_POST, 1);    
        }

        // Sign and build request parameters
        curl_setopt($req, CURLOPT_POSTFIELDS, $params);
        curl_setopt($req, CURLOPT_CONNECTTIMEOUT, $this->_cfg['conn_timeout']);
#        curl_setopt($req, CURLOPT_FOLLOWLOCATION, 1);
        curl_setopt($req, CURLOPT_HEADER, 0);
        curl_setopt($req, CURLOPT_RETURNTRANSFER, 1);
        $this->_http_body = curl_exec($req);

        if (curl_errno($req)) {
            throw new Exception(curl_error($req));
        }

        curl_close($req);
// Commented out, was giving error / Marty Jan 17 2010
//        file_put_contents('/tmp/curl.log',print_r($params,true)."\n".$this->_http_body."\n\n",FILE_APPEND);

        $xml = simplexml_load_string($this->_http_body);
        $this->xml = $xml;

        if((string)$xml['stat'] == 'fail') {
            $this->_err_code = (int)$xml->err['code'];
            $this->_err_msg  = (string)$xml->err['msg'];
            return 0;
        }

        if ((string)$xml['stat'] != 'ok') {
            $this->_err_code = 0;
            $this->_err_msg = "Unrecognised REST response status";
            return 0;
        }

        return $xml;
    }

    function getErrorCode() {
        return $this->_err_code;
    }

    function getErrorMessage() {
        return $this->_err_msg;
    }

    function showError() {
        echo "<br />ErrorCode: {$this->_err_code}<br />ErrorMessage: {$this->_err_msg}<br />\n";
    }

    function getAuthUrl($perms, $frob='') {
        $args = array('api_key'=>$this->_cfg['api_key'],'perms'=>$perms);

        if (strlen($frob)) { $args['frob'] = $frob; }

        $args['api_sig'] = $this->signArgs($args);

        $fields =  '';
        foreach($args as $k => $v) {
            if($fields) $fields.='&';
            $fields .= urlencode($k).'='.urlencode($v);
        }

        return $this->_cfg['auth_endpoint'].$fields;
    }


    function signArgs($args){
        ksort($args);
        $a = '';
        foreach($args as $k => $v) {
            $a .= $k . $v;
        }
        return md5($this->_cfg['api_secret'].$a);
    }
}

class Flickr extends Flickr_API {
    function __construct($params = array()) {
        parent::__construct($params);
    }

    function getFrobToken($frob) {
        $xml = $this->callMethod('flickr.auth.getToken',array('frob'=>$frob));
        if(!$xml) { $this->showError(); return FALSE; }

        $this->token = $ret['token'] = (string)$xml->auth->token;
        $this->perms = $ret['perms'] = (string)$xml->auth->perms;
        $uattr = $xml->auth->user->attributes();
        foreach($xml->auth->user->attributes() as $k=>$v) {
            // Sets token,perms,nsid,username and fullname
            $this->$k = $ret[$k] = (string)$v;
        }        
        return $ret;
    }

    function getPhotoURL($p, $size='', $ext='jpg') {
        return "http://static.flickr.com/{$p['server']}/{$p['id']}_{$p['secret']}{$size}.{$ext}";
    }

    function authCheckToken($token) {
        $params = array('auth_token'  => $this->token);

        $xml = $this->callMethod('flickr.auth.checkToken',$params);
        if(!$xml) { return FALSE; }
        
        foreach($xml->auth->children() as $k=>$v) {
            $ret[(string)$k] = (string)$v;
            foreach($v->attributes() as $kk=>$vv) {
                $ret[(string)$kk] = (string)$vv;
            }    
        }
        return $ret;
    }
// Contacts

    function contactsGetList($filter='') {
        $params = array('auth_token'=>$this->token);
        if($filter) $params['filter'] = $filter;    

        $xml = $this->callMethod('flickr.contacts.getList',$params);
        if(!$xml) { return FALSE; }

        $i = 0;
        foreach($xml->contacts->contact as $contact) {
            foreach($contact->attributes() as $k=>$v) {
                $ret[$i][$k] = (string)$v;
            }
            $i++;
        }
        return $ret;
    }

    function contactsGetPublicList($id) {
        $params = array('user_id'=>$id);
        $xml = $this->callMethod('flickr.contacts.getPublicList',$params);
        if(!$xml) { return FALSE; }

        $i=0;
        foreach($xml->contacts->contact as $contact) {
            foreach($contact->attributes() as $k=>$v) {
                $ret[$i][$k] = (string)$v;
            }
            $i++;
        }
        return $ret;
    }

// Blogs

    function blogsGetList() {
        $params = array('auth_token'=>$this->token);
        $xml = $this->callMethod('flickr.blogs.getList',$params);
        if(!$xml) { return FALSE; }

        $i = 0;
        foreach($xml->blogs->blog as $blog) {
            foreach($blogs->attributes() as $k=>$v) {
                $ret[(string)$blog['id']][$k] = (string)$v;
            }
            $i++;
        }
        return $ret;
    }

    function blogsPostPhoto($blog_id, $photo_id, $title, $description, $blog_password='') {
        $params = array('auth_token'  => $this->token,
                        'blog_id'     => $blog_id,
                        'photo_id'    => $photo_id,
                        'title'       => $title,
                        'description' => $description);
        if($blog_password) $params['blog_password'] = $blog_password;
        $ret = $this->callMethod('flickr.blogs.postPhoto',$params);
        return $ret;    
    }

// Favorites

    function favoritesAdd($photo_id) {
        $params = array('auth_token'  => $this->token,
                        'photo_id'    => $photo_id);
        $ret = $this->callMethod('flickr.favorites.add',$params);
        return $ret;
    }

    function favoritesRemove($photo_id) {
        $params = array('auth_token'  => $this->token,
                        'photo_id'    => $photo_id);
        $ret = $this->callMethod('flickr.favorites.remove',$params);
        return $ret;
    }

    function favoritesGetList($user_id='',$extras='',$per_page='',$page='') {
        $params = array('auth_token'  => $this->token);
        if($user_id)  $params['user_id']  = $user_id;
        if($extras)   $params['extras']   = $extras;
        if($per_page) $params['per_page'] = $per_page;
        if($page)     $params['page']     = $page;
        $xml = $this->callMethod('flickr.favorites.getList',$params);
        if(!$xml) { return FALSE; }

        $i = 0;
        foreach($xml->photos->photo as $photo) {
            foreach($photo->attributes() as $k=>$v) {
                $ret[(string)$photo['id']][$k] = (string)$v;
            }
            $i++;
        }
        return $ret;
    }

    function favoritesGetPublicList($user_id='',$extras='',$per_page='',$page='') {
        $params = array();
        if($user_id)  $params['user_id']  = $user_id;
        if($extras)   $params['extras']   = $extras;
        if($per_page) $params['per_page'] = $per_page;
        if($page)     $params['page']     = $page;
        $xml = $this->callMethod('flickr.favorites.getPublicList',$params);
        if(!$xml) { return FALSE; }

        $i = 0;
        foreach($xml->photos->photo as $photo) {
            foreach($photo->attributes() as $k=>$v) {
                $ret[(string)$photo['id']][$k] = (string)$v;
            }
            $i++;
        }
        return $ret;
    }

// People

    function peopleFindByUsername($username) {
        $params = array('username'=>$username);
        $xml = $this->callMethod('flickr.people.findByUsername',$params);
        if(!$xml) { return FALSE; }

        $attr = $xml->user->attributes();
        return (string)$attr['nsid'];
    }

    function peopleGetInfo($nsid) {
        $params = array('user_id'=>$nsid);
        $xml = $this->callMethod('flickr.people.getInfo',$params);
        if(!$xml) { return FALSE; }

        foreach($xml->person->attributes() as $k=>$v) {
            $ret[$k] = (string)$v;
        }
        foreach($xml->person->children() as $k=>$v) {
            if($k=='photos') {
                foreach($v as $kk=>$vv) {
                    $ret['photos'][$kk] = (string)$vv;
                }
            } else $ret[$k] = (string)$v;
        }
        return $ret;
    }

    function peopleGetPublicPhotos($nsid,$extras='',$per_page='',$page='') {
        $params = array('user_id'=>$nsid);
        if($extras)   $params['extras']   = $extras;
        if($per_page) $params['per_page'] = $per_page;
        if($page)     $params['page']     = $page;
        $xml = $this->callMethod('flickr.people.getPublicPhotos',$params);
        if(!$xml) { return FALSE; }

        foreach($xml->photos->attributes() as $k=>$v) {
            $ret[$k] = (string)$v;
        }
        $i=0;
        foreach($xml->photos->photo as $photo) {
            foreach($photo->attributes() as $k=>$v) {
                $ret['photos'][(string)$photo['id']][$k] = (string)$v;
            }
            $i++;
        }
        return $ret;
    }

    function peopleFindByEmail($email, &$username='') {
        $params = array('find_email'=>$email);
        $xml = $this->callMethod('flickr.people.findByEmail',$params);
        if(!$xml) { return FALSE; }
        $attr = $xml->user->attributes();
        if(func_num_args()>1) $username = (string)$xml->user->username;
        return (string)$attr['nsid'];
    }

    function urlsLookupUser($url, &$username='') {
        $params = array('url'=>$url);
        $xml = $this->callMethod('flickr.urls.lookupUser',$params);
        if(!$xml) { return FALSE; }
        $attr = $xml->user->attributes();
        if(func_num_args()>1) $username = (string)$xml->user->username;
        return (string)$attr['id'];
    }

// Sets

    // Indices of the photoset arrays are set to the individual photoset ids.
    function photosetsGetList($nsid='') {
        $params = array();
        if($this->token) $params['auth_token'] = $this->token;
        if($nsid) $params['user_id']=$nsid;
        $xml = $this->callMethod('flickr.photosets.getList',$params);
        if(!$xml) { return FALSE; }
        foreach($xml->photosets->attributes() as $k=>$v) $ret[$k] = (string)$v;
        $i=0;
        foreach($xml->photosets->photoset as $k=>$v) {
            foreach($v->attributes() as $kk=>$vv) $ret['photosets'][(string)$v['id']][$kk] = (string)$vv;
            foreach($v->children() as $kk=>$vv) $ret['photosets'][(string)$v['id']][$kk] = (string)$vv;
            $i++;
        }
        return $ret;
    }

    function photosetsGetInfo($photoset_id) {
        $params = array('photoset_id' => $photoset_id);
        $xml = $this->callMethod('flickr.photosets.getInfo',$params);
        if(!$xml) { return FALSE; }
        foreach($xml->photoset->attributes() as $k=>$v) $ret[$k] = (string)$v;
        foreach($xml->photoset as $key=>$val) {
            $ret[$key] = $val;
        }
        return $ret;
    }

    function photosetsCreate($title, $primary_photo_id, $description='') {
        $params = array('auth_token'  => $this->token);
        $params['title'] = $title;
        $params['primary_photo_id'] = $primary_photo_id;
        if($description) $params['description'] = $description;
    
        $xml = $this->callMethod('flickr.photosets.create',$params);
        if(!$xml) { return FALSE; }
    
        foreach($xml->photoset->attributes() as $k=>$v) {
            $ret[$k] = (string)$v;
        }
        return $ret;
    }

    function photosetsDelete($photoset_id) {
        $params = array('auth_token'  => $this->token);
        $params['photoset_id'] = $photoset_id;

        $xml = $this->callMethod('flickr.photosets.delete',$params);
        if(!$xml) { return FALSE; }
        return TRUE;
    }

    function photosetsGetPhotos($photoset_id) {
        $params = array('photoset_id' => $photoset_id);
        $xml = $this->callMethod('flickr.photosets.getPhotos',$params);
        if(!$xml) { return FALSE; }
        foreach($xml->photoset->attributes() as $k=>$v) {
            $ret[$k] = (string)$v;
        }
        $i=0;
        foreach($xml->photoset->photo as $photo) {
            foreach($photo->attributes() as $k=>$v) {
                $ret['photos'][(string)$photo['id']][$k] = (string)$v;
            }
            $i++;
        }
        return $ret;
    }

    function photosetsAddPhoto($photoset_id, $photo_id) {
        $params = array('auth_token'  => $this->token);
        $params['photoset_id'] = $photoset_id;
        $params['photo_id'] = $photo_id;

        $xml = $this->callMethod('flickr.photosets.addPhoto',$params);
        if(!$xml) { return FALSE; }
        return TRUE;
    }

    function photosetsRemovePhoto($photoset_id, $photo_id) {
        $params = array('auth_token'  => $this->token);
        $params['photoset_id'] = $photoset_id;
        $params['photo_id'] = $photo_id;

        $xml = $this->callMethod('flickr.photosets.removePhoto',$params);
        if(!$xml) { return FALSE; }
        return TRUE;
    }

    function photosGetNotInSet($extras='',$perpage='',$page='') {
        $params = array('auth_token'  => $this->token);
        if($extras)   $params['extras']   = $extras;
        if($per_page) $params['perpage']  = $per_page;
        if($page)     $params['page']     = $page;
        $xml = $this->callMethod('flickr.photos.getNotInSet',$params);
        if(!$xml) { return FALSE; }

        foreach($xml->photos->attributes() as $k=>$v) {
            $ret[$k] = (string)$v;
        }
        $i=0;
        foreach($xml->photos->photo as $photo) {
            foreach($photo->attributes() as $k=>$v) {
                $ret['photos'][(string)$photo['id']][$k] = (string)$v;
            }
            $i++;
        }
        return $ret;
    }

    function photosGetRecent($extras='',$per_page='',$page='') {
        $params = array();
        if($extras)   $params['extras']   = $extras;
        if($per_page) $params['per_page'] = $per_page;
        if($page)     $params['page']     = $page;
        $xml = $this->callMethod('flickr.photos.getRecent',$params);
        if(!$xml) { return FALSE; }

        foreach($xml->photos->attributes() as $k=>$v) {
            $ret[$k] = (string)$v;
        }
        $i=0;
        foreach($xml->photos->photo as $photo) {
            foreach($photo->attributes() as $k=>$v) {
                $ret['photos'][(string)$photo['id']][$k] = (string)$v;
            }
            $i++;
        }
        return $ret;
    }

    function photosGetInfo($photo_id, $secret='') {
        $params = array();
        if($this->token) $params['auth_token'] = $this->token;
        $params['photo_id'] = $photo_id;
        if($secret) $params['secret'] = $secret;
        
        $xml = $this->callMethod('flickr.photos.getInfo',$params);
        if(!$xml) { return FALSE; }

        foreach($xml->photo->attributes() as $k=>$v) {
            $ret[(string)$k] = (string)$v;
        }
        foreach($xml->photo->children() as $k=>$v) {
            foreach($v->attributes() as $kk=>$vv) $ret[(string)$k][(string)$kk] = (string)$vv;
            $id = -1;
            foreach($v->children() as $kk=>$vv) {
                $typed = false;
                if(isset($vv['id'])) $id = (string)$vv['id'];
                else if(isset($vv['type'])) { $id = (string)$vv['type']; $typed = true; }
                else $id++;
                foreach($vv->attributes() as $kkk=>$vvv) $ret[(string)$k][$id][(string)$kkk] = (string)$vvv;
                if($typed) $ret[(string)$k][$id] = (string)$vv;
                else $ret[(string)$k][$id]['text'] = (string)$vv;
            }
            if(!count($ret[(string)$k])) $ret[(string)$k] = (string)$v;
        }
        return $ret;
    }

    function upload($photo, $title='', $description='', $tags='', $perms='', $async=1, &$info=NULL) {
        $tmpf = false;
        $params = array('auth_token'  => $this->token);
        $url = parse_url($photo);
        if(isset($url['scheme'])) {
            $stream = fopen($photo,'r');
            $tmpf = tempnam('/var/tmp','G2F');
            file_put_contents($tmpf, $stream);
            fclose($stream);
            $params['photo'] = $tmpf;    
        } else $params['photo'] = $photo;
        $info = filesize($params['photo']);
        if($title)       $params['title']       = $title;
        if($description) $params['description'] = $description;
        if($tags)        $params['tags']        = $tags;  // Space-separated string
        if($perms) {
            if(isset($perms['is_public'])) $params['is_public'] = $perms['is_public'];
            if(isset($perms['is_friend'])) $params['is_friend'] = $perms['is_friend'];
            if(isset($perms['is_family'])) $params['is_family'] = $perms['is_family'];
        }
        if($async)       $params['async']       = $async;
        $xml = $this->callMethod('upload',$params);
        if($tmpf) unlink($tmpf);
        if(!$xml) { return FALSE; }

        if($async) return((string)$xml->ticketid);
        else return((string)$xml->photoid);
    }

    function photosUploadCheckTickets($tickets) {
        if(is_array($tickets)) {
            foreach($tickets as $k=>$v) {
                if($k) $params['tickets'] .= ' ';
                $params['tickets'] .= $v;
            }
        } else {
            $params['tickets'] = $tickets;
        }
        $xml = $this->callMethod('flickr.photos.upload.checkTickets',$params);
        if(!$xml) { return FALSE; }
    
        foreach($xml->uploader->ticket as $ticket) {
            foreach($ticket->attributes() as $k=>$v) {
                $ret[(string)$ticket['id']][$k] = (string)$v;
            }
        }
        return $ret;
    }

// Notes

    function photosNotesAdd($photo_id,$x,$y,$w,$h,$text) {
        $params = array('auth_token'  => $this->token);
        $params['photo_id'] = $photo_id;
        $params['note_x'] = $x;    
        $params['note_y'] = $y;    
        $params['note_w'] = $w;    
        $params['note_h'] = $h;    
        $params['note_text'] = $text;    

        $xml = $this->callMethod('flickr.photos.notes.add',$params);
        if(!$xml) { return FALSE; }

        return $xml->note['id'];
    }

    function photosNotesEdit($node_id,$x,$y,$w,$h,$text) {
        $params = array('auth_token'  => $this->token);
        $params['note_id'] = $note_id;
        $params['note_x'] = $x;    
        $params['note_y'] = $y;    
        $params['note_w'] = $w;    
        $params['note_h'] = $h;    
        $params['note_text'] = $text;    

        $xml = $this->callMethod('flickr.photos.notes.edit',$params);
        if(!$xml) { return FALSE; }

        return $xml->note['id'];
    }

    function photosNotesDelete($note_id) {
        $params = array('auth_token'  => $this->token);
        $params['note_id'] = $node_id;    

        $xml = $this->callMethod('flickr.photos.notes.delete',$params);
        if(!$xml) { return FALSE; }

        return TRUE;
    }

    function photosSearch($user_id='',$tags='',$tag_mode='',$text='',$min_upload_date='',
                          $max_upload_date='',$min_taken_date='',$max_taken_date='',
                          $license='',$extras='',$per_page='',$page='',$sort='') {
        if(is_array($user_id)) $params = $user_id;
        else { 
            $params = array();    
            if($user_id)  $params['user_id']  = $user_id;
            if($tags)     $params['tags']     = $tags;
            if($tag_mode) $params['tag_mode'] = $tag_mode;
            if($text)     $params['text']     = $text;
            if($min_upload_date) $params['min_upload_date'] = $min_upload_date;
            if($max_upload_date) $params['max_upload_date'] = $max_upload_date;
            if($min_taken_date)  $params['min_taken_date']  = $min_taken_date;
            if($max_taken_date)  $params['max_taken_date']  = $max_taken_date;
            if($license)  $params['license']  = $license;
            if($extras)   $params['extras']   = $extras;
            if($per_page) $params['per_page'] = $per_page;
            if($page)     $params['page']     = $page;
            if($sort)     $params['sort']     = $sort;
        }

        $xml = $this->callMethod('flickr.photos.search',$params);
        if(!$xml) { return FALSE; }

        foreach($xml->photos->attributes() as $k=>$v) {
            $ret[$k] = (string)$v;
        }
        $i=0;
        foreach($xml->photos->photo as $photo) {
            foreach($photo->attributes() as $k=>$v) {
                $ret['photos'][(string)$photo['id']][$k] = (string)$v;
            }
            $i++;
        }
        return $ret;
    }

// Reflection

    function reflectionGetMethods() {
        $params = array();
        $xml = $this->callMethod('flickr.reflection.getMethods',$params);
        if(!$xml) { return FALSE; }

        $ret = (array)$xml->methods->method;
        return $ret;
    }

}
/*
 * Local variables:
 * tab-width: 4
 * c-basic-offset: 4
 * End:
 * vim600: sw=4 ts=4 fdm=marker
 * vim<600: sw=4 ts=4
 */
?>