README

此包不再维护

请检查 phplicengine/bitly 作为可能的替代方案。

基于 Guzzle 的 PHP 库，用于消费 Bit.ly API。

使用 Guzzle 的最大优点是可以轻松地将 Guzzle 插件附加到您的客户端。例如，您可以在这里看到如何附加日志插件并将所有请求写入文件。

还提供了与 Symfony2 的集成。

版本

分支 master 遵循 psr4 标准，并带有 2.x 标签
分支 psr0 当然遵循 psr0 标准，并带有 1.x 标签 - 只有错误修复，没有新功能

此项目遵循语义版本控制。

安装

安装此库的推荐方式是通过 Composer。有关 Composer 及其安装信息，请查看此处。

新项目

从命令行运行

./composer create-project hpatoio/bitly-api your_prj_dir '~2.0'

现有项目

移动到您的项目目录并运行

./composer require hpatoio/bitly-api '~2.0'

或将其添加到您的 composer.json

{
    ...
    "require": {
        ...
        "hpatoio/bitly-api": "~2.0"
    }
}

然后运行

./composer update

用法

<?php

// This file is generated by Composer
require_once 'vendor/autoload.php';

# To find your bitly access token see here https://bitly.com/a/oauth_apps
$my_bitly = new \Hpatoio\Bitly\Client("insert_here_your_bitly_api_access_token");

$response = $my_bitly->Highvalue(array("limit" => 3));

print_r($response);

cURL 选项

可能 bit.ly 不可达，您想设置特定的超时。只需在客户端设置 cURL 超时选项即可。


$my_bitly = new \Hpatoio\Bitly\Client("insert_here_your_bitly_api_access_token");
// set cURL timeout, you can specify any cURL options
$my_bitly->setConfig(array(
    'curl.options' => 
        array(
            CURLOPT_TIMEOUT => 2, 
            CURLOPT_CONNECTTIMEOUT => 2
        )
    ));

$response = $my_bitly->Highvalue(array("limit" => 3));

print_r($response);

方法名称

要获取方法名称，请从 API URL 中删除 "v3"，并将其他单词转换为驼峰式，删除斜杠。

示例

/v3/highvalue -> Highvalue
/v3/realtime/hot_phrases -> RealtimeHot_phrases
/v3/link/content -> LinkContent

可用方法

目前库支持以下 API

Behat

您需要复制 Behat 默认配置文件，并在其中输入 access_token 选项。

$ cp behat.yml.dist behat.yml

现在打开 behat.yml，并将字符串 your_bitly_access_token_here 替换为您的访问令牌。运行套件时，请输入

$ bin/behat

集成

一个集成此库的 Symfony2 扩展包可在这里获取

附加 Guzzle 插件

在这里您可以查看如何将 Guzzle 日志插件附加到您的客户端，并将所有请求保存到文件中。

注意：要运行此脚本，您需要 monolog/monolog

<?php
// This file is generated by Composer
require_once 'vendor/autoload.php';

use Guzzle\Log\MessageFormatter;
use Guzzle\Log\MonologLogAdapter;
use Guzzle\Plugin\Log\LogPlugin;
use Monolog\Handler\StreamHandler;
use Monolog\Logger;

$logger = new Logger('client');
$logger->pushHandler(new StreamHandler('/tmp/bitly_guzzle.log'));
$adapter = new MonologLogAdapter($logger);
$logPlugin = new LogPlugin($adapter, MessageFormatter::DEBUG_FORMAT);

# To find your bitly access token see here https://bitly.com/a/oauth_apps
$my_bitly = new \Hpatoio\Bitly\Client("your_bitly_access_token");
$my_bitly->addSubscriber($logPlugin);

$response = $my_bitly->Highvalue(array("limit" => 3));

print_r($response);

现在您可以在 /tmp/bitly_guzzle.log 中查看所有请求。

hpatoio / bitly-api

维护者

详细信息