Initial commit

Author: Simon Yousoufov

.gitignore

@@ -0,0 +1,6 @@
+/vendor
+/components
+/tests/coverage
+composer.phar
+composer.lock
+.DS_Store

.travis.yml

@@ -0,0 +1,8 @@
+language: php
+php:
+  - '5.6'
+  - '7.0'
+  - nightly
+install:
+  - composer install
+

LICENSE.md

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015-2016 Fuzz Productions LLC <[email protected]>
+
+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,17 @@
+Fuzz HTTP Exception
+===================
+
+A library containing a set of RESTful HTTP exceptions that use a consistent interface, built upon the ideas set by [symfony/http-kernel](https://github.com/symfony/http-kernel)
+
+## Usage
+```php
+<?php
+
+use Fuzz\HttpException\AccessDeniedHttpException;
+
+throw new AccessDeniedHttpException('Access denied.');
+```
+
+## TODO
+1. Support all HTTP status codes
+1. Improve exception API

composer.json

@@ -0,0 +1,21 @@
+{
+	"name": "fuzz/http-exception",
+	"description": "A library containing a set of RESTful HTTP exceptions that use a consistent interface.",
+	"license": "MIT",
+	"authors": [
+		{
+			"name": "Fuzz Web",
+			"email": "[email protected]"
+		}
+	],
+	"require-dev": {
+		"phpunit/phpunit": "~5.0"
+	},
+	"autoload": {
+		"psr-4": {
+			"Fuzz\\HttpException\\": "src/",
+			"Fuzz\\HttpException\\Tests\\": "tests/"
+		}
+	},
+	"require": {}
+}

phpunit.xml

@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit backupGlobals="false"
+         backupStaticAttributes="false"
+         bootstrap="vendor/autoload.php"
+         colors="true"
+         convertErrorsToExceptions="true"
+         convertNoticesToExceptions="true"
+         convertWarningsToExceptions="true"
+         processIsolation="false"
+         stopOnFailure="false"
+         syntaxCheck="false"
+        >
+    <testsuites>
+        <testsuite name="Package Test Suite">
+            <directory suffix=".php">./tests/</directory>
+        </testsuite>
+    </testsuites>
+    <filter>
+        <whitelist>
+            <directory>src</directory>
+        </whitelist>
+    </filter>
+</phpunit>

src/AccessDeniedHttpException.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace Fuzz\HttpException;
+
+class AccessDeniedHttpException extends HttpException
+{
+	/**
+	 * HTTP status code
+	 *
+	 * @const int
+	 */
+	const HTTP_CODE = 403;
+
+	/**
+	 * Error code storage;
+	 *
+	 * @var string
+	 */
+	protected $error_name = 'access_denied';
+
+	/**
+	 * NotFoundHttpException constructor.
+	 *
+	 * @param string     $message
+	 * @param string     $error_formatted
+	 * @param array      $error_data
+	 * @param array      $headers
+	 * @param \Exception $previous
+	 */
+	public function __construct($message = null, $error_formatted = null, array $error_data = [], array $headers = [], \Exception $previous = null)
+	{
+		parent::__construct($message, $error_formatted, $error_data, $headers, self::HTTP_CODE, $previous);
+	}
+}

src/BadRequestHttpException.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace Fuzz\HttpException;
+
+class BadRequestHttpException extends HttpException
+{
+	/**
+	 * HTTP status code
+	 *
+	 * @const int
+	 */
+	const HTTP_CODE = 400;
+
+	/**
+	 * Error code storage;
+	 *
+	 * @var string
+	 */
+	protected $error_name = 'bad_request';
+
+	/**
+	 * NotFoundHttpException constructor.
+	 *
+	 * @param string     $message
+	 * @param string     $error_formatted
+	 * @param array      $error_data
+	 * @param array      $headers
+	 * @param \Exception $previous
+	 */
+	public function __construct($message = null, $error_formatted = null, array $error_data = [], array $headers = [], \Exception $previous = null)
+	{
+		parent::__construct($message, $error_formatted, $error_data, $headers, self::HTTP_CODE, $previous);
+	}
+}

src/ConflictHttpException.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace Fuzz\HttpException;
+
+class ConflictHttpException extends HttpException
+{
+	/**
+	 * HTTP status code
+	 *
+	 * @const int
+	 */
+	const HTTP_CODE = 409;
+
+	/**
+	 * Error code storage;
+	 *
+	 * @var string
+	 */
+	protected $error_name = 'conflict';
+
+	/**
+	 * NotFoundHttpException constructor.
+	 *
+	 * @param string     $message
+	 * @param string     $error_formatted
+	 * @param array      $error_data
+	 * @param array      $headers
+	 * @param \Exception $previous
+	 */
+	public function __construct($message = null, $error_formatted = null, array $error_data = [], array $headers = [], \Exception $previous = null)
+	{
+		parent::__construct($message, $error_formatted, $error_data, $headers, self::HTTP_CODE, $previous);
+	}
+}

src/Contracts/HttpExceptionInterface.php

@@ -0,0 +1,43 @@
+<?php
+
+namespace Fuzz\HttpException\Contracts;
+
+interface HttpExceptionInterface
+{
+	/**
+	 * The HTTP status code
+	 *
+	 * @return int
+	 */
+	public function getStatusCode();
+
+	/**
+	 * Return headers
+	 *
+	 * @return array
+	 */
+	public function getHeaders();
+
+	/**
+	 * Data corresponding to the error
+	 *
+	 * @return array
+	 */
+	public function getErrorData();
+
+	/**
+	 * String code of the error
+	 *
+	 * i.e. not_found or access_denied
+	 *
+	 * @return string
+	 */
+	public function getErrorName();
+
+	/**
+	 * A user-friendly error description
+	 *
+	 * @return string
+	 */
+	public function getErrorFormatted();
+}

src/GoneHttpException.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace Fuzz\HttpException;
+
+class GoneHttpException extends HttpException
+{
+	/**
+	 * HTTP status code
+	 *
+	 * @const int
+	 */
+	const HTTP_CODE = 410;
+
+	/**
+	 * Error code storage;
+	 *
+	 * @var string
+	 */
+	protected $error_name = 'gone';
+
+	/**
+	 * NotFoundHttpException constructor.
+	 *
+	 * @param string     $message
+	 * @param string     $error_formatted
+	 * @param array      $error_data
+	 * @param array      $headers
+	 * @param \Exception $previous
+	 */
+	public function __construct($message = null, $error_formatted = null, array $error_data = [], array $headers = [], \Exception $previous = null)
+	{
+		parent::__construct($message, $error_formatted, $error_data, $headers, self::HTTP_CODE, $previous);
+	}
+}