purplecode/pcurl

CURL包装器,适用于PHP >= 5.3

dev-master 2015-08-03 12:11 UTC

This package is not auto-updated.

Last update: 2024-09-24 01:46:09 UTC


README

PCurl 是一个用于RESTful Web服务的PHP客户端库。

PCurl支持GET/POST/PUT/DELETE请求方法。与其他类似库不同,它还支持HTTPS证书验证。

Composer安装

要安装PCurl,请使用以下composer require语句

{
    "require": {
        "purplecode/pcurl": "dev-master"
    }
}

或者直接复制粘贴src/目录下的内容到您的libs目录。

使用方法

PCurl.php

简单的GET请求

$pcurl = new PCurl('http://www.google.pl');
$response = $pcurl->get('/')->getBody();

通过HTTPS进行简单的GET请求并验证证书(更多示例在测试包中)

$pcurl = new PCurl('https://www.google.pl');
$pcurl->useSSLCertificate(<path to crt/pem file>);
$response = $pcurl->get('/')->getBody();

以及一个不进行证书验证的类似示例

$pcurl = new PCurl('https://www.google.pl');
$pcurl->ignoreSSLCertificate();
$response = $pcurl->get('/')->getBody();

示例POST请求

$pcurl = new PCurl('http://some.fancy.page');
$pcurl->proxy(host, port);
$pcurl->auth(user, pass);
$pcurl->header('Cache-Control: no-cache');
$pcurl->contentType('application/xml');
$response = $pcurl->post('/igipigiel/xml', '<a>makapaka</a>')->getBody();

PJsonCurl.php

与PCurl类似的类,唯一的不同是输入/输出通过json_encode/json_decode进行传递。

$pcurl = new PJsonCurl('http://www.app.com/json');
$response = $pcurl->put('/', array('a' => 'b'));
echo $response->getBody()['c'];

PObjectCurl.php

与PJsonCurl类似的类,不同之处在于输入/输出通过serialize/deserialize方法进行传递。需要JMS\Serializer库或JMSSerializerBundle Symfony2扩展包。

$pcurl = new PObjectCurl('http://www.prettifier.com/json', JMS\Serializer\SerializerInterface $serializer);
$pcurl->responseClass('My\App\Preety');
$uglyObject =  new My\App\Ugly();
$preetyObject = $pcurl->put('/', $uglyObject)->getBody();

祝您使用愉快!