PHPackages                             cline/relay - 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. cline/relay

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

cline/relay
===========

A modern, attribute-driven HTTP client for PHP

4.0.0(5mo ago)05.9k↑2279.5%MITPHPPHP ^8.4CI passing

Since Dec 30Pushed 5mo agoCompare

[ Source](https://github.com/faustbrian/relay)[ Packagist](https://packagist.org/packages/cline/relay)[ RSS](/packages/cline-relay/feed)WikiDiscussions 4.x Synced 1w ago

READMEChangelog (5)Dependencies (37)Versions (16)Used By (0)

[![GitHub Workflow Status](https://github.com/faustbrian/relay/actions/workflows/quality-assurance.yaml/badge.svg)](https://github.com/faustbrian/relay/actions)[![Latest Version on Packagist](https://camo.githubusercontent.com/7e0d0ba9b4f867c80e39e8c069ffc804f49de35f0271e1a2316caffa3997964c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f636c696e652f72656c61792e737667)](https://packagist.org/packages/cline/relay)[![Software License](https://camo.githubusercontent.com/784362b26e4b3546254f1893e778ba64616e362bd6ac791991d2c9e880a3a64e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d677265656e2e737667)](LICENSE.md)[![Total Downloads](https://camo.githubusercontent.com/6e297449ad4405f4511d8c19b6e9c9d2725bd270cb9d4672f5ddf25488130ce6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f636c696e652f72656c61792e737667)](https://packagist.org/packages/cline/relay)

---

Relay is a modern, attribute-driven HTTP client for PHP 8.4+. It provides an elegant, type-safe API for building API integrations with support for authentication, caching, rate limiting, retries, and more.

Requirements
------------

[](#requirements)

> **Requires [PHP 8.4+](https://php.net/releases/)**

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

[](#installation)

```
composer require cline/relay
```

Documentation
-------------

[](#documentation)

Full documentation is available at **[docs.cline.sh/relay](https://docs.cline.sh/relay/getting-started/)**

### Guides

[](#guides)

- **[Getting Started](https://docs.cline.sh/relay/getting-started/)** - Installation and basic concepts
- **[Connectors](https://docs.cline.sh/relay/connectors/)** - Creating and configuring API connectors
- **[Requests](https://docs.cline.sh/relay/requests/)** - Building typed request objects
- **[Responses](https://docs.cline.sh/relay/responses/)** - Working with API responses
- **[Attributes](https://docs.cline.sh/relay/attributes/)** - HTTP methods, content types, and behavior attributes
- **[Authentication](https://docs.cline.sh/relay/authentication/)** - Bearer tokens, Basic auth, and custom strategies
- **[Middleware](https://docs.cline.sh/relay/middleware/)** - Request/response middleware
- **[Caching](https://docs.cline.sh/relay/caching/)** - Response caching strategies
- **[Rate Limiting](https://docs.cline.sh/relay/rate-limiting/)** - Client-side rate limiting
- **[Resilience](https://docs.cline.sh/relay/resilience/)** - Retries and circuit breakers
- **[Pagination](https://docs.cline.sh/relay/pagination/)** - Handling paginated APIs
- **[Pooling](https://docs.cline.sh/relay/pooling/)** - Concurrent request execution
- **[Testing](https://docs.cline.sh/relay/testing/)** - Mocking and fixtures
- **[Debugging](https://docs.cline.sh/relay/debugging/)** - Request/response inspection
- **[Generators](https://docs.cline.sh/relay/generators/)** - Artisan scaffolding commands
- **[Advanced Usage](https://docs.cline.sh/relay/advanced-usage/)** - DTOs, GraphQL, streaming, and more

Change log
----------

[](#change-log)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) and [CODE\_OF\_CONDUCT](CODE_OF_CONDUCT.md) for details.

Security
--------

[](#security)

If you discover any security related issues, please use the [GitHub security reporting form](https://github.com/faustbrian/relay/security) rather than the issue queue.

Credits
-------

[](#credits)

- [Brian Faust](https://github.com/faustbrian)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License. Please see [License File](LICENSE.md) for more information.

###  Health Score

45

—

FairBetter than 91% of packages

Maintenance73

Regular maintenance activity

Popularity24

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity61

Established project with proven stability

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

Recently: every ~0 days

Total

15

Last Release

151d ago

Major Versions

1.x-dev → 2.0.02026-03-04

2.x-dev → 3.0.02026-03-18

3.x-dev → 4.0.02026-03-20

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/22145591?v=4)[Brian Faust](/maintainers/faustbrian)[@faustbrian](https://github.com/faustbrian)

---

Top Contributors

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

---

Tags

httpphpapiclientrestgraphqlGuzzle

###  Code Quality

TestsPest

### Embed Badge

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

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

###  Alternatives

[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.8M674](/packages/shopware-core)[shopware/platform

The Shopware e-commerce core

3.4k1.5M3](/packages/shopware-platform)[tempest/framework

The PHP framework that gets out of your way.

2.3k37.6k21](/packages/tempest-framework)[moonshine/moonshine

Laravel administration panel

1.3k268.2k89](/packages/moonshine-moonshine)[flow-php/flow

PHP ETL - Extract Transform Load - Data processing framework

86337.5k](/packages/flow-php-flow)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

265.2k](/packages/aedart-athenaeum)

PHPackages © 2026

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