最簡單輕量的PHP CURL工具庫 ws-http

zengdongbao 發布于2019-06-27 14:11 / 2829人閱讀

摘要：簡單輕量的客戶端工具庫可用于測試支持代理自定義請求頭以及常用請求方法需求安裝使用在文件中新增如下行或者手動運行命令使用創建一個請求支持的方法此處給出一些簡單的實例請求響應

ws-http 簡單輕量的HTTP 客戶端工具庫(An Simplified, lightweight HTTP client library)

可用于 HTTP API 測試,支持 ssl,basic auth,代理,自定義請求頭,以及常用HTTP 請求方法.(An HTTP API testing framework, written in PHP using curl. Supports ssl, basic auth, passing custom request headers, and most HTTP request methods.

--- https://github.com/toohamster...

需求(Requirements)

cURL

PHP 5.4+

安裝(Installation) 使用 (Using) Composer

在composer.json文件中新增如下行(To install ws-http with Composer, just add the following to your composer.json file):

{
    "require": {
        "toohamster/ws-http": "*"
    }
}

或者手動運行命令(or by running the following command):

php composer require toohamster/ws-http

Http Request 使用(Http Request Usage) 創建一個請求(Creating a Request)

$httpRequest = WsHttpRequest::create();

支持的方法(Support Method)

// set config
$httpRequest->jsonOpts($assoc = false, $depth = 512, $options = 0);
$httpRequest->verifyPeer($enabled);
$httpRequest->verifyHost($enabled);
$httpRequest->verifyFile($file);
$httpRequest->getVerifyFile();
$httpRequest->timeout($seconds);
$httpRequest->defaultHeaders($headers);
$httpRequest->defaultHeader($name, $value);
$httpRequest->clearDefaultHeaders();
$httpRequest->curlOpts($options);
$httpRequest->curlOpt($name, $value);
$httpRequest->clearCurlOpts();
$httpRequest->cookie($cookie);
$httpRequest->cookieFile($cookieFile);
$httpRequest->auth($username = "", $password = "", $method = CURLAUTH_BASIC);
$httpRequest->proxy($address, $port = 1080, $type = CURLPROXY_HTTP, $tunnel = false);
$httpRequest->proxyAuth($username = "", $password = "", $method = CURLAUTH_BASIC);

// http call
$httpRequest->get($url, $headers = [], $parameters = null);
$httpRequest->head($url, $headers = [], $parameters = null);
$httpRequest->options($url, $headers = [], $parameters = null);
$httpRequest->connect($url, $headers = [], $parameters = null);
$httpRequest->post($url, $headers = [], $body = null);
$httpRequest->delete($url, $headers = [], $body = null);
$httpRequest->put($url, $headers = [], $body = null);
$httpRequest->patch($url, $headers = [], $body = null);
$httpRequest->trace($url, $headers = [], $body = null);

此處給出一些簡單的實例(Let"s look at a working example):

$headers = array("Accept" => "application/json");
$query = array("foo" => "hello", "bar" => "world");

$response = $httpRequest->post("http://mockbin.com/request", $headers, $query);

$response->code;        // 請求響應碼(HTTP Status code)
$response->curl_info;   // curl信息(HTTP Curl info)
$response->headers;     // 響應頭(Headers)
$response->body;        // 處理后的響應消息體(Parsed body)
$response->raw_body;    // 原始響應消息體(Unparsed body)

JSON 請求(Requests) (application/json)

$headers = array("Accept" => "application/json");
$data = array("name" => "ahmad", "company" => "mashape");

$body = WsHttpRequestBody::json($data);

$response = $httpRequest->post("http://mockbin.com/request", $headers, $body);

注意(Notes):

Content-Type 會自動設置成(headers will be automatically set to) application/json

表單請求(Form Requests) (application/x-www-form-urlencoded)

$headers = array("Accept" => "application/json");
$data = array("name" => "ahmad", "company" => "mashape");

$body = WsHttpRequestBody::form($data);

$response = $httpRequest->post("http://mockbin.com/request", $headers, $body);

注意(Notes):

Content-Type 會自動設置成(headers will be automatically set to) application/x-www-form-urlencoded

Multipart Requests (multipart/form-data)

$headers = array("Accept" => "application/json");
$data = array("name" => "ahmad", "company" => "mashape");

$body = WsHttpRequestBody::multipart($data);

$response = $httpRequest->post("http://mockbin.com/request", $headers, $body);

注意(Notes):

Content-Type 會自動設置成(headers will be automatically set to) multipart/form-data.

文件上傳(Multipart File Upload)

$headers = array("Accept" => "application/json");
$data = array("name" => "ahmad", "company" => "mashape");
$files = array("bio" => "/path/to/bio.txt", "avatar" => "/path/to/avatar.jpg");

$body = WsHttpRequestBody::multipart($data, $files);

$response = $httpRequest->post("http://mockbin.com/request", $headers, $body);

$headers = array("Accept" => "application/json");
$body = array(
    "name" => "ahmad", 
    "company" => "mashape"
    "bio" => WsHttpRequestBody::file("/path/to/bio.txt", "text/plain"),
    "avatar" => WsHttpRequestBody::file("/path/to/my_avatar.jpg", "text/plain", "avatar.jpg")
);

$response = $httpRequest->post("http://mockbin.com/request", $headers, $body);

自定義消息體(Custom Body)

可以使用WsHttpRequestBody類提供的方法來生成消息體或使用PHP自帶的序列化函數來生成消息體(Sending a custom body such rather than using the WsHttpRequestBody helpers is also possible, for example, using a serialize body string with a custom Content-Type):

$headers = array("Accept" => "application/json", "Content-Type" => "application/x-php-serialized");
$body = serialize((array("foo" => "hello", "bar" => "world"));

$response = $httpRequest->post("http://mockbin.com/request", $headers, $body);

授權校驗(Authentication)

$httpRequest->auth($username, $password, $method);// default is CURLAUTH_BASIC

支持的方法(Supported Methods)

Method	Description
CURLAUTH_BASIC	HTTP Basic authentication.
CURLAUTH_DIGEST	HTTP Digest authentication. as defined in RFC 2617
CURLAUTH_DIGEST_IE	HTTP Digest authentication with an IE flavor. The IE flavor is simply that libcurl will use a special "quirk" that IE is known to have used before version 7 and that some servers require the client to use.
CURLAUTH_NEGOTIATE	HTTP Negotiate (SPNEGO) authentication. as defined in RFC 4559
CURLAUTH_NTLM	HTTP NTLM authentication. A proprietary protocol invented and used by Microsoft.
CURLAUTH_NTLM_WB	NTLM delegating to winbind helper. Authentication is performed by a separate binary application. see libcurl docs for more info
CURLAUTH_ANY	This is a convenience macro that sets all bits and thus makes libcurl pick any it finds suitable. libcurl will automatically select the one it finds most secure.
CURLAUTH_ANYSAFE	This is a convenience macro that sets all bits except Basic and thus makes libcurl pick any it finds suitable. libcurl will automatically select the one it finds most secure.
CURLAUTH_ONLY	This is a meta symbol. OR this value together with a single specific auth value to force libcurl to probe for un-restricted auth and if not, only that single auth algorithm is acceptable.

// custom auth method
$httpRequest->proxyAuth("username", "password", CURLAUTH_DIGEST);

Cookies

$httpRequest->cookie($cookie)

$httpRequest->cookieFile($cookieFile)

$cookieFile 參數必須是可讀取的文件路徑(must be a correct path with write permission).

請求對象(Request Object)

$httpRequest->get($url, $headers = array(), $parameters = null)
$httpRequest->post($url, $headers = array(), $body = null)
$httpRequest->put($url, $headers = array(), $body = null)
$httpRequest->patch($url, $headers = array(), $body = null)
$httpRequest->delete($url, $headers = array(), $body = null)

url - 請求地址(Endpoint, address, or uri to be acted upon and requested information from)

headers - 請求頭(Request Headers as associative array or object)

body - 請求消息體(Request Body as associative array or object)

可以使用標準的HTTP方法,也可以使用自定義的HTTP方法(You can send a request with any standard or custom HTTP Method):

$httpRequest->send(WsHttpMethod::LINK, $url, $headers = array(), $body);

$httpRequest->send("CHECKOUT", $url, $headers = array(), $body);

響應對象(Response Object)

code - 請求響應碼(HTTP Status code)

curl_info - HTTP curl信息(HTTP Curl info)

headers - 響應頭(HTTP Response Headers)

body - 處理后的響應消息體(Parsed body)

raw_body - 原始響應消息體(Unparsed body)

高級設置(Advanced Configuration) 自定義json_decode選項(Custom JSON Decode Flags)

$httpRequest->jsonOpts(true, 512, JSON_NUMERIC_CHECK & JSON_FORCE_OBJECT & JSON_UNESCAPED_SLASHES);

超時設置(Timeout)

$httpRequest->timeout(5); // 5s timeout

代理(Proxy)

可以設置代理類型(you can also set the proxy type to be one of) CURLPROXY_HTTP, CURLPROXY_HTTP_1_0, CURLPROXY_SOCKS4, CURLPROXY_SOCKS5, CURLPROXY_SOCKS4A, and CURLPROXY_SOCKS5_HOSTNAME.

check the cURL docs for more info.

// quick setup with default port: 1080
$httpRequest->proxy("10.10.10.1");

// custom port and proxy type
$httpRequest->proxy("10.10.10.1", 8080, CURLPROXY_HTTP);

// enable tunneling
$httpRequest->proxy("10.10.10.1", 8080, CURLPROXY_HTTP, true);

代理授權驗證 (Proxy Authenticaton)

// basic auth
$httpRequest->proxyAuth("username", "password", CURLAUTH_DIGEST);

缺省請求頭 (Default Request Headers)

$httpRequest->defaultHeader("Header1", "Value1");
$httpRequest->defaultHeader("Header2", "Value2");

批量配置(You can set default headers in bulk by passing an array):

$httpRequest->defaultHeaders(array(
    "Header1" => "Value1",
    "Header2" => "Value2"
));

清除配置(You can clear the default headers anytime with):

$httpRequest->clearDefaultHeaders();

缺省Curl選項 (Default cURL Options)

You can set default cURL options that will be sent on every request:

$httpRequest->curlOpt(CURLOPT_COOKIE, "foo=bar");

批量配置(You can set options bulk by passing an array):

$httpRequest->curlOpts(array(
    CURLOPT_COOKIE => "foo=bar"
));

清除配置(You can clear the default options anytime with):

$httpRequest->clearCurlOpts();

SSL validation

$httpRequest->verifyPeer(false); // Disables SSL cert validation

By default is true.

Http Watcher 使用(Http Watcher Usage) 支持的方法(Support Method)

$watcher = WsHttpWatcher::create($httpResponse);

$watcher->assertStatusCode($assertedStatusCode);
$watcher->assertTotalTimeLessThan($assertedTime);
$watcher->assertHeadersExist(array $assertedHeaders = []);
$watcher->assertHeaders(array $assertedHeaders = []);
$watcher->assertBody($assertedBody, $useRegularExpression = false);
$watcher->assertBodyJson($asserted, $onNotEqualVarExport = false);
$watcher->assertBodyJsonFile($assertedJsonFile, $onNotEqualPrintJson = false);

例子(Examples)

$httpRequest = WsHttpRequest::create();

$httpResponse = $httpRequest->get("https://api.github.com");
$watcher = WsHttpWatcher::create($httpResponse);

$watcher
         ->assertStatusCode(200)
         ->assertHeadersExist(array(
            "X-GitHub-Request-Id",
            "ETag"
         ))
         ->assertHeaders(array(
            "Server" => "GitHub.com"
         ))
         ->assertBody("IS_VALID_JSON")
         ->assertTotalTimeLessThan(2);

$httpRequest = WsHttpRequest::create();
$httpResponse = $httpRequest->get("https://freegeoip.net/json/8.8.8.8");
$watcher = WsHttpWatcher::create($httpResponse);

$watcher
         ->assertStatusCode(200)
         ->assertHeadersExist(array(
            "Content-Length"
         ))
         ->assertHeaders(array(
            "Access-Control-Allow-Origin" => "*"
         ))
         ->assertBodyJsonFile(dirname(__DIR__) . "/tests/Ws/Http/_json/freegeoip.net.json");

查看所有例子(See the full examples) https://github.com/toohamster...

云服務器 GPU云服務器 php最簡單最簡單的算法最簡單的爬蟲最簡單的webrtc

文章版權歸作者所有，未經允許請勿轉載,若此文章存在違規行為，您可以聯系管理員刪除。

轉載請注明本文地址：http://specialneedsforspecialkids.com/yun/21854.html

PHP 開發者應了解的 24 個庫

摘要：下面是一個例子這個庫要求你至少安裝了和其中的一個，這可能意味著，在大多數主機提供商提供的主機上它可能用不了。借助它，你可以忘記如何書寫乏味的有一個姊妹庫叫，是一個基于的實現。 showImg(http://segmentfault.com/img/bVbJml); 作為一個PHP開發者，現在是一個令人激動的時刻。每天有許許多多有用的庫分發出來，在 Github 上很容易發現和使用這些庫...

0x584a 2019-06-27 10:31 評論0 收藏0
Ubuntu 14.04 VPS 部署 PHP 環境及 WordPress

摘要：軟件及版本選擇是目前用戶數量數一數二的發行版，背后有大土豪維護，可以說是輕量級用戶的最佳選擇。而是目前最新的版本，目前已經發布了半年了，基本是目前支持最好的版本。是目前官方推薦的最佳的運行模式。軟件及版本選擇 Ubuntu 14.04 Ubuntu 是目前用戶數量數一數二的發行版，背后有大土豪維護，可以說是輕量級用戶的最佳選擇。而 14.04 是目前最新的 LTS 版本，目前...

Pluser 2019-06-27 10:51 評論0 收藏0
PHP編譯參數configure配置詳解(持續更新中)

摘要：編譯參數使用在源代碼目錄中，該命令可以查看所有編譯參數以及對應的英文解釋編譯參數說明指定安裝目錄整合指定位置指定額外拓展配置歸放處文件夾打開安全模式打開的支持打開對的支持打開對編譯參數-使用 ./configure -h在源代碼目錄中，該命令可以查看所有編譯參數以及對應的英文解釋編譯參數-說明 --prefix=/opt/php //指定 ...

hlcc 2019-07-01 10:18 評論0 收藏0
PHP編譯參數configure配置詳解(持續更新中)

摘要：編譯參數使用在源代碼目錄中，該命令可以查看所有編譯參數以及對應的英文解釋編譯參數說明指定安裝目錄整合指定位置指定額外拓展配置歸放處文件夾打開安全模式打開的支持打開對的支持打開對編譯參數-使用 ./configure -h在源代碼目錄中，該命令可以查看所有編譯參數以及對應的英文解釋編譯參數-說明 --prefix=/opt/php //指定 ...

Lyux 2019-05-28 17:09 評論0 收藏0

發表評論

登陸后可評論

0條評論

zengdongbao

男|高級講師

我要關注我要私信

TA的文章

基于ARM處理器的U-BOOT詳細移植總結

閱讀 3965·2021-10-09 09:43
重新科學學音標-區別式學舌位（靠感覺和想象）

閱讀 2878·2021-10-08 10:05
ZJI：香港阿里云專線獨立服務器，最高立減400元，E5-2630L/16G/月付450元

閱讀 2737·2021-09-08 10:44
白淺教你CSS的垂直居中方法

閱讀 887·2019-08-30 15:52
UCloud云主機CentOS KPTI關閉方法

閱讀 2815·2019-08-26 17:01
代碼注釋的藝術，再也不怕被說代碼可讀性差啦！

閱讀 3021·2019-08-26 13:54
56 道高頻 JavaScript 與 ES6+ 的面試題及答案

閱讀 1655·2019-08-26 10:48
前端常用代碼片段(六)

閱讀 814·2019-08-23 14:41

国产xxxx99真实实拍_久久不雅视频_高清韩国a级特黄毛片_嗯老师别我我受不了了小说

資訊專欄INFORMATION COLUMN

上云采購季！| 2核2G4M爆款云服務器低至59元/年，更有多臺、長期優惠，快來選購！

最簡單輕量的PHP CURL工具庫 ws-http

代理授權驗證 (Proxy Authenticaton)

例子(Examples)

相關文章

PHP 開發者應了解的 24 個庫

**Ubuntu 14.04 VPS 部署 PHP 環境及 WordPress**

PHP編譯參數configure配置詳解(持續更新中)

PHP編譯參數configure配置詳解(持續更新中)

發表評論

0條評論

zengdongbao

男|高級講師

TA的文章

基于ARM處理器的U-BOOT詳細移植總結

重新科學學音標-區別式學舌位（靠感覺和想象）

ZJI：香港阿里云專線獨立服務器，最高立減400元，E5-2630L/16G/月付450元

白淺教你CSS的垂直居中方法

UCloud云主機CentOS KPTI關閉方法

代碼注釋的藝術，再也不怕被說代碼可讀性差啦！

56 道高頻 JavaScript 與 ES6+ 的面試題及答案

前端常用代碼片段(六)

最新活動

資訊專欄INFORMATION COLUMN

上云采購季！| 2核2G4M爆款云服務器低至59元/年，更有多臺、長期優惠，快來選購！

最簡單輕量的PHP CURL工具庫 ws-http

代理授權驗證 (Proxy Authenticaton)

例子(Examples)

相關文章

發表評論

0條評論

男|高級講師

TA的文章

最新活動

上云采購季！| 2核2G4M爆款云服務器低至59元/年，更有多臺、長期優惠，快來選購！