PHPackages                             uhura/uhura - 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. [API Development](/categories/api)
4. /
5. uhura/uhura

ActiveLibrary[API Development](/categories/api)

uhura/uhura
===========

A communications officer for RESTful apis

0.7(9y ago)257397[1 issues](https://github.com/colindecarlo/uhura/issues)[1 PRs](https://github.com/colindecarlo/uhura/pulls)MITPHPPHP >=5.5CI failing

Since Nov 21Pushed 6y agoCompare

[ Source](https://github.com/colindecarlo/uhura)[ Packagist](https://packagist.org/packages/uhura/uhura)[ RSS](/packages/uhura-uhura/feed)WikiDiscussions master Synced 2mo ago

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

Uhura
=====

[](#uhura)

A communications officer for RESTful APIs

Uhura is a dead simple RESTful API client for just about anything. No need to set up schemas or configure API endpoints, just tell Uhura what you want and go get it.

```
$github = new Uhura('https://api.github.com');
$response = $github->users->colindecarlo->repos->get();
```

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

[](#installation)

Install Uhura using composer.

```
$ composer require uhura/uhura
```

Making Requests
---------------

[](#making-requests)

Uhura maps what you ask for in your Demeter chain over to the URL that is used to access the resource you want.

### Examples

[](#examples)

**Send a GET request to `http://someapi.com/users`**

```
$uhura = new Uhura('http://someapi.com');
$response = $uhura->users->get();
```

**Send a GET request to `http://someapi.com/users/1`**

```
$uhura = new Uhura('http://someapi.com');
$response = $uhura->users(1)->get();
```

**Send a GET request to `http://someapi.com/users/1/blogs/some-blog/comments`**

```
$uhura = new Uhura('http://someapi.com');
$response = $uhura->users(1)->blogs('some-blog')->comments->get();
```

### CRUD

[](#crud)

CRUD operations are super simple with Uhura and are mapped to the `create`, `get`, `update` and `delete` methods respectively.

OperationMethod SignatureCreate`create($payload)`Read`get()`Update`update($payload)`Delete`delete()`**`create(array $payload)`**

Use Uhura's `create` method to create resources. The `create` method accepts an associative array of attributes which are sent to the API in the request body as a `x-www-form-urlencoded` string.

```
$uhura = new Uhura('http://someapi.com');
$uhura->users->create(['email' => 'example@example.com']);
```

**`get()`**

Use Uhura's `get` method to get API resources.

```
$uhura = new Uhura('http://someapi.com');
$response = $uhura->users->get();
```

**`update($payload)`**

Use Uhura's `update` method to update a resource. The `update` method accepts an associative array of attributes which are sent to the API in the request body as a `x-www-form-urlencoded` string.

```
$uhura = new Uhura('http://someapi.com');
$uhura->users(1)->update(['name' => 'John Doe']);
```

**`delete()`**

Use Uhura's `delete` method to delete a resource.

```
$uhura = new Uhura('http://someapi.com');
$uhura->users(1)->delete();
```

### Authentication

[](#authentication)

Uhura makes authenticated requests by adding the `Authorization` header to each request that is made.

**Using HTTP Basic Auth**

Tell Uhura to use HTTP Basic Auth with the `useBasicAuthentication($username, $password)` method.

```
$uhura = new Uhura('https://someapi.com');
$uhura->useBasicAuthentication('someuser', 'somepassword');

$uhura->user->update(['email' => 'example@example.com']);
```

**Explicitly Setting the Authorization Header**

You can explicitly set the value of the `Authorization` header by using Uhura's `authenticate($token)` method.

```
$uhura = new Uhura('https://someapi.com');
$uhura->authenticate('Bearer somebearertoken');

$uhura->user->update(['email' => 'example@example.com']);
```

Working With Responses
----------------------

[](#working-with-responses)

By default, Uhura returns [PSR7 compliant](http://www.php-fig.org/psr/psr-7) response objects. Working with them would be as simple as, oh I don't know, a `GuzzleHttp\Psr7\Response` object.

### Response Handlers

[](#response-handlers)

You can tell Uhura to pass API responses through a Response Handler to augment the return value of the various request methods. For instance, Uhura ships with a `Json` Response Handler which consumes the response and returns the decoded JSON response body.

```
$uhura = new Uhura('https://someapi.com');
$uhura->useResponseHandler(new Uhura\ResponseHandler\Json);

$uhura->users(1)->get();
/*
    [
        'email' => 'example@example.com',
        'name' => 'John Doe'
    ]
*/
```

**Writing Custom Response Handlers**

Writing your own custom response handler is super simple. Response Handlers are just simple classes which define a `handle($response)` method. Whatever is returned from the `handle` method is what Uhura will return to you.

```
// XML Response Handler
class XmlHandler
{
    public function handle($response)
    {
        return new SimpleXMLElement($response->getBody()->getContents());
    }
}

$uhura = new Uhura('https://someapi.com');
$uhura->useResponseHandler(new XmlHandler);

echo (string)($uhura->users(1)->get());

/*

        example@example.com
        John Doe

*/
```

Author
------

[](#author)

Colin DeCarlo,

License
-------

[](#license)

Uhura is licensed under the MIT License - see the LICENSE file for details.

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance19

Infrequent updates — may be unmaintained

Popularity26

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 84% 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 ~64 days

Recently: every ~111 days

Total

8

Last Release

3377d ago

### Community

Maintainers

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

---

Top Contributors

[![colindecarlo](https://avatars.githubusercontent.com/u/682860?v=4)](https://github.com/colindecarlo "colindecarlo (21 commits)")[![chapeupreto](https://avatars.githubusercontent.com/u/834048?v=4)](https://github.com/chapeupreto "chapeupreto (1 commits)")[![dansoppelsa](https://avatars.githubusercontent.com/u/933435?v=4)](https://github.com/dansoppelsa "dansoppelsa (1 commits)")[![grantlovell](https://avatars.githubusercontent.com/u/83667?v=4)](https://github.com/grantlovell "grantlovell (1 commits)")[![veganista](https://avatars.githubusercontent.com/u/405763?v=4)](https://github.com/veganista "veganista (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3731.2M42](/packages/tencentcloud-tencentcloud-sdk-php)[convertkit/convertkitapi

Kit PHP SDK for the Kit API

2167.1k1](/packages/convertkit-convertkitapi)[mapado/rest-client-sdk

Rest Client SDK for hydra API

1125.9k2](/packages/mapado-rest-client-sdk)

PHPackages © 2026

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