owlycode / streaming-bird
A PHP client for the Twitter Streaming APIs inspired from Phirehose.
Installs: 24 623
Dependents: 0
Suggesters: 0
Security: 0
Stars: 10
Watchers: 3
Forks: 2
Open Issues: 0
Requires
- php: ~5.6|~7.0
Requires (Dev)
- phpunit/phpunit: ~4.7
- symfony/process: ~3.0
This package is auto-updated.
Last update: 2024-11-08 04:00:49 UTC
README
StreamingBird is an automatically tested, PSR-4 compliant client for Twitter's streaming API.
How to install
With composer : composer require owlycode/streaming-bird
.
Example usage
use OwlyCode\StreamingBird\StreamReader; use OwlyCode\StreamingBird\StreamingBird; // Change these with yours. $oauthToken = 'my token'; $oauthSecret = 'secret'; $consumerKey = 'my key'; $consumerSecret = 'secret'; $bird = new StreamingBird($consumerKey, $consumerSecret, $oauthToken, $oauthSecret); $bird ->createStreamReader(StreamReader::METHOD_FILTER) ->setTrack(['hello', 'hola', 'bonjour']) // Fetch every tweet containing one of the following words ->consume(function ($tweet) { // Now we provide a callback to execute on every received tweet. echo '------------------------' . "\n"; echo $tweet['text'] . "\n"; }) ;
Monitoring
StreamingBird comes with some statistics about the stream that you can access. At the moment it is an early approach with few informations but it is meant to grow in the future.
$reader->consume(function ($tweet, $monitor) use ($output) { echo '------------------------' . "\n"; echo $monitor->get('tweets') . "\n"; // The total number of received tweets echo $monitor->get('idle_time') . "\n"; // Elapsed seconds between the last two tweets. echo $monitor->get('max_idle_time') . "\n"; // The maximum idle time since the beginning. echo $tweet['text'] . "\n"; });
Running the tests
Simply run :
composer install ./bin/vendor/phpunit