+<?php /*
+Name: Posterous API Library
+Description: Object-oriented PHP class for accessing the Posterous API
+Author: Calvin Freitas
+Version: 0.1.0
+Author URI: http://calvinf.com/
+License: MIT License (see LICENSE) http://creativecommons.org/licenses/MIT/
+Warranties: None
+Last Modified: December 07, 2009
+Requirements: PHP 5 or higher.
+*/
+
+/*
+Copyright (c) 2009 Calvin Freitas
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+*/
+
+/* Define Static Variables */
+define('POSTEROUS_API_LIBRARY_VERSION','1.0');
+define('POSTEROUS_API_LIBRARY_RELEASE_DATE','December 07, 2009');
+define('POSTEROUS_API_LIBRARY_URL','http://calvinf.com/projects/posterous-api-library-php/');
+define('POSTEROUS_API_LIBRARY_AUTHOR_NAME','Calvin Freitas');
+define('POSTEROUS_API_LIBRARY_AUTHOR_URL','http://calvinf.com/');
+define('POSTEROUS_API_LIBRARY_AUTHOR_EMAIL','cal@calvinfreitas.com');
+
+define('POSTEROUS_API_URL', 'http://posterous.com/api/');
+
+// ensure Curl extension installed
+if(!extension_loaded("curl")) {
+ throw(new Exception("The Curl extension for PHP is required for PosterousAPI to work."));
+}
+
+/* Useful to catch this exception separately from standard PHP Exceptions */
+class PosterousException extends Exception {}
+
+/* This class contains functions for calling the Posterous API */
+class PosterousAPI {
+ private $user;
+ private $pass;
+
+ function __construct($user = NULL, $pass = NULL) {
+ $this->user = $user;
+ $this->pass = $pass;
+ }
+
+ /* Reading Methods - http://posterous.com/api/reading */
+ function getsites() {
+ $api_method = 'getsites';
+ $xml = $this->_call( $api_method );
+ return $xml;
+ }
+
+ function readposts($args) {
+ $api_method = 'readposts';
+
+ $valid_args = array('hostname','site_id','num_posts','page','tag');
+ $method_args = $this->_validate($args, $valid_args);
+
+ $xml = $this->_call( $api_method, $method_args );
+ return $xml;
+ }
+
+ function gettags($args) {
+ $api_method = 'gettags';
+
+ $valid_args = array('hostname','site_id');
+ $method_args = $this->_validate($args, $valid_args);
+
+ $xml = $this->_call( $api_method, $method_args );
+ return $xml;
+ }
+
+ /* Posting Methods - http://posterous.com/api/posting */
+ function newpost($args) {
+ $api_method = 'newpost';
+
+ if (!$this->_auth()) {
+ throw new PosterousException('Posterous API call "' . $api_method . '" requires authentication.');
+ }
+
+ $valid_args = array('site_id','media','title','body','autopost','private','date','tags','source','sourceLink');
+ $method_args = $this->_validate($args, $valid_args);
+
+ $xml = $this->_call( $api_method, $method_args );
+ return $xml;
+ }
+
+ function updatepost($args) {
+ $api_method = 'updatepost';
+
+ if (!$this->_auth()) {
+ throw new PosterousException('Posterous API call "' . $api_method . '" requires authentication.');
+ }
+
+ $valid_args = array('post_id','media','title','body');
+ $method_args = $this->_validate($args, $valid_args);
+
+ $xml = $this->_call( $api_method, $method_args );
+ return $xml;
+ }
+
+ function newcomment($args) {
+ $api_method = 'newcomment';
+
+ $valid_args = array('post_id','comment','name','email','date');
+ $method_args = $this->_validate($args, $valid_args);
+
+ $xml = $this->_call( $api_method, $method_args );
+ return $xml;
+ }
+
+ /* Post.ly Methods - http://posterous.com/api/postly */
+
+ function getpost($args) {
+ $api_method = 'getpost';
+
+ $valid_args = array('id');
+ $method_args = $this->_validate($args, $valid_args);
+
+ $xml = $this->_call( $api_method, $method_args );
+ return $xml;
+ }
+
+ /* Twitter Methods - http://posterous.com/api/twitter */
+ function upload() {
+ $api_method = 'upload';
+
+ $valid_args = array('username','password','media','message','body','source','sourceLink');
+ $method_args = $this->_validate( $args, $method_args );
+
+ $xml = $this->_call( $api_method, $method_args );
+ return $xml;
+ }
+
+ function uploadAndPost() {
+ $api_method = 'uploadAndPost';
+
+ $valid_args = array('username','password','media','message','body','source','sourceLink');
+ $method_args = $this->_validate( $args, $method_args );
+
+ $xml = $this->_call( $api_method, $method_args );
+ return $xml;
+ }
+
+
+ /* Helper Functions */
+ private function _call($api_method, $method_args = NULL) {
+ $method_url = POSTEROUS_API_URL . $api_method;
+
+ $user = $this->user();
+ $pass = $this->pass();
+
+ $ch = curl_init();
+ curl_setopt($ch, CURLOPT_URL, $method_url);
+ curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
+ curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5);
+ curl_setopt($ch, CURLOPT_HEADER, false);
+ curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
+
+ if (isset($user) && isset($pass) && $user != '' && $pass != '') {
+ curl_setopt($ch, CURLOPT_USERPWD, $user . ':' . $pass);
+ }
+
+ curl_setopt($ch, CURLOPT_POST, 1);
+
+ if ( is_array($method_args) && !empty($method_args) ) {
+ curl_setopt($ch, CURLOPT_POSTFIELDS, $method_args);
+ }
+
+ $data = curl_exec($ch);
+ //$response_code = curl_getinfo($curl, CURLINFO_HTTP_CODE);
+ curl_close($ch);
+
+ $xml = '';
+ try {
+ $xml = new SimpleXMLElement($data);
+
+ $response_status = $xml['stat'];
+ if ($response_status == 'ok') {
+ return $xml;
+ }
+ elseif ($response_status == 'fail') {
+ throw new PosterousException('Error Code ' . $xml->err['code'] . ': ' . $xml->err['msg']);
+ }
+ else {
+ throw new PosterousException('Error: Invalid Posterous response status.');
+ }
+ }
+ catch (Exception $e) {
+ throw $e;
+ }
+ }
+
+ private function _validate($args, $valid_args) {
+ $method_args = array();
+ foreach($args as $key => $value) {
+ if( in_array($key, $valid_args) ) {
+ $method_args[$key] = $value;
+ }
+ }
+
+ return $method_args;
+ }
+
+ private function _auth() {
+ //checks if object has user & password, does not verify w/ Posterous
+ if (isset($this->user) && isset($this->pass) && $this->user != '' && $this->pass != '') {
+ return TRUE;
+ }
+ else {
+ return FALSE;
+ }
+ }
+
+ /* Getters & Setters */
+ function user($user = NULL) {
+ if ($user) {
+ $this->user = $user;
+ }
+ return $this->user;
+ }
+
+ function pass($pass = NULL) {
+ if ($pass) {
+ $this->pass = $pass;
+ }
+ return $this->pass;
+ }
+}
+
+?>