https://github.com/amphp/artax

An async HTTP/1.1 client for PHP based on Amp.
https://github.com/amphp/artax

amphp artax async http http-client https php

Last synced: 3 months ago
JSON representation

An async HTTP/1.1 client for PHP based on Amp.

• Host: GitHub
• URL: https://github.com/amphp/artax
• Owner: amphp
• License: mit
• Created: 2019-05-29T16:07:36.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2020-02-23T20:04:04.000Z (over 4 years ago)
• Last Synced: 2024-07-22T23:37:32.821Z (3 months ago)
• Topics: amphp, artax, async, http, http-client, https, php
• Language: PHP
• Homepage: https://amphp.org/artax
• Size: 3.1 MB
• Stars: 23
• Watchers: 7
• Forks: 4
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-php-cn - amphp/artax - An Asynchronous HTTP Client for PHP (目录 / HTTP客户端 HTTP Client)

README

        
### :warning: This package has been replaced by [`http-client`](https://amphp.org/http-client)

# artax

[![Build Status](https://img.shields.io/travis/amphp/artax/master.svg?style=flat-square)](https://travis-ci.org/amphp/artax)

[![CoverageStatus](https://img.shields.io/coveralls/amphp/artax/master.svg?style=flat-square)](https://coveralls.io/github/amphp/artax?branch=master)

![License](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)

Artax is an asynchronous HTTP client for PHP based on [Amp](https://github.com/amphp/amp). Its API simplifies standards-compliant HTTP resource traversal and RESTful web service consumption without obscuring the underlying protocol. The library manually implements HTTP over TCP sockets; as such it has no dependency on `ext/curl`.

## Features

 - Requests asynchronously for full single-threaded concurrency

 - Pools persistent keep-alive connections

 - Transparently follows redirects

 - Decodes gzipped entity bodies

 - Exposes headers and message data

 - Streams entity bodies for memory management with large transfers

 - Supports all standard and custom HTTP method verbs

 - Simplifies HTTP form submissions

 - Implements secure-by-default TLS (`https://`)

 - Supports cookies and sessions

 - Functions seamlessly behind HTTP proxies

## Project Goals

 - Model all code as closely as possible to the relevant HTTP protocol RFCs

 - Implement an HTTP/1.1 client built on raw socket streams with no `libcurl` dependency

## Installation

This package can be installed as a [Composer](https://getcomposer.org/) dependency.

```bash

composer require amphp/artax

```

## Documentation

Documentation is bundled within this repository in the [`docs`](./docs) directory.

## Examples

More extensive code examples reside in the [`examples`](./examples) directory.

## Versioning

`amphp/artax` follows the [semver](http://semver.org/) semantic versioning specification like all other `amphp` packages.

| Version | Bug Fixes Until              | Security Fixes Until         |

| ------- | ---------------------------- | ---------------------------- |

| 3.x     | Supported, no end date, yet. | Supported, no end date, yet. |

| 2.x     | Unmaintained.	             | Unmaintained.	            |

| 1.x     | Unmaintained.                | Unmaintained.                |

## Security

If you discover any security related issues, please email [`[email protected]`](mailto:[email protected]) instead of using the issue tracker.

## License

The MIT License (MIT). Please see [`LICENSE`](./LICENSE) for more information.