Adding exceptions

src/Exceptions/MatrixException.php

@@ -0,0 +1,10 @@
+<?php
+
+namespace Aryess\PhpMatrixSdk\Exceptions;
+
+/**
+ * A generic Matrix error. Specific errors will subclass this.
+ *
+ * @package Aryess\PhpMatrixSdk\Exceptions
+ */
+abstract class MatrixException extends \Exception {}

src/Exceptions/MatrixHttpLibException.php

@@ -0,0 +1,17 @@
+<?php
+
+namespace Aryess\PhpMatrixSdk\Exceptions;
+
+/**
+ * The library used for http requests raised an exception.
+ *
+ * @package Aryess\PhpMatrixSdk\Exceptions
+ */
+class MatrixHttpLibException extends MatrixException {
+
+    public function __construct(\Exception $originalException, string $method, string $endpoint) {
+        $msg = "Something went wrong in %s requesting %s: %s";
+        $msg = sprintf($msg, $method, $endpoint, $originalException);
+        parent::__construct($msg);
+    }
+}

src/Exceptions/MatrixRequestException.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace Aryess\PhpMatrixSdk\Exceptions;
+
+/**
+ * The home server returned an error response.
+ *
+ * @package Aryess\PhpMatrixSdk\Exceptions
+ */
+class MatrixRequestException extends MatrixException {
+
+    protected $httpCode;
+    protected $content;
+
+    public function __construct(int $code = 0, string $content = "") {
+        parent::__construct("$code: $content");
+        $this->httpCode = $code;
+        $this->content = $content;
+    }
+
+    /**
+     * @return int
+     */
+    public function getHttpCode(): int {
+        return $this->httpCode;
+    }
+
+    /**
+     * @return string
+     */
+    public function getContent(): string {
+        return $this->content;
+    }
+}

src/Exceptions/MatrixUnexpectedResponse.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace Aryess\PhpMatrixSdk\Exceptions;
+
+/**
+ * The home server gave an unexpected response.
+ *
+ * @package Aryess\PhpMatrixSdk\Exceptions
+ */
+class MatrixUnexpectedResponse extends MatrixException {
+
+    protected $content;
+
+    function __construct(string $content = '') {
+        parent::__construct($content);
+        $this->content = $content;
+    }
+
+    /**
+     * @return string
+     */
+    public function getContent(): string {
+        return $this->content;
+    }
+}