PHPackages                             thenextinvoice/norest - 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. thenextinvoice/norest

ActiveLibrary

thenextinvoice/norest
=====================

NOva REST for the wicked

1.2.0(1y ago)01.3k↓20%1LGPL-2.1-onlyPHPPHP >= 7.3

Since Oct 15Pushed 1y ago3 watchersCompare

[ Source](https://github.com/TheNextInvoice/NoREST)[ Packagist](https://packagist.org/packages/thenextinvoice/norest)[ RSS](/packages/thenextinvoice-norest/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (3)DependenciesVersions (5)Used By (0)

NoREST
======

[](#norest)

A simple REST client built on ext-curl.

The best way to get started with NoREST is by simply trying some simple things: the API is intentionally small to not overload you with complicated options you'll probably not need 99.999999% of the time.

Just create a client, add some settings to it and fire away!

The only thing to note is that setting options on the client instance does not change the options on that client: instead, it returns a new client with that option added or changed.

```
$client = new \TheNextInvoice\NoREST\Client('https://api.example.com')
    ->setContentType('text/plain')
    ->addHeader('X-Sent-By', 'James Bond');
try {
    $secret_endpoint = $client->get('/endpoint/secret');
    $response = $client->post($secret_endpoint, $my_secret_stuff);
} catch (\TheNextInvoice\NoREST\Exceptions\RequestFailedException $e) {
    echo 'oops, request failed: ' . $e->getMessage() . PHP_EOL;
    echo 'the response body was' . PHP_EOL;
    echo $e->getBody();
}

echo 'server response was:' . PHP_EOL
echo $response . PHP_EOL;
```

Specialized options
-------------------

[](#specialized-options)

Sometimes you need to interface with API's that aren't really playing by the rules. So to facilitate that we've made a couple of helpers.

### Treat header names case-sensitive

[](#treat-header-names-case-sensitive)

While RFC 2616 section 4.2 says that header field names should be treated in a case-insensitive manner, there are servers that do treat headers case-sensitive. If you want to make sure NoREST does not call `strtolower` on your header key, do the following:

```
$client = new \TheNextInvoice\NoREST\Client('https//api.example.com')
            ->addHeader('X-CaSeInSeNsItIvEiSsTuPiD', 'true', ['nolowercase' => true]);
```

### Empty POST request

[](#empty-post-request)

Sometimes one needs to send an empty POST request. NoREST attempts to stick close to the HTTP spec, so one cannot send a completely empty POST request. However, a POST request with an empty body is perfectly fine:

```
// this won't work
$client->post('/endpoint');
// but this will
$client->post('/endpoint', []);
```

### JSON flags

[](#json-flags)

When you're working with JSON payloads and have to deal with non-standard or just specific data, NoREST has you covered by allowing you to specify JSON flags that NoREST will use when encoding and decoding JSON payloads. If you for example, don't want to escape slashes `/` and also want to convert tags `` to unicode, you should do this:

```
// Construct client with JSON flags
$client = new \TheNextInvoice\NoREST\Client('https//api.example.com', [], [JSON_UNESCAPED_SLASHES, JSON_HEX_TAG]);
```

All requests made with a client constructed this way will have `JSON_UNESCAPED_SLASHES` and `JSON_HEX_TAG` JSON flags applied when encoding AND decoding the request and response body respectively.

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance39

Infrequent updates — may be unmaintained

Popularity20

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 83.3% 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 ~577 days

Total

3

Last Release

521d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/11576012?v=4)[Joram Kruijer](/maintainers/joramkruijer)[@joramkruijer](https://github.com/joramkruijer)

---

Top Contributors

[![joramkruijer](https://avatars.githubusercontent.com/u/11576012?v=4)](https://github.com/joramkruijer "joramkruijer (5 commits)")[![rasko-lazic](https://avatars.githubusercontent.com/u/16666607?v=4)](https://github.com/rasko-lazic "rasko-lazic (1 commits)")

### Embed Badge

![Health badge](/badges/thenextinvoice-norest/health.svg)

```
[![Health](https://phpackages.com/badges/thenextinvoice-norest/health.svg)](https://phpackages.com/packages/thenextinvoice-norest)
```

PHPackages © 2026

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