started working on user session

Author: Ghitu

src/Exceptions/AccessDeniedException.php

@@ -0,0 +1,16 @@
+<?php
+
+namespace Updivision\Matrix\Exceptions;
+
+/**
+ * Access Denied
+ *
+ * Thrown when the Matrix API returns a 403 error code. This indicates that
+ * the agent whose credentials were used in making this request was not authorized to perform this API call.
+ *
+ * @package Exceptions
+ * @author Alin Ghitu <[email protected]>
+ */
+class AccessDeniedException extends ApiException
+{
+}

src/Exceptions/ApiException.php

@@ -0,0 +1,85 @@
+<?php
+
+namespace Updivision\Matrix\Exceptions;
+
+use Exception;
+use GuzzleHttp\Exception\RequestException;
+
+/**
+ * General Exception
+ *
+ * Thrown when the Matrix API returns an HTTP error code that isn't handled by other exceptions
+ *
+ * @package Exceptions
+ * @author Alin Ghitu <[email protected]>
+ */
+class ApiException extends Exception
+{
+
+    /**
+     * @internal
+     * @param RequestException $e
+     * @return AccessDeniedException|ApiException|AuthenticationException|ConflictingStateException|
+     * MethodNotAllowedException|NotFoundException|RateLimitExceededException|UnsupportedAcceptHeaderException|
+     * UnsupportedContentTypeException|ValidationException
+     */
+     public static function create(RequestException $e) {
+
+         if($response = $e->getResponse()) {
+             switch ($response->getStatusCode()) {
+                 case 400:
+                     return new ValidationException($e);
+                 case 401:
+                     return new AuthenticationException($e);
+                 case 403:
+                     return new AccessDeniedException($e);
+                 case 404:
+                     return new NotFoundException($e);
+                 case 405:
+                     return new MethodNotAllowedException($e);
+                 case 406:
+                     return new UnsupportedAcceptHeaderException($e);
+                 case 409:
+                     return new ConflictingStateException($e);
+                 case 415:
+                     return new UnsupportedContentTypeException($e);
+                 case 429:
+                     return new RateLimitExceededException($e);
+             }
+         }
+
+         return new ApiException($e);
+    }
+
+    /**
+     * @var RequestException
+     * @internal
+     */
+    private $exception;
+
+    /**
+     * Returns the Request Exception
+     *
+     * A Guzzle Request Exception is returned
+     *
+     * @return RequestException
+     */
+    public function getRequestException()
+    {
+        return $this->exception;
+    }
+
+    /**
+     * Exception constructor
+     *
+     * Constructs a new exception.
+     *
+     * @param RequestException $e
+     * @internal
+     */
+    public function __construct(RequestException $e)
+    {
+        $this->exception = $e;
+        parent::__construct();
+    }
+}

src/Exceptions/AuthenticationException.php

@@ -0,0 +1,16 @@
+<?php
+
+namespace Updivision\Matrix\Exceptions;
+
+/**
+ * Authentication Exception
+ *
+ * Thrown when the Matrix API returns a 401 error,
+ * which indicates that the Authorization header is either missing or incorrect
+ *
+ * @package Exceptions
+ * @author Alin Ghitu <[email protected]>
+ */
+class AuthenticationException extends ApiException
+{
+}

src/Exceptions/ConflictingStateException.php

@@ -0,0 +1,17 @@
+<?php
+
+namespace Updivision\Matrix\Exceptions;
+
+/**
+ * Conflicting State Exception
+ *
+ * Thrown when the Matrix API returns a 409 code. The resource that is being created/updated is in an inconsistent
+ * or conflicting state.
+ *
+ * @package Exceptions
+ * @author Alin Ghitu <[email protected]>
+ */
+class ConflictingStateException extends ApiException
+{
+
+}

src/Exceptions/InvalidConfigurationException.php

@@ -0,0 +1,16 @@
+<?php
+
+namespace Updivision\Matrix\Exceptions;
+
+/**
+ * Invalid Configuration Exception
+ *
+ * This indicates that the API was not initialized correctly
+ *
+ * @package Exceptions
+ * @author Alin Ghitu <[email protected]>
+ */
+class InvalidConfigurationException extends \Exception
+{
+
+}

src/Exceptions/MethodNotAllowedException.php

@@ -0,0 +1,16 @@
+<?php
+
+namespace Updivision\Matrix\Exceptions;
+
+/**
+ * Method Not Allowed Exception
+ *
+ * Thrown when the Matrix API returns a 405 code. This API request used the wrong HTTP verb/method.
+ *
+ * @package Exceptions
+ * @author Alin Ghitu <[email protected]>
+ */
+class MethodNotAllowedException extends ApiException
+{
+
+}

src/Exceptions/NotFoundException.php

@@ -0,0 +1,16 @@
+<?php
+
+namespace Updivision\Matrix\Exceptions;
+
+/**
+ * Not Found Exception
+ *
+ * Thrown when the Matrix API returns a 404 code. This is returned when the request contains an invalid URL.
+ *
+ * @package Exceptions
+ * @author Alin Ghitu <[email protected]>
+ */
+class NotFoundException extends ApiException
+{
+
+}

src/Exceptions/RateLimitExceededException.php

@@ -0,0 +1,17 @@
+<?php
+
+namespace Updivision\Matrix\Exceptions;
+
+/**
+ * Rate Limit Exceeded
+ *
+ * Thrown when a the Matrix API returns a 429 code. The API rate limit alloted for your Matrix domain has been
+ * exhausted
+ *
+ * @package Exceptions
+ * @author Alin Ghitu <[email protected]>
+ */
+class RateLimitExceededException extends ApiException
+{
+
+}

src/Exceptions/UnsupportedAcceptHeaderException.php

@@ -0,0 +1,17 @@
+<?php
+
+namespace Updivision\Matrix\Exceptions;
+
+/**
+ * Unsupported Accept Header Exception
+ *
+ * Thrown when the Matrix API returns a 406 code. Only application/json and '*\/*' are supported.
+ * When uploading files multipart/form-data is supported
+ *
+ * @package Exceptions
+ * @author Alin Ghitu <[email protected]>
+ */
+class UnsupportedAcceptHeaderException extends ApiException
+{
+
+}

src/Exceptions/UnsupportedContentTypeException.php

@@ -0,0 +1,17 @@
+<?php
+
+namespace Updivision\Matrix\Exceptions;
+
+/**
+ * Unsupported Content Type Exception
+ *
+ * Thrown when the Matrix API returns a 415 code. Content type application/xml is not supported.
+ * Only application/json is supported
+ *
+ * @package Exceptions
+ * @author Alin Ghitu <[email protected]>
+ */
+class UnsupportedContentTypeException extends ApiException
+{
+
+}