PHPackages                             iry/request - 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. iry/request

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

iry/request
===========

v1.0.2(3y ago)1202MITPHPPHP >=5.4.0

Since Jan 11Pushed 3y ago1 watchersCompare

[ Source](https://github.com/imroychen/request)[ Packagist](https://packagist.org/packages/iry/request)[ RSS](/packages/iry-request/feed)WikiDiscussions master Synced 1w ago

READMEChangelogDependenciesVersions (4)Used By (0)

**中文简体** ----- [English](README-EN.md)

简介
==

[](#简介)

该包通过对CURL的封装，轻松实现各种情况下的网络请求。 支持支持单线程和多线程并发请求。 可以随时无缝切换单线程和多线程的并发请求。
-------------------------------------------------------------------

[](#该包通过对curl的封装轻松实现各种情况下的网络请求-支持支持单线程和多线程并发请求可以随时无缝切换单线程和多线程的并发请求)

安装
==

[](#安装)

```
composer require iry/request
composer update
```

---

使用示例
====

[](#使用示例)

1. Helper 助手函数
--------------

[](#1-helper-助手函数)

```
use \iry\http\Helper;
Helper::get(url);             //发送一个Get请求
Helper::post(url,$post);      //发送一个post请求
Helper::put(url,'This is test');      //发送一个post请求
Helper::request(url,$argvs,isPost);
Helper::upload(url,'/test.jpg',['id'=>100]);//上传文件
Helper::upload(url,['img'=>'/test2.jpg'],['id'=>101]);//上传文件
Helper::download(url,$dist);  //下载一个文件
```

---

2. Request 使用方法:
----------------

[](#2-request-使用方法)

示例

```
//1.简单用法
$res = (new Request($url)) -> getResult();
//2. 多任务并发请求
//常规写法
$http = new Request();
//$http->setThread(20);//设置最大20并发，任务总数超过20会分批处理
$http->add(url,config,requestID);//
$http->add(.....);
$thtp->call(function($requestId,$resVi,$currentRequest,$_this){

});
//连贯写法
(new Request()) -> setThread(20)->add('url','...')->....->add(url_n,'....')->call(function(){

});
```

支持的方法：

1. getResult ：获取所有请求结果，返回一个数组，每一元素是一个任务的结果
2. call: 发送请求并将结果通过匿名闭包函数处理 推荐使用（特别适合大量的请求批量使用）
3. setThread：设置线程数量
4. on: 监听事件
5. add:添加一个请求任务
6. setTasks:批量设置一批任务

---

---

3. Request 各种用法的示例:
-------------------

[](#3-request-各种用法的示例)

### ①. 简单使用【适用小的返回数据】

[](#-简单使用适用小的返回数据)

```
use iry\http\Request;

//发送一个Get请求
$res = (new Request($url)) -> getResult();

//发送一个Post请求
$res = (new Request($url,['post'=>[...])) -> getResult();
```

### ②. 使用 ADD 添加多个任务，实现多线程并发请求

[](#-使用-add-添加多个任务实现多线程并发请求)

发送请求

```
$http = new Request();
//$http->add($url_1,$cfg_1,request_1_id);  request_1_id 唯一ID 多个请求是用来跟踪请求结果用的
$http->add($url_2,$cfg_2,request_2_id)->add(....)->add(....); //支持连贯调用
//$result = $http->getResult(); or $http->call(..);
```

#### getResult方法

[](#getresult方法)

返回一个二维数组，requestID为键，处理结果的逻辑代码如下

```
$result = $http->getResult();
foreach($result as $itemResult){
	$html = $http->getContent($itemResult);//获取到结果
 	$headerInfo = $http->getInfo($itemResult);//获取到头部信息
 	//.....更多的逻辑代码......
 	//todo 您的业务代码...
 }
```

以上是常规的业务流程，但是有一个***弊端***，必须等所有请求都完成之后在统一处理。 任务过程中任务太多占用内存较多。同时只要一个慢会导致所有请求的结果处理推后。

所以推荐如下方法处理 用 $http->call()方法代替 $http->getResult()

#### call方法

[](#call方法)

参数：

1. callback function($requestID,$resVi,$request,$this){....}
2. $maxRetryTimes 错误时最大重试次数 默认0（不重试）

```
//传一个匿名函数给Call 每一个请求完成之后会调用该匿名函数
$http->call(function($requestId,$resVi,$request,$http){
    $content = $http->getContent($resVi);
    $info = $http->getInfo($resVi);

    if($info['http_code']===0){
        $http->retry($requestId);//网络错误 加入重试队列
    }
    //todo 你的业务代码...
},3);

//第二个参数 3 最大重试次数
```

### ③. retry方法可以很方便加入重试

[](#-retry方法可以很方便加入重试)

```
参考上面代码

```

### ④. 使用批量添加任务

[](#-使用批量添加任务)

```
$http = new Request();
$http->setTasks([ [url1,$config],[url2,$config] ]);
$http->call(function(){
    //....
});
```

### ⑤. 监听动作【事件功能】

[](#-监听动作事件功能)

```
$http->on( 'before_request', function($this,$每批请求){...} );
$http->on( 'error', function($info,$curlError,$this){...} )
     ->on( 'item_after_request', function($idx,$resVi,$currentRequest,$this){...} )
	 ->call(function(){
 			//.....更多的逻辑代码...... *
 })
```

支持的事件

```
//网络错误是触发
error: function($info,$curlError,$this)
before_request:function($每批请求,$this){...}
//每个任务请求前触发
item_before_request:function($idx,$config,$this){...}
//每个任务请求对方响应完后触发
item_after_request:function($idx,$resVi,$currentRequest,$this){...}
```

### ⑥. 下在文件 特别是下载大文件。

[](#-下在文件-特别是下载大文件)

```
一边下载一边写入文件不会占用太多内存
用法如上

```

```
//单线程获取
 $res = (new Request($url,['to_file'=>'file address|ture'])) -> getResult();
 //多线程获取
(new Request()) -> add($url_1,['to_file'=>'file address|ture'],requestID_1)
                -> add($url_2,['to_file'=>'file address|ture'],requestID_2)
                ->call( ... )
//多线程批量设置任务
(new Request()) ->setTasks([[url1,['to_file'=>'file/address/or/bool true'],'....']])
->call(...)
```

### ⑦ \_\_construct,add 第二个 config参数

[](#-__constructadd-第二个-config参数)

常用参数：

1. post: form-data array / raw-value 如:\['name'=>'jack','id'=>123456\]
    相当于同时 设置 CURLOPT\_POST：1 ， CURLOPT\_POSTFIELDS：form-data
2. to\_file: fielName 将结果写入文件，边下载边写入到文件，
    作用比较适合下载大文件或者大量数据内容。 [参考 curl\_setopt函数的第二个参数](https://www.php.net/manual/zh/function.curl-setopt.php)

config 为:

```
    //如需要设置 CURLOPT_HTTPHEADER 和 CURLOPT_ENCODING
    ['httpheader'=>'...','encoding'=>'...']
    //键 “httpheader” 为：CURLOPT_HTTPHEADER 去除 CURLOPT_之后的值，且不区分大小写。
```

---

声明：
---

[](#声明)

使用之前请先读[README.txt](./README.txt);

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 88.9% 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 ~198 days

Total

3

Last Release

1192d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/332367a6e49c4e91e2b816a39fdcecf212415f826cf0261981bc1db95075f6e2?d=identicon)[roychen](/maintainers/roychen)

---

Top Contributors

[![roy2chen](https://avatars.githubusercontent.com/u/4337618?v=4)](https://github.com/roy2chen "roy2chen (16 commits)")[![imroychen](https://avatars.githubusercontent.com/u/5027164?v=4)](https://github.com/imroychen "imroychen (1 commits)")[![kaixingwang](https://avatars.githubusercontent.com/u/63831106?v=4)](https://github.com/kaixingwang "kaixingwang (1 commits)")

---

Tags

curlcurl-multimulti-threaded-requestphp-requestpostrequestrequestcurlpostcurl\_multiphp-requestMulti-threaded request

### Embed Badge

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

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

###  Alternatives

[aplus/http-client

Aplus Framework HTTP Client Library

2161.6M1](/packages/aplus-http-client)[pear/http_request2

Provides an easy way to perform HTTP requests.

764.2M48](/packages/pear-http-request2)[stefangabos/zebra_curl

A high performance solution for making multiple HTTP requests concurrently, asynchronously from your PHP projects using cURL

21971.3k2](/packages/stefangabos-zebra-curl)[phpgt/fetch

Asynchronous HTTP client with promises.

3724.0k3](/packages/phpgt-fetch)[multirequest/multirequest

PHP library for easy and flexible multithread requests handling by CURL.

8331.7k1](/packages/multirequest-multirequest)[pdeans/http

PSR-7 cURL HTTP client with support for PSR-17 HTTP factories.

1466.2k3](/packages/pdeans-http)

PHPackages © 2026

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