Skip to content
A Twitter API 1.1 compliant class for PHP that provides a simple method of getting a number of tweets for a user, and providing them in an array
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.


Type Name Latest commit message Commit time
Failed to load latest commit information.


A Twitter API 1.1 compliant class that provides an array of a users timeline from Twitter for use in a nice cached-based way.

Uses Abraham Williams's Twitter OAuth class

Version 2.1

The class has now been updated to support multiple username/screennames, as well as full support for any parameters you want to pass through to the statuses/user_timeline API. (

Basic Usage

Basic usage of the class would be similar to


$config = array(
  'directory' => '', //The path used to store the .tweetcache cache file.
  'key' => '<App Key from Twitter>',
  'secret' => '<App Secret from Twitter>',
  'token' => '<Token from Twitter>',
  'token_secret' => '<Token Secret from Twitter>',
  'screenname' => '<Twitter Screename>', //This is now deprecated and you shouldn't define this - but it's here for backwards compatibility
  'cache_expire' => 3600 //The duration of the cache  

$twitter = new StormTwitter($config);

// getTweets is the only public method. For legacy reasons, it takes between 0 and 3 parameters.
// getTweets(twitter_screenname, number_of_tweets, custom_parameters_to_go_twitter);

$tweets = $twitter->getTweets('lgladdy', 1);

echo "<pre>";
echo "</pre>";

$tweets = $twitter->getTweets('stormuk', 1, array('include_rts' => true, 'exclude_replies' => true));

echo "<pre>";
echo "</pre>";

Change Log

Version 2.1

Support for the much more sensical username before count in getTweets. (Pull request from stevelacey) Check if the OAuthRequest class is already defined in our context. If it is, don't bother loading OAuth.php. This will stop compatibility errors with other OAuth plugins, but could mean you get other random errors relating to OAuth if you using anything other than the standard PHP OAuth library.

Version 2.0.4

Improve error handling if we don't get a standard error response from twitter, but something still went wrong.

You can’t perform that action at this time.