PHPackages                             mfrost503/wheedle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. mfrost503/wheedle

AbandonedLibrary[API Development](/categories/api)

mfrost503/wheedle
=================

PHP Twitter Library

0.1.2(11y ago)15151[3 issues](https://github.com/mfrost503/wheedle/issues)MITPHPPHP >=5.4.0

Since Jan 19Pushed 10y ago1 watchersCompare

[ Source](https://github.com/mfrost503/wheedle)[ Packagist](https://packagist.org/packages/mfrost503/wheedle)[ Docs](https://github.com/mfrost503/wheedle)[ RSS](/packages/mfrost503-wheedle/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (3)Versions (7)Used By (0)

Wheedle
-------

[](#wheedle)

#### A PHP Twitter library

[](#a-php-twitter-library)

[![](https://camo.githubusercontent.com/86ca3a237ac3824bcade7e52843f63902be3bde8241abf3c6e434b23d9d7d251/68747470733a2f2f7472617669732d63692e6f72672f6d66726f73743530332f77686565646c652e7376673f6272616e63683d6d6173746572)](https://camo.githubusercontent.com/86ca3a237ac3824bcade7e52843f63902be3bde8241abf3c6e434b23d9d7d251/68747470733a2f2f7472617669732d63692e6f72672f6d66726f73743530332f77686565646c652e7376673f6272616e63683d6d6173746572)

\[!\[Scrutinizer Code Quality\]([https://scrutinizer-ci.com/g/mfrost503/wheedle/badges/quality-score.png?b=master)\](https://scrutinizer-ci.com/g/mfrost503/wheedle/?branch=master](https://scrutinizer-ci.com/g/mfrost503/wheedle/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/mfrost503/wheedle/?branch=master)) \[!\[Build Status\]([https://scrutinizer-ci.com/g/mfrost503/wheedle/badges/build.png?b=master)\](https://scrutinizer-ci.com/g/mfrost503/wheedle/build-status/master](https://scrutinizer-ci.com/g/mfrost503/wheedle/badges/build.png?b=master)](https://scrutinizer-ci.com/g/mfrost503/wheedle/build-status/master)) This library is currently a work in progress, more examples to follow as they get built out!

Wheedle provides a common sense way to interacting with the Twitter API. Built using Guzzle and Snaggle, you'll never have to worry about those pesky OAuth 1 signatures. Getting started is as simple as passing in your tokens.

Here's an example of how easy is it to get started!

Table of Contents:

- [Convenience Classes Methods](#convenience-classes-methods)
    - [Tweet](#tweet)
        - [Retrieve](#retrieve)
        - [Mentions](#mentions)
        - [Home Timeline](#home-timeline)
        - [User Timeline](#user-timeline)
        - [My Tweets](#my-tweets---retweeted-by-others)
        - [Retrieve Retweets](#retrieve-retweets)
        - [Send a tweet](#send-a-tweet)
        - [Retweet an existing tweet](#retweet-an-existing-tweet)
        - [Delete an existing tweet](#delete-an-existing-tweet)
    - [Direct Message](#direct-message)
- [Direct Client Usage](#direct-client-usage)
- [Exceptions](#exceptions)
    - [RateLimitExceededException](#ratelimitexceededexception)
    - [UnauthorizedRequestException](#unauthorizedrequestexception)
    - [MissingResourceException](#missingresourceexception)
    - [TooManyCooksException](#toomanycooksexception)

### The Basics

[](#the-basics)

This library is a balance of convenience methods and an intuitive HTTP Client built on Guzzle. By utilizing Guzzle and Snaggle, we're able to minimize the amount of setup required to start making Authenticated API requests against the Twitter API. Nearly every endpoint in the Twitter API is going to have additional options that are available to you. If there is a convenience method for that particular endpoint, the options will be provided, however it may be necessary to consult [Twitter API Docs](https://dev.twitter.com/rest/public) for more information on your particular endpoint.

The aim is to take the pain out of dealing with the Twitter API and other wrappers and libraries that don't give you what you need. We aim to provide as much convenience and ease of use as possible. If you see something that doesn't seem right or could be done better, contributions (issues, pull requests, feature requests) are always welcome.

Convenience Classes Methods
---------------------------

[](#convenience-classes-methods)

### Tweet

[](#tweet)

The Tweet class will allow you to retrieve and post tweets (or statuses).

#### Retrieve

[](#retrieve)

To retrieve a tweet, you'll need to know the ID of the tweet and pass it as a parameter to the retrieve method:

```