【PHP類庫】Requests - A humble HTTP request library

animabear 發(fā)布于2019-06-27 11:15 / 1257人閱讀

摘要：相對于等類庫來說，它具有簡單易用且友好的，且不依賴于。它支持和等方法，基本能滿足任何形式的請求。不依賴于任何標(biāo)準(zhǔn)庫外的擴(kuò)展，唯一的要求就是需要的版本。原始的響應(yīng)數(shù)據(jù)。標(biāo)識請求是否成功。

Requests是一個PHP的HTTP類庫。相對于cURL等類庫來說，它具有簡單易用且友好的API，且不依賴于cURL。它支持HEAD、 GET、 POST、 PUT、 DELETE和PATCH等方法，基本能滿足任何形式的HTTP請求。

Requests不依賴于任何PHP標(biāo)準(zhǔn)庫外的擴(kuò)展，唯一的要求就是需要PHP5.2+的版本。但是如果PHP的cURL可用，Requests會優(yōu)先使用它，否則會使用socket。

安裝和使用 通過Composer安裝

{
    "require": {
        "rmccue/requests": ">=1.0"
    },
    "autoload": {
        "psr-0": {"Requests": "library/"}
    }
}

自動加載

可以使用Composer的加載器：

phpinclude("/path/to/composer/vendor/autoload.php");

也可以使用Requests自帶的：

phpinclude("/path/to/library/Requests.php");

Requests::register_autoloader();

各種請求 GET請求

php$response = Requests::get("http://httpbin.org/get");

POST請求

php$response = Requests::post("http://httpbin.org/post");

需要傳數(shù)據(jù)的話，可以使用第三個參數(shù)：

php$data = array("key1" => "value1", "key2" => "value2");
$response = Requests::post("http://httpbin.org/post", array(), $data);

如果需要傳原始數(shù)據(jù)的話，第三個參數(shù)請傳字符串。
其他請求
其他請求方法都大同小異：

php$response = Requests::put("http://httpbin.org/put");

$response = Requests::delete("http://httpbin.org/delete");

$response = Requests::patch("http://httpbin.org/patch", array("If-Match" => "e0023aa4e"));

$response = Requests::head("http://httpbin.org/headers");

需要注意的是equests::patch()方法的第二個參數(shù)為必傳。
Requests::request()方法
看API文檔，你會發(fā)現(xiàn)這些方法接受的參數(shù)幾乎一樣：$url，$headers，$data（只有POST、PUT和PATCH有），$options。事實(shí)上它們只是對Requests::request()方法進(jìn)行了一次封裝：

php/**
 * Send a GET request
 */
public static function get($url, $headers = array(), $options = array()) {
    return self::request($url, $headers, null, self::GET, $options);
}

/**
 * Send a HEAD request
 */
public static function head($url, $headers = array(), $options = array()) {
    return self::request($url, $headers, null, self::HEAD, $options);
}

/**
 * Send a DELETE request
 */
public static function delete($url, $headers = array(), $options = array()) {
    return self::request($url, $headers, null, self::DELETE, $options);
}

/**
 * Send a POST request
 */
public static function post($url, $headers = array(), $data = array(), $options = array()) {
    return self::request($url, $headers, $data, self::POST, $options);
}

/**
 * Send a PUT request
 */
public static function put($url, $headers = array(), $data = array(), $options = array()) {
    return self::request($url, $headers, $data, self::PUT, $options);
}

$header允許我們自定義請求頭，例如POST方法的話，我們通常需要指定Content-Type，使服務(wù)器知道我們正在發(fā)送的的數(shù)據(jù)是什么格式：

php$url = "https://api.github.com/some/endpoint";
$headers = array("Content-Type" => "application/json");
$data = array("some" => "data");
$response = Requests::post($url, $headers, json_encode($data));

$options允許我們對請求進(jìn)行配置，例如超時時間：

php$options = array(
    "timeout" => 5
);
$response = Requests::get("https://httpbin.org/", array(), $options);

更多的選項(xiàng)配置請看：http://requests.ryanmccue.info/api/source-class-Requests.html#_request

Requests里所有的請求方法（HEAD、 GET、 POST、 PUT、 DELETE和PATCH）返回的都是一個Requests_Response對象，這個對象包含了響應(yīng)的各種信息：

$body：響應(yīng)體。

$raw：原始的HTTP響應(yīng)數(shù)據(jù)。

$headers：響應(yīng)頭。

$status_code：狀態(tài)碼。

$success：標(biāo)識請求是否成功。

$redirects：請求的重定向次數(shù)。

$url：請求的URL。

$history：請求的歷史記錄。

$cookies：cookie信息。

更多Requests_Response的信息請看：http://requests.ryanmccue.info/api/source-class-Requests.html#_request

Session處理
當(dāng)你需要對同一網(wǎng)站發(fā)出多個請求，那么Requests_Session對象可以幫到輕易的設(shè)置一些默認(rèn)參數(shù)：

php$url = "https://api.github.com/";
$header = array("X-ContactAuthor" => "rmccue");
$data = array();
$options = array("useragent" => "My-Awesome-App");
$session = new Requests_Session($url, $header, $data, $options);

$response = $session->get("/zen");

Requests_Session的構(gòu)造函數(shù)接受url、headers、data和options這4個參數(shù)，順序跟Requests::request()方法一致。同時你也可以通過訪問屬性的方式去修改options參數(shù)：

php// 設(shè)置option屬性
$session->useragent = "My-Awesome-App";

// 跟上面的作用一致
$session->options["useragent"] = "My-Awesome-App";

更多Requests_Session的信息請看：http://requests.ryanmccue.info/api/source-class-Requests_Session.html
HTTPS請求
Requests會默認(rèn)幫忙處理HTTPS請求，就跟在瀏覽器訪問HTTPS網(wǎng)站一樣：

php$response = Requests::get("https://httpbin.org/");

但是如果你想使用其他的證書或者自簽證書，你可以指定證書文件（PEM格式）：

php$options = array(
    "verify" => "/path/to/cacert.pem"
);
$response = Requests::get("https://httpbin.org/", array(), $options);

如果你想禁用HTTPS的驗(yàn)證，可以通過設(shè)置options："verify" => false。
HTTP基本驗(yàn)證
HTTP基本驗(yàn)證功能可以通過options的auth實(shí)現(xiàn)：

php$options = array(
    "auth" => array("user", "password")
);
Requests::get("http://httpbin.org/basic-auth/user/password", array(), $options);

進(jìn)階使用 使用代理
代理可以通過options的proxy實(shí)現(xiàn)：

php$options = array(
    "proxy" => "127.0.0.1:3128"
);
Requests::get("http://httpbin.org/ip", array(), $options);

如果代理需要驗(yàn)證：

php$options = array(
    "proxy" => array( "127.0.0.1:3128", "my_username", "my_password" )
);
Requests::get("http://httpbin.org/ip", array(), $options);

鉤子
通過Requests的鉤子系統(tǒng)，我們可以通過注冊自己的鉤子去擴(kuò)展Requests的功能：

php$hooks = new Requests_Hooks();
$hooks->register("requests.after_request", "mycallback");

$request = Requests::get("http://httpbin.org/get", array(), array("hooks" => $hooks));

Request提供的鉤子請看：http://requests.ryanmccue.info/docs/hooks.html

自定義驗(yàn)證
通過實(shí)現(xiàn)Requests_Auth接口，我們可以為請求添加自定義的驗(yàn)證。假設(shè)服務(wù)器會檢查HTTP請求里的Hotdog請求頭的值是不是為Yummy。我們先實(shí)現(xiàn)我們的驗(yàn)證類：

phpclass MySoftware_Auth_Hotdog implements Requests_Auth {
    protected $password;

    public function __construct($password) {
        $this->password = $password;
    }

    public function register(Requests_Hooks &$hooks) {
        $hooks->register("requests.before_request", array(&$this, "before_request"));
    }

    public function before_request(&$url, &$headers, &$data, &$type, &$options) {
        $headers["Hotdog"] = $this->password;
    }
}

可以看到，類實(shí)現(xiàn)了Requests_Auth接口，同時代碼實(shí)現(xiàn)也用到了鉤子。下面我們通過options的auth去調(diào)用我們的自定義驗(yàn)證：

php$options = array(
    "auth" => new MySoftware_Auth_Hotdog("yummy")
);
$response = Requests::get("http://hotdogbin.org/admin", array(), $options);

Why Requests？
文章開始提到了Requests的一些優(yōu)點(diǎn)，這個官網(wǎng)有個專門的頁面進(jìn)行詳細(xì)的介紹，同時還提到了Requests跟其他類似類庫的對比。通過這個對比，大家對Requests會有進(jìn)一步的認(rèn)識，同時也科普下還有哪些HTTP請求相關(guān)的類庫。
請猛擊：http://requests.ryanmccue.info/docs/why-requests.html
參考
http://requests.ryanmccue.info/

GPU云服務(wù)器云服務(wù)器 requests requests請求 max_requests python的requests安裝

文章版權(quán)歸作者所有，未經(jīng)允許請勿轉(zhuǎn)載,若此文章存在違規(guī)行為，您可以聯(lián)系管理員刪除。

轉(zhuǎn)載請注明本文地址：http://m.specialneedsforspecialkids.com/yun/20964.html

上一篇：Yii 里面直接執(zhí)行sql語句

下一篇：Zephir－－最簡單的php擴(kuò)展開發(fā)工具

相關(guān)文章

CodeIgniter框架中抽取部分類庫做問題追蹤的思路

摘要：背景由于各種原因，沒有接入完整的調(diào)用鏈追蹤，。顯然，有基本的操作。抽取整個對象的所有對象實(shí)例隊(duì)列中的結(jié)果不足框架中不可避免的使用了操作，或者其他業(yè)務(wù)代碼中也使用。這樣導(dǎo)致鉤子函數(shù)無法正常完成他的使用。背景由于各種原因，沒有接入完整的調(diào)用鏈追蹤，(┬＿┬)。但是我們自身再通過php的curl調(diào)用各端接口時，會請求多次。那么有沒有一種方法可以在不植入業(yè)務(wù)代碼的前提下，捕捉到這些curl...

沈儉 2019-07-01 12:43 評論0 收藏0

各開源框架使用與設(shè)計(jì)總結(jié)（三）

摘要：總結(jié)了框架與架構(gòu)的區(qū)別。站在框架之外，看框架，看框架的共同特征與功用。由于框架所帶來的問題，以性能可擴(kuò)展問題，相對嚴(yán)重，所以分析性能的改造方向，總結(jié)了六大點(diǎn)。包括框架介紹，的使用，以及。六、各項(xiàng)實(shí)踐，性能評測下面進(jìn)入性能評測，評測我們相對就比較快速一些。直接用ab命令，來測試上面的所提及的一些改進(jìn)。以下評測，所有測試頁面，均為：http://hjvote.app.ucai.cn/...

objc94 2019-06-27 10:46 評論0 收藏0

PHP｜標(biāo)準(zhǔn)配置之php-fpm.conf

摘要： ;;;;;;;;;;;;;;;;;;;;; ; FPM Configuration ; ;;;;;;;;;;;;;;;;;;;;; ; All relative paths in this configuration file are relative to PHPs install ; prefix (/usr/local/php). This prefix can be dyn...

wfc_666 2019-06-27 13:54 評論0 收藏0

PHP 7 新特征

摘要：本次發(fā)布標(biāo)志著新的重要的系列的開始。經(jīng)過社區(qū)投票，新項(xiàng)目命名為。結(jié)果如下結(jié)果如下四新特性標(biāo)量類型聲明有兩種模式強(qiáng)制默認(rèn)和嚴(yán)格模式。已廢棄的和函數(shù)已被移除。在中，如果發(fā)生這種情況，會引發(fā)錯誤，并且返回。最好的語言發(fā)布了新的版本，一個劃時代的大版本：PHP7。 PHP7修復(fù)了大量BUG，新增了功能和語法糖。這些改動涉及到了核心包、GD庫、PDO、ZIP、ZLIB等熟悉和不熟悉的核心功能與...

Channe 2019-07-01 12:21 評論0 收藏0

TP5學(xué)習(xí)記錄（Controller篇）

摘要：可以在入口文件中定義，然后新建文件夾，達(dá)到將應(yīng)用配置放到該文件的目的，這樣方便將配置進(jìn)行統(tǒng)一管理。動態(tài)配置返回?cái)?shù)據(jù)類型功能同上張三男請求成功 ThinkPHP5 ThinkPHP是一個免費(fèi)開源的、快速簡單的、面向?qū)ο蟮摹⑤p量級PHP開發(fā)框架。為什么選擇ThinkPHP5？ ThinkPHP5采用了全新的架構(gòu)思想; 優(yōu)化了核心是一個顛覆性的版本; 支持composer方式安裝; 對...

leone 2019-07-01 10:03 評論0 收藏0

發(fā)表評論

登陸后可評論

0條評論

animabear

男|高級講師

我要關(guān)注我要私信

TA的文章
閱讀更多

conda卸載tensorflow

閱讀 2805·2023-04-25 18:06

無線網(wǎng)絡(luò)技術(shù)學(xué)習(xí)總結(jié)

閱讀 2594·2021-11-22 09:34

盤點(diǎn) GitHub 2021年度盛會｜附視頻

閱讀 1693·2021-11-08 13:16

幾種典型的智慧農(nóng)業(yè)物聯(lián)網(wǎng)解決方案

閱讀 1317·2021-09-24 09:47

前端面試每日 3+1 —— 第135天

閱讀 3058·2019-08-30 15:44

web 多屏互動顯示方案

閱讀 2783·2019-08-29 17:24

echarts 游客來源

閱讀 2594·2019-08-23 18:37

由一道題引申出的事件循環(huán)、letvar用法、iife、塊級作用域

閱讀 2445·2019-08-23 16:55

最新活動

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

資訊專欄INFORMATION COLUMN

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

【PHP類庫】Requests - A humble HTTP request library

相關(guān)文章

CodeIgniter框架中抽取部分類庫做問題追蹤的思路

各開源框架使用與設(shè)計(jì)總結(jié)（三）

PHP｜標(biāo)準(zhǔn)配置之php-fpm.conf

PHP 7 新特征

TP5學(xué)習(xí)記錄（Controller篇）

發(fā)表評論

0條評論

animabear

男|高級講師

TA的文章

conda卸載tensorflow

無線網(wǎng)絡(luò)技術(shù)學(xué)習(xí)總結(jié)

盤點(diǎn) GitHub 2021年度盛會｜附視頻

幾種典型的智慧農(nóng)業(yè)物聯(lián)網(wǎng)解決方案

前端面試每日 3+1 —— 第135天

web 多屏互動顯示方案

echarts 游客來源

由一道題引申出的事件循環(huán)、letvar用法、iife、塊級作用域

最新活動