php安裝HTTP_Request2及引用介紹(通過HTTP_Request創建微軟人臉識別的羣組 爲例)

Easy Install

pear install HTTP_Request2

Pyrus Install

php pyrus.phar install pear/HTTP_Request2

出現下列信息則表示安裝成功

pear/HTTP_Request2 can optionally use PHP extension "fileinfo"
downloading HTTP_Request2-2.3.0.tgz ...
Starting to download HTTP_Request2-2.3.0.tgz (119,717 bytes)
..........................done: 119,717 bytes
downloading Net_URL2-2.2.1.tgz ...
Starting to download Net_URL2-2.2.1.tgz (20,010 bytes)
...done: 20,010 bytes
install ok: channel://pear.php.net/Net_URL2-2.2.1
install ok: channel://pear.php.net/HTTP_Request2-2.3.0(摘取天上星:分享每個人都能看懂的實例)

如果出現類似如下紅色部分信息，則需要修改php.ini配置文件打開被禁用的相應函數(去掉disable_functions中的popen,readlink)即可，總之提示那個函數錯誤開啓那個函授即可！

disable_functions=eval,passthru,exec,system,chroot,chgrp,chown,shell_exec,ini_alter,ini_restore,dl,openlog,syslog,symlink,popepassthru,fsocket,stream_socket_server,readlink,popen

Warning: popen() has been disabled for security reasons in OS/Guess.php on line 241
PHP Warning:  popen() has been disabled for security reasons in /usr/local/php/lib/php/OS/Guess.php on line 241

Warning: fgets() expects parameter 1 to be resource, null given in OS/Guess.php on line 242
PHP Warning:  fgets() expects parameter 1 to be resource, null given in /usr/local/php/lib/php/OS/Guess.php on line 242

Warning: pclose() expects parameter 1 to be resource, null given in OS/Guess.php on line 251
PHP Warning:  pclose() expects parameter 1 to be resource, null given in /usr/local/php/lib/php/OS/Guess.php on line 251

Warning: readlink() has been disabled for security reasons in OS/Guess.php on line 257
PHP Warning:  readlink() has been disabled for security reasons in /usr/local/php/lib/php/OS/Guess.php on line 257
pear/HTTP_Request2 can optionally use PHP extension "fileinfo"
downloading HTTP_Request2-2.3.0.tgz ...
Starting to download HTTP_Request2-2.3.0.tgz (119,717 bytes)
..........................done: 119,717 bytes
downloading Net_URL2-2.2.1.tgz ...
Starting to download Net_URL2-2.2.1.tgz (20,010 bytes)
...done: 20,010 bytes
install ok: channel://pear.php.net/Net_URL2-2.2.1
install ok: channel://pear.php.net/HTTP_Request2-2.3.0

php中調用實例(直接引用即可)以下爲微軟人臉識別API實例，具體需要修改爲自己的key密鑰(此處僅僅介紹php引入HTTP_Request方法即直接引入即可)

<?php  error_reporting(255);
// This sample uses the Apache HTTP client from HTTP Components (http://hc.apache.org/httpcomponents-client-ga/)
include('HTTP/Request2.php');

//add 2017-02-07 subscription key
$key1 = 'xxxxxxx'; //在微軟人臉識別處註冊的賬戶對應的face應用api key
//add 2017-02-07 personGroupId
$group_id = 'school_1';

$request = new Http_Request2("https://westus.api.cognitive.microsoft.com/face/v1.0/persongroups/{$group_id}");
$url = $request->getUrl();

########################################################################################
# 記得一定要關閉證書驗證，否則會出現如下證書驗證失敗的錯誤提示
/*
Fatal error: Uncaught
HTTP_Request2_ConnectionException: Unable to connect to tls://westus.api.cognitive.microsoft.com:443.
Error: stream_socket_client(): unable to connect to tls://westus.api.cognitive.microsoft.com:443 (Unknown error)
stream_socket_client(): Failed to enable crypto stream_socket_client(): SSL operation failed with code 1.
OpenSSL Error messages: error:14090086:SSL routines:SSL3_GET_SERVER_CERTIFICATE:
certificate verify failed in /usr/local/php/lib/php/HTTP/Request2/Adapter/Socket.php on line 332
*/
########################################################################################
$request->setConfig(['ssl_verify_peer'=>FALSE,'ssl_verify_host'=>FALSE]);
########################################################################################

$headers = array(
    // Request headers
    'Content-Type' => 'application/json',
    'Ocp-Apim-Subscription-Key' => $key1,
);

$request->setHeader($headers);

$parameters = array(
    // Request parameters
 'personGroupId'=>$group_id
);

$url->setQueryVariables($parameters);

$request->setMethod(HTTP_Request2::METHOD_PUT);

// Request body
// add body
$body = '{"name":"group1", "userData":"group1 userData test"}';
$request->setBody("{$body}");

try
{
    $response = $request->send();
    echo $response->getBody();
}
catch (HttpException $ex)
{
    echo $ex;
}

?>

以下是通過HTTP_Request創建人臉識別羣組操作成功與否返回的提示信息(出現如下狀態信息，就說明HTTP_Request成功請求了人臉識別接口，到此HTTP_REQUEST2的使用介紹完畢)

Response 200

A successful call returns an empty response body.

Response 400

Error code and message returned in JSON:

Error Code	Error Message Description
BadArgument	'name' is too long.
BadArgument	'userData' is too long.
BadArgument	Bad and unrecognizable JSON body.
BadArgument	Person group ID is invalid. Valid format should be a string composed by numbers, English letters in lower case, '-', '_', and no longer than 64 characters.

• application/json

{
    "error":{
        "code":"BadArgument",
        "message":"'name' is too long."
    }
}

Response 401

Error code and message returned in JSON:

Error Code	Error Message Description
Unspecified	Invalid subscription Key or user/plan is blocked.

• application/json

{
    "error":{
        "code": "Unspecified",
        "message": "Access denied due to invalid subscription key. Make sure you are subscribed to an API you are trying to call and provide the right key."
    }
}

Response 403

• application/json

{
    "error":{
        "statusCode": 403,
        "message": "Out of call volume quota. Quota will be replenished in 2.12 days."
    }
}

Response 409

Error code and message returned in JSON:

Error Code	Error Message Description
PersonGroupExists	Person group already exists.
ConcurrentOperationConflict	Concurrent operation conflict on resource.

• application/json

{
    "error":{
        "code":"PersonGroupExists",
        "message":"Person group 'sample_group' already exists."
    }
}

Response 415

Unsupported media type error. Only "application/json" is valid for this API.

• application/json

{
    "error":{
        "code":"BadArgument",
        "message":"Invalid Media Type"
    }
}

Response 429

• application/json

{
    "error":{
        "statusCode": 429,
        "message": "Rate limit is exceeded. Try again in 26 seconds."
    }
}

這裏僅僅對HTTP_Request的安裝和引用做下簡單介紹，詳細人臉識別部分會在後期出專門的技術文檔教材出來，敬請關注...