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 CodeError Message DescriptionBadArgument'name' is too long.BadArgument'userData' is too long.BadArgumentBad and unrecognizable JSON body.BadArgumentPerson 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 CodeError Message DescriptionUnspecifiedInvalid 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 CodeError Message DescriptionPersonGroupExistsPerson group already exists.ConcurrentOperationConflictConcurrent 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的安装和引用做下简单介绍，详细人脸识别部分会在后期出专门的技术文档教材出来，敬请关注...