-<?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;
- }
-}
-
-?>