Skip to content

Latest commit

 

History

History
150 lines (102 loc) · 3.43 KB

README.md

File metadata and controls

150 lines (102 loc) · 3.43 KB
Raw

php-twient

php-twient is a php5.3+ twitter client library and Composer package.

FEATURES

  • Composer package
  • Use namespace for PHP 5.3+
  • Support Twitter API v1.1
  • Should work with/without php_curl (detects php_curl automatically)

Usage

Install by using Composer

Composer: http://getcomposer.org/

create blew composer.json on your project directory and execute composer install

/path/to/project/composer.json
{
    "require": {
        "makotokw/twient": "dev-master"
    }
}

Get timeline

<?php
use Makotokw\Twient\Twitter;

$consumer_key = 'consumer key for your application';
$consumer_secret = 'consumer secret for your application';
$oauth_token = 'oauth token for your account';
$oauth_token_secret = 'oauth token secret for your account';

$twitter = new Twitter();
$twitter->oAuth($consumer_key, $consumer_secret, $oauth_token, $oauth_token_secret);
$statuses = $twitter->call('statuses/home_timeline');
foreach ($statuses as $status) {
    echo $status['user']['name'].': '.$status['text'].PHP_EOL;
}
?>

Post status (Tweet)

$twitter->call('statuses/update', array('status' => 'tweet by php-twient'));

Using Streaming API with closure

The streaming method is terminated when callback returns false.

$twitter->streaming(
    'statuses/filter',
    array('track' => 'Sushi,Japan'),
    function ($twitter, $status) {
        static $count = 0;
        echo $status['user']['name'] . ':' . $status['text'] . PHP_EOL;
        return ($count++ < 5);
    }
);

Alternative API

use Makotokw\Twient\Twitter\V1dot1 as Twitter;

$twitter = new Twitter();
...
$twitter->statusesHomeTimeline();       // instead of "call('statuses/home_timeline')"
$twitter->statusesUpdate(...);          // instead of "call('statuses/update', ...)"
$twitter->streamingStatusesFilter(...);    // instead of "streaming('statuses/filter', ...)"

HISTORY

v0.7

  • Supported media/upload api

v0.6

  • Added vendor namespace Makotokw\Twient
  • No longer supported TinyURL
  • PSR-4 Auto Loading

v0.5.1

  • Used https scheme for Streaming API

v0.5

  • Supported Twitter API v1.1

v0.4

  • Updated to Composer package
  • Required PHP5.3+
  • PSR-2 Coding Standard

v0.3.1

  • Uses the Services_JSON instead of json_decode when PHP < 5.2.0

v0.3

  • Fixed that OAuth part have deprecated function on PHP 5.3 or later
  • Supported Trends Methods
  • Updated Status Methods and User Methods

v0.2

  • Supported Search API.
  • Supported User, Friendship and Social Graph Methods of REST API.
  • Supported Streaming API.
  • Changed call method returns associative arrays instead of objects.
  • Added assoc flag to return associative arrays or objects.

v0.1

  • Initial Release

LICENSE

The MIT License (MIT)
See also LICENSE file