PHPackages                             alexpts/php-simple-middlewares - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [HTTP & Networking](/categories/http)
4. /
5. alexpts/php-simple-middlewares

ActiveLibrary[HTTP & Networking](/categories/http)

alexpts/php-simple-middlewares
==============================

Simple middlewares manager compatible with the PSR-7

1.1.0(8y ago)1486[1 issues](https://github.com/alexpts/php-simple-middlewares/issues)MITPHPPHP >7.1

Since Jan 4Pushed 7y ago1 watchersCompare

[ Source](https://github.com/alexpts/php-simple-middlewares)[ Packagist](https://packagist.org/packages/alexpts/php-simple-middlewares)[ Docs](https://github.com/alexpts/php-simple-middlewares)[ RSS](/packages/alexpts-php-simple-middlewares/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (2)Dependencies (3)Versions (3)Used By (0)

php-simple-middlewares
======================

[](#php-simple-middlewares)

[![SensioLabsInsight](https://camo.githubusercontent.com/0f54c09aa6a53b1373159c91f717deeeb157ad62331155ffc98bfa0ebae65034/68747470733a2f2f696e73696768742e73656e73696f6c6162732e636f6d2f70726f6a656374732f32616538383962312d313864662d343365662d393732342d6463653139633338386534362f6269672e706e67)](https://insight.sensiolabs.com/projects/2ae889b1-18df-43ef-9724-dce19c388e46)

[![Build Status](https://camo.githubusercontent.com/d9d6a957d01ba964e4d99deaa4262d0745b9ed73fa58277759e21b8787bf8efc/68747470733a2f2f7472617669732d63692e6f72672f616c65787074732f7068702d73696d706c652d6d6964646c6577617265732e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/alexpts/php-simple-middlewares)[![Test Coverage](https://camo.githubusercontent.com/9b09fd4da19015bd934c6ed042f830d1b2d814bf2f55280138ec506f60a1262f/68747470733a2f2f636f6465636c696d6174652e636f6d2f6769746875622f616c65787074732f7068702d73696d706c652d6d6964646c6577617265732f6261646765732f636f7665726167652e737667)](https://codeclimate.com/github/alexpts/php-simple-middlewares/coverage)[![Code Climate](https://camo.githubusercontent.com/7e4170f6729fc208e588700ac8388c1d83645aff6b4cf9359163a4dfc10d9043/68747470733a2f2f636f6465636c696d6174652e636f6d2f6769746875622f616c65787074732f7068702d73696d706c652d6d6964646c6577617265732f6261646765732f6770612e737667)](https://codeclimate.com/github/alexpts/php-simple-middlewares)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/0d313c4e7b1d6e272a896897f3cc404bf3db051b7b67c27952834d0295e2f9e1/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f616c65787074732f7068702d73696d706c652d6d6964646c6577617265732f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/alexpts/php-simple-middlewares/?branch=master)

[New PSR-15 compatible middleware manager](https://github.com/alexpts/psr15-middleware-manager)

(deprecated) Simple middlewares compatible with the PSR-7

MiddlewaresManager позволяет настраивать очередь выполнения программного обеспечения промежуточного уровня. Каждый middleware принимает на вход объект запроса `$request`, при желании может что-то сделать с ним или создать новый объект `$request` и передать его в следующий middleware, ожидая от него объект response. Затем он может что-то сделать с объектом response или просто передать его пердыдущему middleware.

Milddleware, может не вызывать следующий middleware, а вернуть результат в ранее вызванный middleware. Т.е. каждый middleware получает управление 2 раза. В момент прохода объекта `$request` и в момент возврата `$response` обратно

Для обеспечения гибкости и встраивомости компонента, middleware обработчкичи не ограничены никаким интерфейсом. Обработчиком может быть любой callable тип, которому будет передано 2 параметра `ServerRequestInterface $request`, `callable $next`. Для более формальной разработки каждый обработчик может поддерживать формальный интерфейс `MiddlewareInterface`.

Возвращаемый тип объекта `$response` также никак не ограничен. Вы можете вернуть из обработчика любой тип, например массив или объект типа ResponseInterface (psr-7). Формально ограничить на свой выбор вы можете указав тип возвращаемого значения в php 7.

Installation
------------

[](#installation)

`$ composer require alexpts/php-simple-middlewares`

Примеры
-------

[](#примеры)

Произвольный обработчик

```
use Psr\Http\Message\ServerRequestInterface;
use PTS\Middleware\MiddlewareManager;

$middlewareManager = new MiddlewareManager();
$middlewareManager->push(function($request, $next){
    /* optionally modify the request */
    $request = $request->...;

    /* optionally skip the $next middleware and return early */
    if (...) {
        return $response;
    }

    /* optionally invoke the $next middleware and get back a new response */
    $response = $next($request);

    /* optionally modify the Response if desired */
    $response = $response->...;

    return $response;
});
```

Несолько `MiddlewareInterface` обработчиков

```
use Psr\Http\Message\ServerRequestInterface;
use PTS\Middleware\MiddlewareManager;
use PTS\Middleware\MiddlewareInterface;

class MiddlewareA implements MiddlewareInterface
{
    public function __invoke(ServerRequestInterface $request, callable $next)
    {
        $method = $request->getMethod();
        if (method !== 'GET') {
            return new JsonResponse(['status' => 405], 405);
        }

        $response = $next($request);
        /* optionally modify the Response if desired */
        $response = $response->...;

        return $response;
    }
}

class FrontController implements MiddlewareInterface
{
    public function __invoke(ServerRequestInterface $request, callable $next)
    {
        /* ... some work and create response */
        return $response;
    }
}

$middlewareManager = new MiddlewareManager();
$middlewareManager->push(new MiddlewareA);
$middlewareManager->push(new FrontController);

/* ... PSR-7 $request */
$response = $middlewareManager($request);
```

#### Обработчики ошибок/исключений

[](#обработчики-ошибокисключений)

Если рассматривать middleware как независимые приложения, то каждый обработчик должен вернуть PSR-7 ответ в случае ошибки/исключения. Такой ответ должен пройти всю цепочку middleware в обратном порядке.

```
$middlewareManager = new MiddlewareManager();
$middlewareManager->push(new MiddlewareA);
$middlewareManager->push(new FrontController, function (\Throwable $ex) {
    return new JsonResponse(['error' => $ex->getMessage()], 500);
});

$response = $middlewareManager($request);
```

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance0

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~525 days

Total

2

Last Release

3253d ago

PHP version history (2 changes)1.0.0PHP >5.5

1.1.0PHP >7.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/31106536118e11bf9d0c9d7f467db5b534efa9c46ee76680b308f0c39d9a798c?d=identicon)[alexpts](/maintainers/alexpts)

---

Top Contributors

[![alexpts](https://avatars.githubusercontent.com/u/1306916?v=4)](https://github.com/alexpts "alexpts (18 commits)")

---

Tags

psr-7middleware

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/alexpts-php-simple-middlewares/health.svg)

```
[![Health](https://phpackages.com/badges/alexpts-php-simple-middlewares/health.svg)](https://phpackages.com/packages/alexpts-php-simple-middlewares)
```

###  Alternatives

[psr/http-server-middleware

Common interface for HTTP server-side middleware

18091.2M1.5k](/packages/psr-http-server-middleware)[mezzio/mezzio

PSR-15 Middleware Microframework

3883.6M97](/packages/mezzio-mezzio)[tuupola/slim-basic-auth

PSR-7 and PSR-15 HTTP Basic Authentication Middleware

4442.0M25](/packages/tuupola-slim-basic-auth)[relay/relay

A PSR-15 server request handler.

3302.1M85](/packages/relay-relay)[tuupola/cors-middleware

PSR-7 and PSR-15 CORS middleware

1331.8M24](/packages/tuupola-cors-middleware)[laminas/laminas-stratigility

PSR-7 middleware foundation for building and dispatching middleware pipelines

586.6M81](/packages/laminas-laminas-stratigility)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)