Fully support throwing exceptions when errors occur

Author: martijndeb

example/exception.php

@@ -0,0 +1,13 @@
+<?php
+// Query non existing post so you can see how errors are handled.
+declare(strict_types=1);
+
+namespace writeas;
+
+require_once( "../lib/writeas.php" );
+
+$context = new \writeas\Context();
+$post = new Post( $context );
+$post->get( "nonexisting" );
+
+?>

example/getPost.php

@@ -9,4 +9,4 @@
 $post = new Post( $context );
 $post->get( "0uw2v93hq709r" );
 
-?>
+?>

lib/Context.php

@@ -63,12 +63,24 @@ public function request( string $url, ?string $postdata = null, ?string $customR
 		}
 
 		$output = curl_exec( $this->ch );
+		$statusCode = curl_getinfo( $this->ch, CURLINFO_HTTP_CODE );
 
 		curl_close( $this->ch );
 
+		if ( (int) $statusCode >= 400 ) {
+			throw new WAException( null, $statusCode );
+
+			return null;
+		}
+
 		if ( $output !== false && !empty( $output ) ) {
 			$js = @json_decode( $output );
 			if ( !empty( $js ) ) {
+				if ( isset( $js->code ) && isset( $js->error_msg ) ) {
+					if ( (int) $js->code >= 400 ) {
+						throw new WAException( null, (int) $js->code );
+					}
+				}
 				return $js;
 			}
 

lib/WAException.php

@@ -0,0 +1,30 @@
+<?php
+declare(strict_types=1);
+
+namespace writeas;
+
+class WAException extends \Exception
+{
+	protected $exceptions = array(
+		400 => "Bad Request",		// The request didn't provide the correct parameters, or JSON / form data was improperly formatted.
+		401 => "Unauthorized",		// No valid user token was given.
+		403 => "Forbidden",			// You attempted an action that you're not allowed to perform.
+		404 => "Not Found",			// The requested resource doesn't exist.
+		405 => "Method Not Allowed",// The attempted method isn't supported.
+		410 => "Gone",				// The entity was unpublished, but may be back.
+		429 => "Too Many Requests", // You're making too many requests, especially to the same resource.
+		500 => "Server Error",
+		502 => "Server Error",
+		503 => "Server Error"
+	);
+
+	function __construct( $message = null, $code = 0, Exception $previous = null )
+	{
+		if ( isset( $this->exceptions[ $code ] ) ) {
+			$message = $this->exceptions[ $code ];
+		}
+
+		parent::__construct($message, $code, $previous);
+	}
+}
+?>

lib/writeas.php

@@ -4,6 +4,7 @@
 const DEFAULT_ENDPOINT = "https://write.as/api";
 const TOR_ENDPOINT = "http://writeas7pm7rcdqg.onion/api";
 
+require_once( "WAException.php" );
 require_once( "Context.php" );
 require_once( "Post.php" );
 require_once( "Collection.php" );