Initial push

Author: jimaek

.gitignore

@@ -0,0 +1,2 @@
+composer.phar
+vendor

LICENSE

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2013 MaxCDN, LLC.
+
+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.

README.md

@@ -0,0 +1,64 @@
+# MaxCDN REST API PHP Client
+
+## Requirements
+- PHP 5.3 or above
+- PHP Curl Extension
+
+## Installation with Composer
+Composer is the recommended way to utilize the MaxCDN RWS SDK PHP library.  For more information on how to use Composer, see http://www.getcomposer.org .  
+
+1. Add "MaxCDN/rws-sdk-php" as a dependency in your composer.json project file.
+
+```json
+{
+    "require": {
+        "MaxCDN/rws-sdk-php": "2.*"
+    }
+}
+```
+
+2. Download and install Composer (if not already installed).
+
+```bash
+curl -sS https://getcomposer.org/installer | php
+```
+
+3. Install your package dependencies.
+
+```bash
+php composer.phar install -o
+```
+
+This will download the MaxCDN library and configure composer to use it.  Composer will also build an autoloader for your use in the next step.
+
+4. Use Composer's autoloader.
+
+Composer prepares an autoload file which autoloads the RWS library for you on demand.  To use it, provide the following at the top of your PHP source files:
+
+```php
+require_once '/path/to/vendor/autoload.php';
+```
+
+It is advised that you understand how to optimze Composer's usage in Production environments.  For more information about Composer, visit http://getcomposer.org
+
+The libraries are located in the src/ directory.  The classes are organized in a PSR-0 hierarchy.  You can use any PSR-0 compliant autoloader for this library. Composer is the recommended method (see above).
+
+## Usage
+```php
+<?php
+
+$api = new MaxCDN("my_alias","consumer_key","consumer_secret");
+
+// get account information
+echo  $api->get('/account.json');
+
+// delete a file from the cache
+$params = array('file' => '/robots.txt');
+echo $api->delete('/zones/pull.json/6055/cache', $params);
+
+?>
+```
+
+## Methods
+
+It has support for `GET`, `POST`, `PUT` and `DELETE` OAuth signed requests.

composer.json

@@ -0,0 +1,22 @@
+{
+    "name": "maxcdn/php-maxcdn",
+    "description": "PHP Wrapper for MaxCDN Remote Web Services",
+    "type": "library",
+    "license": "MIT",
+    "homepage": "http://docs.maxcdn.com",
+    "support": {
+        "email": "support@maxcdn.com",
+        "source": "http://www.github.com/MaxCDN/php-maxcdn"
+    },
+    "require": { 
+        "php": ">=5.3.0",
+        "ext-curl": "*"
+    },
+    "autoload": {
+        "psr-0": {
+            "MaxCDN\\": "src/",
+            "": "src/"
+        }
+    }
+
+}

src/MaxCDN.php

@@ -0,0 +1,116 @@
+<?php
+/** 
+ * MaxCDN REST Client Library
+ * 
+ * @copyright 2012
+ * @author Karlo Espiritu
+ * @version 1.0 2012-09-21
+*/
+class MaxCDN {
+	
+	public $alias;
+
+	public $key;
+
+	public $secret;
+	
+	public $MaxCDNrws_url = 'https://rws.maxcdn.com';
+	
+    private $consumer;
+	
+	public function __construct($alias, $key, $secret, $options=null) {
+		$this->alias  = $alias;
+		$this->key    = $key;
+		$this->secret = $secret;
+		$this->consumer = new \MaxCDN\OAuth\OAuthConsumer($key, $secret, NULL);
+		
+	}
+
+	private function execute($selected_call, $method_type, $params) {
+		// the endpoint for your request
+		$endpoint = "$this->MaxCDNrws_url/$this->alias$selected_call"; 
+		
+		//parse endpoint before creating OAuth request
+		$parsed = parse_url($endpoint);
+		if (array_key_exists("parsed", $parsed))
+		{
+		    parse_str($parsed['query'], $params);
+		}
+
+		//generate a request from your consumer
+		$req_req = \MaxCDN\OAuth\OAuthRequest::from_consumer_and_token($this->consumer, NULL, $method_type, $endpoint, $params);
+
+		//sign your OAuth request using hmac_sha1
+		$sig_method = new \MaxCDN\OAuth\OAuthSignatureMethod_HMAC_SHA1();
+		$req_req->sign_request($sig_method, $this->consumer, NULL);
+
+		// create curl resource 
+		$ch = curl_init(); 
+		
+		// set url 
+		curl_setopt($ch, CURLOPT_URL, $req_req); 
+		
+		//return the transfer as a string
+		curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
+		curl_setopt($ch, CURLOPT_SSL_VERIFYPEER , FALSE);
+		
+		// set curl timeout
+		curl_setopt($ch, CURLOPT_TIMEOUT, 60); 
+
+		// set curl custom request type if not standard
+		if ($method_type != "GET" && $method_type != "POST") {
+		    curl_setopt($ch, CURLOPT_CUSTOMREQUEST, $method_type);
+		}
+
+
+		if ($method_type == "POST" || $method_type == "PUT" || $method_type == "DELETE") {
+		    $query_str = \MaxCDN\OAuth\OAuthUtil::build_http_query($params);
+		    curl_setopt($ch, CURLOPT_HTTPHEADER, array('Expect:', 'Content-Length: ' . strlen($query_str)));
+		    curl_setopt($ch, CURLOPT_POSTFIELDS,  $query_str);
+		}
+
+		// retrieve headers
+		curl_setopt($ch, CURLOPT_HEADER, 1);
+		curl_setopt($ch, CURLINFO_HEADER_OUT, 1);
+		
+		//set user agent
+		curl_setopt($ch, CURLOPT_USERAGENT, 'PHP MaxCDN API Client');
+
+		// make call
+		$result = curl_exec($ch);
+		$headers = curl_getinfo($ch);
+		$curl_error = curl_error($ch);
+
+		// close curl resource to free up system resources 
+		curl_close($ch);
+
+		// $json_output contains the output string 
+		$json_output = substr($result, $headers['header_size']);
+
+		// catch errors
+		if(!empty($curl_error) || empty($json_output)) { 
+			throw new \MaxCDN\RWSException("CURL ERROR: $curl_error, Output: $json_output", $headers['http_code'], null, $headers);
+		}
+
+		return $json_output;
+	}
+	
+	public function get($selected_call, $params = array()){
+		 
+		return $this->execute($selected_call, 'GET', $params);
+	}
+	
+	public function post($selected_call, $params = array()){
+		return $this->execute($selected_call, 'POST', $params);
+	}
+	
+	public function put($selected_call, $params = array()){
+		return $this->execute($selected_call, 'PUT', $params);
+	}
+	
+	public function delete($selected_call, $params = array()){
+		return $this->execute($selected_call, 'DELETE', $params);
+	}
+	
+	
+}

src/MaxCDN/OAuth/OAuthConsumer.php

@@ -0,0 +1,21 @@
+<?php
+/**
+ * OAuth Consumer representation.
+ */
+namespace MaxCDN\OAuth;
+
+class OAuthConsumer {
+    public $key;
+    public $secret;
+
+    function __construct($key, $secret, $callback_url=NULL) {
+        $this->key = $key;
+        $this->secret = $secret;
+        $this->callback_url = $callback_url;
+    }
+
+    function __toString() {
+        return "\\MaxCDN\\OAuth\\OAuthConsumer[key=$this->key,secret=$this->secret]";
+    }
+}
+

src/MaxCDN/OAuth/OAuthDataStore.php

@@ -0,0 +1,29 @@
+<?php
+namespace MaxCDN\OAuth;
+
+class OAuthDataStore {
+    function lookup_consumer($consumer_key) {
+        // implement me
+    }
+
+    function lookup_token($consumer, $token_type, $token) {
+        // implement me
+    }
+
+    function lookup_nonce($consumer, $token, $nonce, $timestamp) {
+        // implement me
+    }
+
+    function new_request_token($consumer, $callback = null) {
+        // return a new token attached to this consumer
+    }
+
+    function new_access_token($token, $consumer, $verifier = null) {
+        // return a new access token attached to this consumer
+        // for the user associated with this token if the request token
+        // is authorized
+        // should also invalidate the request token
+    }
+
+}
+

src/MaxCDN/OAuth/OAuthException.php

@@ -0,0 +1,10 @@
+<?php
+/**
+ * Exception class for OAuth failures.
+ */
+namespace MaxCDN\OAuth;
+
+class OAuthException extends Exception {
+    // pass
+}
+