PHPackages                             legionth/http-rest - 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. legionth/http-rest

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

legionth/http-rest
==================

REST HTTP-Server on top of ReactPHP

v0.3.0(7y ago)031[1 PRs](https://github.com/legionth/reactphp-http-rest/pulls)MITPHP

Since Nov 24Pushed 2y ago1 watchersCompare

[ Source](https://github.com/legionth/reactphp-http-rest)[ Packagist](https://packagist.org/packages/legionth/http-rest)[ RSS](/packages/legionth-http-rest/feed)WikiDiscussions master Synced 3d ago

READMEChangelog (4)Dependencies (2)Versions (8)Used By (0)

REST HTTP Server
================

[](#rest-http-server)

Creating [ReactPHP HTTP Server](https://github.com/reactphp/http) but with REST

**Table of Contents**

- [Example](#example)
- [Usage](#usage)
    - [Server](#server)
    - [Dynamic Values](#dynamic-values)
    - [Default Callback](#default-callback)
    - [Parameter Placeholder](#parameter-placholder)
- [Install](#install)
- [License](#license)

Example
-------

[](#example)

This is an HTTP server which responds with an `hello`in every request on `/say/hello`.

Every other call will result in an 404 response.

```
$loop = \React\EventLoop\Factory::create();

$server = new \Legionth\React\Http\Rest\Server();

$server->get('/say/hello', function (\Psr\Http\Message\ServerRequestInterface $request, callable $next) {
    return new \React\Http\Response(200, array(), 'hello');
});

$socket = new \React\Socket\Server(isset($argv[1]) ? $argv[1] : '0.0.0.0:0', $loop);
$server->listen($socket);

$loop->run();
```

Make sure the callback function has 2 parameters. The first parameter is always the PSR-7 request object. The second parameter is the next endpoint defined in your API. If no next function is given it will be the default function of the server which will respond with will create an 404 error by default.

Usage
-----

[](#usage)

### Server

[](#server)

The `Server` uses the [ReactPHP HTTP Server](https://github.com/reactphp/http) and uses its internal implemented [middleware](https://github.com/reactphp/http#middleware)

Every endpoint is added as a middleware, therefor a request will pass every function sequentially. The second parameter (defined as `$next` in these examples) can be used to pass the request to following endpoint.

### Dynamic Values

[](#dynamic-values)

To add dynamic values in the REST API definition the operator `:` can be used

```
$server->post('/say/:word', function (\Psr\Http\Message\ServerRequestInterface $request, callable $next, array $parameters) {
    $word = $parameters['word'];

    return new \React\Http\Response(200, array(), 'You said: ' . $word);
});
```

Now a HTTP client can call the address e.g. `http://localhost:8080/say/hello`. The key `word` and value `hello` will be stored in the third parameter of the callback function.

There is no type check her that can validate which API should be used. `/say/:word` and`/say/:number` would be the same. In this case the order of your API definition matters.

### Default Callback

[](#default-callback)

A default callback can be defined in the `listen` method. This method will be used if no definition can be found.

By default this library will respond with an `404` HTTP response.

### Parameter Placeholder

[](#parameter-placeholder)

As seen in the previous chapter you can use the `:` to mark dynamic values. Instead of using this strategy, to mark dynamic parameters, this library supports additional strategies via different classes:

- `/to/path/:paramter` - `Legionth\React\Http\Rest\Paramaters\Label\Colon`
- `/to/path/[paramter]` - `Legionth\React\Http\Rest\Paramaters\Label\CurlyBracket`
- `/to/path/{paramter}` - `Legionth\React\Http\Rest\Paramaters\Label\SquareBrackets`

Checkout the examples for more information.

Install
-------

[](#install)

The recommended way to install this library is [through Composer](https://getcomposer.org). [New to Composer?](https://getcomposer.org/doc/00-intro.md)

This will install the latest supported version:

```
$ composer require legionth/http-rest:^0.2
```

License
-------

[](#license)

MIT

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity56

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 ~27 days

Total

4

Last Release

2646d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e3241ea646d5298776a417a7e552e7bec0d3dd81ada4be370f8f0b91cd2d09b3?d=identicon)[legionth](/maintainers/legionth)

---

Top Contributors

[![legionth](https://avatars.githubusercontent.com/u/1578709?v=4)](https://github.com/legionth "legionth (20 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/legionth-http-rest/health.svg)

```
[![Health](https://phpackages.com/badges/legionth-http-rest/health.svg)](https://phpackages.com/packages/legionth-http-rest)
```

###  Alternatives

[discord-php/http

Handles HTTP requests to Discord servers

25318.7k8](/packages/discord-php-http)[clue/soap-react

Simple, async SOAP webservice client library, built on top of ReactPHP

64118.0k2](/packages/clue-soap-react)[rx/websocket

Websockets for PHP using Rx

34181.5k2](/packages/rx-websocket)[php-http/react-adapter

React HTTP Adapter

19260.9k3](/packages/php-http-react-adapter)[voryx/websocketmiddleware

WebSocket Middleware for React

2669.2k3](/packages/voryx-websocketmiddleware)[drift/http-kernel

Http Kernel component for Drift, based on Symfony Http Kernel component

3624.1k17](/packages/drift-http-kernel)

PHPackages © 2026

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