folded-php / exception

Various kind of exception to throw for your web app.

folded/exception

Various kind of exception to throw for your web app.

Summary

• About
• Features
• Requirements
• Installation
• Examples
• Version support

About

I created this library to share exception that I use on both of the packages that compose Folded.

These exceptions are common errors I use for my web apps, that you can also use to provide more sense to your errors instead of using the classic Exception.

Folded is a constellation of packages to help you setting up a web app easily, using ready to plug in packages.

• folded/action: A way to organize your controllers for your web app.
• folded/config: Configuration and environment utilities for your PHP web app.
• folded/crypt: Encrypt and decrypt strings for your web app.
• folded/exception: Various kind of exception to throw for your web app.
• folded/history: Manipulate the browser history for your web app.
• folded/http: HTTP utilities for your web app.
• folded/orm: An ORM for you web app.
• folded/request: Request utilities, including a request validator, for your PHP web app.
• folded/routing: Routing functions for your PHP web app.
• folded/session: Session functions for your web app.
• folded/view: View utilities for your PHP web app.

Features

• Contains some exception to throw
• The exceptions contains methods to set additional data (like the folder path for the FolderNotFoundException for example) and retrieve these data

Requirements

• PHP version >= 7.4.0
• Composer installed

Installation

In your root project folder, run this command to install the package:

composer require folded/exception

Examples

Most of the examples will add additional data by not directly throwing a new instance, but rather constructing an instance and using methods to add more context.

Keep in mind you are not forced to do it, and can just throw a message like you are used to with the classic Exception.

Using the methods you will discover below has the advantage to be able to give more context and facilitate the debugging when using an error management services such as Sentry, with its capability to store additional data.

• 1. FolderNotFoundException
• 2. MethodNotAllowedException
• 3. NotAFolderException
• 4. UrlNotFoundException
• 5. HistoryNotFoundException
• 6. RouteNotFoundException
• 7. SessionKeyNotFoundException

1. FolderNotFoundException

In this example, we will throw an exception when a folder path is not found.

use Folded\Exceptions\FolderNotFoundException;

try {
  $exception = new FolderNotFoundException("folder foo not found");

  $exception->setFolder("foo");

  throw $exception;
} catch (FolderNotFoundException $exception) {
  echo "folder not found is {$exception->getFolder()}";
}

2. MethodNotAllowedException

In this example, we will throw an exception when an HTTP method is not allowed (HTTP status code 405).

use Folded\Exceptions\MethodNotAllowedException;

try {
  $exception = new MethodNotAllowedException("method GET not allowed");

  $exception->setMethodNotAllowed("GET");
  $exception->setAllowedMethods(["POST", "DELETE"]);
  $exception->setUrl("/post/store");

  throw $exception;
} catch (MethodNotAllowedException $exception) {
  $url = $exception->getUrl();
  $allowedMethods = $exception->getAllowedMethods();

  echo "method not allowed on URL $url: {$exception->getMethodNotAllowed()}";

  foreach ($allowedMethods as $allowedMethod) {
    echo "allowed method: $allowedMethod";
  }
}

3. NotAFolderException

In this example, we will throw an exception when a path is not a folder.

use Folded\Exceptions\NotAFolderException;

try {
  $exception = new NotAFolderException("foo is not a folder");

  $exception->setFolder("foo");
} catch (NotAFolderException $exception) {
  echo "folder {$exception->getFolder()} is not a folder";
}

4. UrlNotFoundException

In this example, we will throw an exception when an URL is not found (HTTP status code 404).

use Folded\Exceptions\UrlNotFoundException;

try {
  $exception = new UrlNotFoundException("url /about-us not found");

  $exception->setUrl("/about-us");

  throw $exception;
} catch (UrlNotFoundException $exception) {
  echo "url {$exception->getUrl()} not found";
}

5. HistoryNotFoundException

In this example, we will throw an exception when an history is not found on a browser history manager.

Check folded/history for an example of package that deals with the browser history on back-end.

use Folded\Exceptions\HistoryNotFoundException;

try {
  $exception = new HistoryNotFoundException("history 1 not found");
  $exception->setIndex(1);

  throw $exception;
} catch (HistoryNotFoundException $exception) {
  echo "index {$exception->getIndex()} not found in the history";
}

6. RouteNotFoundException

In this example, we will throw an exception if a route name is not found (when using a router for example).

use Folded\Exceptions\RouteNotFoundException;

try {
  $exception = new RouteNotFoundException("route /about-us not found");
  $exception->setRoute("/about-us");

  throw $exception;
} catch (RouteNotFoundException $exception) {
  echo "route {$exception->getRoute()} not found";
}

7. SessionKeyNotFoundException

In this example, we will throw an exception if a key is not found in a session array.

use Folded\Exceptions\SessionKeyNotFoundException;

try {
  $exception = new SessionKeyNotFoundException("key foo not found");
  $exception->setKey("foo");

  throw $exception;
} catch (SessionKeyNotFoundException $exception) {
  echo "key {$exception->getKey()} not found";
}

Version support

	7.3	7.4	8.0
v0.1.0	❌	✔️	❓
v0.1.1	❌	✔️	❓
v0.2.0	❌	✔️	❓
v0.3.0	❌	✔️	❓
v0.4.0	❌	✔️	❓