$ curl -O http://pear.php.net/go-pear.phar
$ php go-pear.phar

パイプでつなぐとreadlineがうまくいかないので別で実行。
ユーザー環境にインストールしようとするのでそのままEnter

~/pear/bin/pear help

TwitPic Developers – API Documentation – API v2 » upload

v2ではtwitterとOAuth認証で利用するヘッダを「X-Verify-Credentials-Authorization」として、リクエストURIを「X-Auth-Service-Provider」としてヘッダに含めることでAPIを利用できるようになりました。

以下、PEAR::HTTP_Request2とPEAR::HTTP_OAuthを利用したサンプル。

<?php
require_once 'HTTP/OAuth/Consumer.php';

define('OAUTH_CONSUMER_KEY',    'xxxx');
define('OAUTH_CONSUMER_SECRET', 'xxxx');
define('OAUTH_TOKEN',           'xxxx');
define('OAUTH_TOKEN_SECRET',    'xxxx');
define('TWITPIC_KEY',           'xxxx');

try {

  $consumer_request = new HTTP_OAuth_Consumer_Request();
  $consumer_request->accept(new HTTP_Request2());

  $consumer = new HTTP_OAuth_Consumer(OAUTH_CONSUMER_KEY,
                                      OAUTH_CONSUMER_SECRET,
                                      OAUTH_TOKEN,
                                      OAUTH_TOKEN_SECRET);
  $consumer->accept($consumer_request);
  $resp = $consumer->sendRequest('https://api.twitter.com/1/account/verify_credentials.json', array(), HTTP_Request2::METHOD_GET);

  $headers = $consumer->getLastRequest()->getHeaders();

  $http_request = new HTTP_Request2();
  $http_request->setHeader('X-Auth-Service-Provider', 'https://api.twitter.com/1/account/verify_credentials.json');
  $http_request->setHeader('X-Verify-Credentials-Authorization', $headers['authorization']);
  $http_request->setUrl('http://api.twitpic.com/2/upload.json');
  $http_request->setMethod(HTTP_Request2::METHOD_POST);
  $http_request->addPostParameter('key', TWITPIC_KEY);
  $http_request->addPostParameter('message', 'test');
  $http_request->addUpload('media', '/path/to/image');
  $resp = $http_request->send();
  $body = $resp->getBody();
  $body = json_decode($body);

  var_dump($body);

} catch (Exception $e) {

  var_dump($e->getMessage());

}

twitterとのOAuth認証に必要なAuthorizationヘッダを生成するだけでよいので、実際はtwitter側にリクエストする必要はないのですが、ソース読んだところいろいろ面倒なのでとりあえずこんな形で。

Methods with the same name as the last element of a namespaced class name will no longer be treated as constructor. This change doesn’t affect non-namespaced classes.

<?php
namespace Foo;
class Bar {
    public function Bar() {
        // treated as constructor in PHP 5.3.0-5.3.2
        // treated as regular method in PHP 5.3.3
    }
}
?>

There is no impact on migration from 5.2.x because namespaces were only introduced in PHP 5.3.
PHP 5.3.3 Released!

どういう事かというと、

<?php
class A
{
  function A()
  {
    echo __CLASS__;
  }
}
class B extends A
{
}
class C extends B
{
  function C()
  {
    parent::B();
  }
}
new C();

結果
PHP5.3.2

PHP Fatal error:  Call to undefined method B::B()

PHP5.3.3

A

PHP5.3.xによってPHP4に対する後方互換が崩れたんですが、PHP5.3.3でPHP5.3.x非互換となる代わりにPHP4後方互換が一部戻ったという話。
PEAR::Image_Graphで問題でてました。
PHP5の環境なら以下のように書くので問題は起こらないんですけどね。

<?php
class A
{
  public function __construct()
  {
    echo __CLASS__;
  }
}
class B extends A
{
}
class C extends B
{
  public function __construct()
  {
    parent::__construct();
  }
}
new C();

修正
sendOAuthRequest()メソッドでHTTP_OAuth_Exceptionがthrowされる問題
serchメソッドでhttp://search.twitter.comを利用しない問題
blocks/createメソッドでuser_id、screen_nameを指定できない問題
blocks/destroyメソッドでuser_id、screen_nameを指定できない問題
テストでOAuthの場合sourceはアプリケーションになる問題
テストでutf8テストが二重投稿になる問題
テストでOAuthの場合オブジェクトがHTTP_OAuth_Consumer_Responseになる問題

追加
blocks/bloking/idsメソッド (call $t->blocks->blocking_ids())

$ svn export -r 302262 http://svn.php.net/repository/pear/packages/Services_Twitter/trunk Services_Twitter
$ wget http://blog.cheki.net/Services_Twitter_r302262.diff
$ cd Services_Twitter
$ patch -p0 < ../services_twitter.diff
patching file Services/Twitter.php
patching file data/api.xml
patching file tests/900-exceptions.phpt
patching file tests/910-options.phpt
patching file tests/920-utf8.phpt
patching file tests/data/utf8-2.dat
patching file tests/setup.php

cockok's Services_Twitter at master – GitHub

リリース最新は0.6.2ですが、trunkが変更されてたのでそちらをfork。
あいきゃんとすぴーくいんぐりっしゅ。
もちろん書くのも。

ちなみに、DELETEメソッドででる問題は、RFC2616に以下のようなところ。

The DELETE method requests that the origin server delete the resource identified by the Request-URI.
HTTP/1.1: Method Definitions

こっちはPEAR::HTTP_OAuthの問題。

既にpearコマンドが利用可能な場合。

$ pear config-create /path/to ~/.pearrc

/path/to/pear以下に諸々配置される設定ファイルが~/.pearrcとして作成される。
この場合、PEARディレクトリは/path/to/pear/phpとなる。

ディレクトリ等、設定をを変更したい場合は、通常通りpear config-setコマンドで。

phpコマンドを実行する際にinclude_pathの設定をしたいが、オプションでは指定できないので、php.iniを別途準備し読むように指定するaliasを設定。

$ cp /etc/php.ini /path/to
$ vim /path/to/php.ini
$ alias php='php -c /path/to/php.ini'

php.iniのinclude_pathの設定は以下のようにローカルのPEARディレクトリしか読み込まない、または、優先的に読み込むように設定。

include_path = ".:/path/to/php"
#include_path = ".:/path/to/php:/usr/share/pear:/usr/share/php"

#!/usr/bin/env php
<?php
require_once 'HTTP/OAuth/Consumer.php';

define('CONSUMER_KEY',    'xxxxxxxxxxxxxxxxxxxx');
define('CONSUMER_SECRET', 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx');

try {

  $http_request = new HTTP_Request2();
  $http_request->setConfig('ssl_verify_peer', false);

  $consumer_request = new HTTP_OAuth_Consumer_Request();
  $consumer_request->accept($http_request);

  $consumer = new HTTP_OAuth_Consumer(CONSUMER_KEY, CONSUMER_SECRET);
  $consumer->accept($consumer_request);

  $consumer->getRequestToken('http://twitter.com/oauth/request_token');
  $url = $consumer->getAuthorizeUrl('http://twitter.com/oauth/authorize');

  if (!$stdin = fopen('php://stdin', 'r')) {
    throw new Exception('stdin open failed');
  }

  echo 'Visit the following URL in your browser to authenticate twitter: ';
  echo $url."\n";
  echo 'Enter Twitter OAuth PIN: ';
  $pin = trim(fgets($stdin, 64));
  $consumer->getAccessToken('http://twitter.com/oauth/access_token', $pin);

  echo 'access_token: '.$consumer->getToken()."\n";
  echo 'access_token_secret: '.$consumer->getTokenSecret()."\n";

} catch (Exception $e) {

  echo $e->getMessage().' in '.$e->getFile().' line '.$e->getLine()."\n";
  exit(1);

}

インストール

# yum --enablerepo=remi,epel install php-pear-PHP-CodeSniffer

使い方

$ phpcs hoge.php

Services_Twitterはベーシック認証周りは大丈夫だと思いますが、OAuth周りはまともにテストされてないので、結構バグあります。

  protected function prepareRequest($endpoint, array $args = array(), $cat = null)
  {
    $params = array();
    $files  = array();

    // check if we have is a search or trends call, in this case the base
    // uri is different
    if (   $cat == 'search'
      || ( $cat == 'trends'
        && !in_array((string)$endpoint['name'], array('available', 'location'))
      )
    ) {
      $uri = self::$searchUri;
    } else {
      $uri = self::$uri;
    }

    // ssl requested
    if ($this->getOption('use_ssl')) {
      $uri = str_replace('http://', 'https://', $uri);
    }

    // build the uri path
    if (!isset($endpoint['routing'])) {
      $path = '/';
      if ($cat !== null) {
        $path .= $cat . '/';
      }
      $path  .= (string)$endpoint['name'];
    } else {
      $path = (string)$endpoint['routing'];
    }
    $method = (string)$endpoint['method'];

    // check if we have a POST method and a registered source to pass
    $source = $this->getOption('source');
    if ($method == 'POST' && $source !== null) {
      $params['source'] = $source;
    }

    // check arguments requirements
    $minargs = isset($endpoint['min_args'])
      ? (int)$endpoint['min_args']
      : count($endpoint->xpath('param[@required="true" or @required="1"]'));
    if (!$minargs && (isset($args[0]) && !is_array($args[0]))) {
      throw new Services_Twitter_Exception(
          $path . ' expects an array as unique parameter',
          self::ERROR_PARAMS,
          $path
          );
    }
    if (   $minargs && (!isset($args[0])
          || is_array($args[0])
          && $minargs > count($args[0]))
       ) {
      throw new Services_Twitter_Exception(
          'Not enough arguments for ' . $path,
          self::ERROR_PARAMS,
          $path
          );
    }
    $needargs = $minargs;

    // now process arguments according to their definition in the xml
    // mapping
    foreach ($endpoint->param as $param) {
      $pName      = (string)$param['name'];
      $pType      = (string)$param['type'];
      $pMaxLength = (int)$param['max_length'];
      $pMaxLength = $pMaxLength > 0 ? $pMaxLength : null;
      $pReq       = (string)$param['required'] == 'true' || $needargs;
      if ($pReq && !is_array($args[0])) {
        $arg = array_shift($args);
        $needargs--;
      } else if (isset($args[0][$pName])) {
        $arg = $args[0][$pName];
        $needargs--;
      } else {
        continue;
      }
      try {
        $this->validateArg($pName, $arg, $pType, $pMaxLength);
      } catch (Exception $exc) {
        throw new Services_Twitter_Exception(
            $path . ': ' . $exc->getMessage(),
            self::ERROR_PARAMS,
            $path
            );
      }
      if ($pName == 'id' && !isset($endpoint['routing'])) {
        $path .= '/' . $arg;
      } else {
        if (strpos($path, ':') !== false) {
            $path = preg_replace('/:'.preg_quote($pName).'(\/|$)/', rawurlencode($arg).'$1', $path);
        } else {
          if ($pType == 'string' && !$this->isUtf8($arg)) {
            // iso-8859-1 string that we must convert to unicode
            $arg = utf8_encode($arg);
          }
          if ($pType == 'image') {
            // we have a file upload
            $files[$pName] = $arg;
          } else {
            $params[$pName] = $arg;
          }
        }
      }
    }
    $uri .= $path . '.' . $this->getOption('format');

    return array($uri, $method, $params, $files);
  }