Fixed typos, updated error handling, expanded README

Michael Christopher · Michael Christopher · commit 2ddc539020d7 · 2012-01-03T11:18:57.000-08:00
diff --git a/README.md b/README.md
@@ -10,6 +10,21 @@ Repository: <http://github.com/zencoder/zencoder-php/>
 For more details on the Zencoder API requirements visit  
 <http://app.zencoder.com/docs/api>
 
+To start working with the library, create a new instance of the Services_Zencoder class, passing
+your API Key as the 1st parameter.
+    $zencoder = new Services_Zencoder('93h630j1dsyshjef620qlkavnmzui3');
+
+Once you have created the object, you can use it to interact with the API. For full information,
+see the Documentation folder, but here is a quick overview of some of the functions that can be
+called:
+
+    $zencoder->accounts->create($array);
+    $zencoder->jobs->create($array);
+    $zencoder->jobs->progress($job_id);
+    $zencoder->inputs->details($input_id);
+    $zencoder->outputs->details($output_id);
+    $zencoder->notifications->parseIncoming();
+
 
 ENCODING JOB
 ------------
@@ -85,7 +100,6 @@ The previous JSON example would become:
       )
     ));
 
-
 NOTIFICATION HANDLING
 ----------------------
 The ZencoderOutputNotification class is used to capture and parse JSON data sent from
diff --git a/Services/Zencoder.php b/Services/Zencoder.php
@@ -57,6 +57,16 @@ public function __construct(
       $api_version = 'v2',
       $api_host = 'https://app.zencoder.com'
   ) {
+    // Check that library dependencies are met
+    if (strnatcmp(phpversion(),'5.2.0') < 0) {
+        throw new Services_Zencoder_Exception('PHP version 5.2 or higher is required.');
+    }
+    if (!function_exists('json_encode')) {
+        throw new Services_Zencoder_Exception('JSON support must be enabled.');
+    }
+    if (!function_exists('curl_init')) {
+        throw new Services_Zencoder_Exception('cURL extension must be enabled.');
+    }
     $this->version = $api_version;
     $this->http = new Services_Zencoder_Http(
         $api_host,
@@ -120,7 +130,7 @@ public function createData($path, $body = "", array $opts = array())
         ? $this->_processResponse($this->http->post($this->_getApiPath($opts) . $path, $headers))
         : $this->_processResponse(
             $this->http->post(
-                $path,
+                $this->_getApiPath($opts) . $path,
                 $headers,
                 $body
             )
@@ -143,7 +153,7 @@ public function updateData($path, $body = "", array $opts = array())
         ? $this->_processResponse($this->http->put($this->_getApiPath($opts) . $path, $headers))
         : $this->_processResponse(
             $this->http->put(
-                $path,
+                $this->_getApiPath($opts) . $path,
                 $headers,
                 $body
             )
@@ -187,10 +197,8 @@ private function _processJsonResponse($status, $headers, $body) {
         return $decoded;
     }
     throw new Services_Zencoder_Exception(
-        (int)$decoded->status,
-        $decoded->message,
-        isset($decoded->code) ? $decoded->code : null,
-        isset($decoded->more_info) ? $decoded->more_info : null
+        "Invalid HTTP status code: " . $status
+        . ", body: " . $body
     );
   }
 }
