Download the PHP package middlewares/request-handler without Composer

On this page you can find all versions of the php package middlewares/request-handler. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package request-handler

middlewares/request-handler

Latest Version on Packagist Testing Total Downloads

Middleware to execute request handlers discovered by a router.

Requirements

Installation

This package is installable and autoloadable via Composer as middlewares/request-handler.

You may also want to install any route middleware like middlewares/fast-route or middlewares/aura-router for routing.

Purpose

There are two completely separate steps when it comes to route handling:

  1. Determining if the request is valid and can be resolved by the application.
  2. Handling the request inside the application.

The first step usually resolves into a route callback, while the product of the second one is usually the result of executing that callback.

Multiple things that can happen between the first and second steps: input validation, authentication, authorization, etc. and in some scenarios we may not want to continue processing the request (e.g. auth, accessing DB resources, etc.) if that would ultimately fail to resolve e.g. procuding an HTTP 400 error.

Splitting routing from request handling allows us to use any middleware between these two steps. It also makes the request-handler middleware able to be used with any routing component.

Example

A routing middleware needs to be called before the request can be handled. In this example, we will use fast-route middleware.

When the request handler is invoked, it expects a request attribute to be defined that contains a reference to the handler. The handler must be a string, a callable or an object implementing MiddlewareInterface or RequestHandlerInterface. If it's a string, a ContainerInterface will be used to resolve it and get the MiddlewareInterface or RequestHandlerInterface to use. If it's a callable, it will be converted automatically to MiddlewareInterface using the Middlewares\Utils\CallableHandler

Usage

Define the container used to resolve the handlers if they are provided as string (or an array with 2 strings). By default will use Middlewares\Utils\RequestHandlerContainer.

handlerAttribute

Configures the attribute name used to get the handler reference in the server request. The default is request-handler.

continueOnEmpty

If the server request attribute is empty or does not exists, an exception is throwed. This function changes this behavior to continue with the next middleware.


Please see CONTRIBUTING for contributing details.

The MIT License (MIT). Please see LICENSE for more information.


All versions of request-handler with dependencies

PHP Build Version
Package Version
Requires php Version ^7.2 || ^8.0
middlewares/utils Version ^3.0
psr/http-server-middleware Version ^1.0
psr/container Version ^1.0||^2.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package middlewares/request-handler contains the following files

Loading the files please wait ....