PHPackages webguosai/http-client-v2 - 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. webguosai/http-client-v2 ActiveLibrary[HTTP & Networking](/categories/http) webguosai/http-client-v2 ======================== http客户端 0208PHP Since Mar 23Pushed 1mo agoCompare [ Source](https://github.com/webguosai/http-client-v2)[ Packagist](https://packagist.org/packages/webguosai/http-client-v2)[ RSS](/packages/webguosai-http-client-v2/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependenciesVersions (1)Used By (0) http client v2 ============== [](#http-client-v2) [![Latest Stable Version](https://camo.githubusercontent.com/d30c688d1e0953801d39579bebcb84cf799b36ee0cb347e28bfa21e62c7a4d2d/68747470733a2f2f706f7365722e707567782e6f72672f77656267756f7361692f687474702d636c69656e742d76322f762f737461626c65)](https://packagist.org/packages/webguosai/http-client-v2)[![Total Downloads](https://camo.githubusercontent.com/33c2d58f40ad135d78cf19d2e15acfd83d1d7c1ed3989fbb6660bc3ab1183857/68747470733a2f2f706f7365722e707567782e6f72672f77656267756f7361692f687474702d636c69656e742d76322f646f776e6c6f616473)](https://packagist.org/packages/webguosai/http-client-v2)[![Latest Unstable Version](https://camo.githubusercontent.com/cd71cec96634c06210ab20f5f27f3cca6b4f8031f3af40d7a05d34f1fa821329/68747470733a2f2f706f7365722e707567782e6f72672f77656267756f7361692f687474702d636c69656e742d76322f762f756e737461626c65)](https://packagist.org/packages/webguosai/http-client-v2)[![License](https://camo.githubusercontent.com/9d880ede9f1486285be7b2f16131d01b19cd75086a117bf85c4d362b6d0b47cc/68747470733a2f2f706f7365722e707567782e6f72672f77656267756f7361692f687474702d636c69656e742d76322f6c6963656e7365)](https://packagist.org/packages/webguosai/http-client-v2) 运行环境 ---- [](#运行环境) - php >= 7.2 - composer 安装 -- [](#安装) ``` composer require webguosai/http-client-v2 -vvv ``` 使用 -- [](#使用) ### 初始化 [](#初始化) ``` $options = [ //超时 (单位秒，-1表示不超时) 'timeout' => 3.0, // 代理ip // http：127.0.0.1:9527 或 http://127.0.0.1:9527 // https：https://127.0.0.1:9527 // socks5：socks5://127.0.0.1:9527 'proxy' => '', // 重定向 (-1表示：无限制，默认0表示不重定向) 'redirect' => 0, //cookie自动保存路径 'cookieJarFile' => 'cookie.txt', ]; // 实例化 $http = new \Webguosai\HttpClient\HttpClient($options); // 工厂模式 $http = \Webguosai\HttpClient\HttpClient::factory([ 'timeout' => 3, ]) ``` ### 链式 [](#链式) ``` $http->timeout(5.5)->redirect(5)->proxy('socks5://127.0.0.1:9527'); ``` ### 请求 [](#请求) ``` $url = 'https://httpbin.org'; $data = ['data' => '111', 'data2' => '222']; $headers = [ 'User-Agent' => 'http-client browser', 'cookie' => 'login=true' ]; // 请求方式 $response = $http->request($url, $method, $data, $headers); $response = $http->get($url, $query, $headers); $response = $http->post($url, $data, $headers); $response = $http->put($url, $data, $headers); $response = $http->patch($url, $data, $headers); $response = $http->delete($url, $data, $headers); $response = $http->head($url, $data, $headers); $response = $http->options($url, $data, $headers); ``` ### 响应 [](#响应) ``` [$status, $throw] = $response->ok(); // $response->getRequestHeaders(); // 请求头 $response->getHeaders(); // 响应头 $response->getBody(); // body $response->getStatusCode(); // http状态码 $response->getInfo(); // 其它信息 $response->getResponse(); // 获取响应的报文信息(包含header头、body) $response->json(); // json $response->xml(); // xml $response->ok();// curl_code = 0 && http_code = 200 $response->getCurlErrorCode(); // 错误信息 ``` ### data 传值方式 [](#data-传值方式) ``` // multipart/form-data $data = ['data' => '111', 'data2' => '222']; // application/x-www-form-urlencoded $data = http_build_query($data); // application/json $data = json_encode($data); // 文件上传 $_FILES['file'] 接收 $data = [ 'file' => new \CURLFile('1.jpg'), ]; $response = $http->post($url, $data); ``` ### headers 传值方式 [](#headers-传值方式) ``` // 数组传递 $headers = [ 'User-Agent: chrome', 'User-Agent' => 'chrome', ]; // 纯字符串 (一般为从浏览器复制) $headers = 'User-Agent: chrome Referer: https://www.x.com Cookie: cookie=6666666'; $response = $http->post($url, $data, $headers); ``` 实操 -- [](#实操) ``` $http = \Webguosai\HttpClient\HttpClient::factory([ 'timeout' => 3, ]) $response = $http->get('https://www.baidu.com'); /** @var $throw \Webguosai\HttpClient\Exception\RequestException */ [$status, $throw] = $response->ok(); if ($status) { var_dump($response->getBody()); // body var_dump($response->json()); var_dump($response->xml()); } else { var_dump($throw->getMessage()); // 错误内容 var_dump($throw->getRequestArgs()); // 请求前的传参 var_dump($throw->getContext()); // 上下文 信息 var_dump($throw->getErrorType()); // 错误类型 var_dump($throw->getHttpStatusCode()); // http 状态码 var_dump($throw->getCurlErrorCode()); // curl 错误码 } ``` 异常 -- [](#异常) - ok ``` // 自定义异常错误 [$status, $throw] = $response->ok(function (\Webguosai\HttpClient\Contract\ResponseInterface $response) { if ($response->getBody() !== 'hello world') { throw new \Webguosai\HttpClient\Exception\RequestException('自定义异常错误', $response); } }); if ($status) { var_dump($response->json()); } else { var_dump($throw->getMessage()); // 错误内容 var_dump($throw->getRequestArgs()); // 请求前的传参 var_dump($throw->getContext()); // 上下文 信息 var_dump($throw->getErrorType()); // 错误类型 var_dump($throw->getHttpStatusCode()); // http 状态码 var_dump($throw->getCurlErrorCode()); // curl 错误码 } ``` - throw ``` try { $response->throw(); var_dump($response->json()); // 自定义异常错误 if ($response->getBody() !== 'hello world') { throw new \Webguosai\HttpClient\Exception\RequestException('自定义异常错误', $response); } } catch (\Webguosai\HttpClient\Exception\RequestException $e) { var_dump($e->getMessage()); // 错误内容 var_dump($e->getRequestArgs()); // 请求前的传参 var_dump($e->getContext()); // 上下文 信息 var_dump($e->getErrorType()); // 错误类型 var_dump($e->getHttpStatusCode()); // http 状态码 var_dump($e->getCurlErrorCode()); // curl 错误码 } ``` License ------- [](#license) MIT ### Health Score 23 — LowBetter than 27% of packages Maintenance60 Regular maintenance activity Popularity12 Limited adoption so far Community6 Small or concentrated contributor base Maturity11 Early-stage or recently created project 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. ### Community Maintainers ![](https://www.gravatar.com/avatar/79b27387fc59b6ba29854bad71e11e6f7269534da234243353c5ec876bf9af5a?d=identicon)[json.](/maintainers/json.) --- Top Contributors [![webguosai](https://avatars.githubusercontent.com/u/2083784?v=4)](https://github.com/webguosai "webguosai (17 commits)") --- Tags guzzlehttphttpclient ### Embed Badge ![Health badge](/badges/webguosai-http-client-v2/health.svg) ``` [![Health](https://phpackages.com/badges/webguosai-http-client-v2/health.svg)](https://phpackages.com/packages/webguosai-http-client-v2) ``` ### Alternatives [friendsofsymfony/rest-bundle This Bundle provides various tools to rapidly develop RESTful API's with Symfony 2.8k73.3M317](/packages/friendsofsymfony-rest-bundle)[php-http/discovery Finds and installs PSR-7, PSR-17, PSR-18 and HTTPlug implementations 1.3k309.5M1.2k](/packages/php-http-discovery)[nyholm/psr7 A fast PHP7 implementation of PSR-7 1.3k235.4M2.4k](/packages/nyholm-psr7)[pusher/pusher-php-server Library for interacting with the Pusher REST API 1.5k94.8M292](/packages/pusher-pusher-php-server)[spatie/crawler Crawl all internal links found on a website 2.8k16.3M52](/packages/spatie-crawler)[react/http Event-driven, streaming HTTP client and server implementation for ReactPHP 78126.4M414](/packages/react-http) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)