README

Guzzle Http Signature 插件是 node-http-signature 模块的 PHP 5.3 版本。它允许您使用签名认证方案简单地签名 HTTP 头部。

注意，它仅实现客户端部分（签名创建），并没有实现服务器部分（签名解析和验证）。

有关此处使用的“签名认证方案”的更多信息，请参阅 http_signing.md。

支持算法

目前仅支持 'hmac-sha1', 'hmac-sha256', 'hmac-sha512' 算法。

入门（通过 Composer）

推荐通过 Composer 安装 guzzle-http-signature。

在您的项目 composer.json 文件中添加以下依赖项，然后使用 php composer.phar install 命令安装。
```
{
	"require": {
		"guzzle/guzzle": "2.*",
		"dchapkine/guzzle-http-signature": "dev-master"
	}
}
```

使用它

<?php

require_once 'vendor/autoload.php';

use Guzzle\Http\Client;
use Guzzle\Http\Exception\ClientErrorResponseException;
use Guzzle\Http\Exception\BadResponseException;
use GuzzleHttpSignature\HttpSignaturePlugin;
use Guzzle\Http\Exception\CurlException;



//
// request config
//
$requestUrl = 'https://api.domain.tld/jobs/44';
$requestMethod = 'POST';
$requestData = array("some" => array("custom" => array("data")));
$requestHeaders = array('content-md5' => md5(http_build_query($requestData)));


//
// signature config
//
$keyId = "Test";			// your key id
$key = "secret";			// your private key
$algorithm = "hmac-sha512";	// algorithm: hmac-sha1, hmac-sha256, hmac-sha512
$headersToSign = array(		// headers we want to include into signature
	"date",
	"content-md5"
);


//
// sending request
//
try
{
	$plugin = new HttpSignaturePlugin(array(
		'keyId' => $keyId,
		'key' => $key,
		'algorithm' => $algorithm,
		'headers' => $headersToSign
	));
	
	$client = new Client();
	$client->addSubscriber($plugin);
	$req = $client->createRequest($requestMethod, $requestUrl, $requestHeaders, $requestData);
	$response = $req->send();
}
catch (ClientErrorResponseException $e)
// guzzle throws ClientErrorResponseException when error http codes are sent (401, 500, ...)
{
	$response = $e->getResponse();
}
catch (CurlException $e)
// the api provider is probably down or there is an issue with connection
{
	$msg = $e->getMessage();
}


//
// print response
//
header('Content-Type: text');
if (isset($response))
	echo "\n" . $response->getStatusCode() . "\n" . $response->getBody(true) . "\n";
else
	echo $msg."\n";

链接

@see https://github.com/joyent/node-http-signature/blob/master/http_signing.md

@see http://joyent.com/blog/a-bit-more-about-the-new-joyent-cloud-api/

dchapkine/ guzzle-http-signature

维护者

详细信息

README

支持算法

入门（通过 Composer）

链接