HttpRuntimeErrorException
Since v2.0.0
Description
HttpRuntimeErrorException
is an interface. It is implemented by any exception that maps onto any of the HTTP 5xx status values.
Public Interface
HttpRuntimeErrorException
has the following public interface:
// HttpRuntimeErrorException lives in this namespace
namespace GanbaroDigital\HttpStatus\Interfaces;
// our base interfaces
use GanbaroDigital\HttpStatus\Interfaces\HttpException;
// our return types
use GanbaroDigital\HttpStatus\Interfaces\HttpStatus;
interface HttpRuntimeErrorException extends HttpException
{
/**
* returns the HTTP status code that best represents this object
*
* @return HttpStatus
* @inheritedFrom HttpStatusProvider
*/
public function getHttpStatus();
}
How To Use
In Your Own Exceptions
Implement HttpRuntimeErrorException
in any exceptions that map onto a HTTP 5xx status value. Combine it with one of the status provider traits to quickly and easily add the getHttpStatus()
method that HttpRuntimeErrorException
requires:
use GanbaroDigital\HttpStatus\Interfaces\HttpRuntimeErrorException;
use GanbaroDigital\HttpStatus\StatusProviders\RuntimeError\InsufficientStorageStatusProvider;
use RuntimeException;
class MyException extends HttpRuntimeErrorException
{
// adds getHttpStatus()
// returns a HttpStatus value object of 507 Insufficient Storage
use InsufficientStorageStatusProvider;
}
try {
// ...
}
catch (HttpRuntimeErrorException $e) {
$httpStatus = $e->getHttpStatus();
// ...
}
Notes
None at this time.
See Also
- Status provider traits - helpers to provide the
getHttpStatus()
method HttpException
- base interface