README

tmhOAuth

An OAuth 1.0A library written in PHP by @themattharris, specifically for use with the Twitter API.

Disclaimer: This project is a work in progress. Please use the issue tracker to report any enhancements or issues you encounter.

Goals

Dependencies

The library has been tested with PHP 5.3+ and relies on CURL and hash_hmac. The vast majority of hosting providers include these libraries and run with PHP 5.1+.

The code makes use of hash_hmac, which was introduced in PHP 5.1.2. If your version of PHP is lower than this you should ask your hosting provider for an update.

A note about security and SSL

Version 0.60 hardened the security of the library and defaulted curl_ssl_verifypeer to true. As some hosting providers do not provide the most current certificate root file it is now included in this repository. If the version is out of date OR you prefer to download the certificate roots yourself, you can get them from: http://curl.haxx.se/ca/cacert.pem

Before upgrading the version of tmhOAuth that you use, be sure to verify the SSL handling works on your server by running the examples/verify_ssl.php script.

Usage

This will be built out later but for the moment review the examples repository https://github.com/themattharris/tmhOAuth-examples for ways the library can be used. Each example contains instructions on how to use it.

Notes for users of previous versions

If you previously used version 0.4 be aware the utility functions have now been broken into their own file. Before you use version 0.5+ in your app test locally to ensure your code doesn’t need tmhUtilities included.

If you used custom HTTP request headers when they were defined as 'key: value' strings you should now define them as 'key' => 'value' pairs.

Versions prior to 0.7.3 collapsed headers with the same value into one $tmhOAuth->response[‘headers’] key. Since 0.7.3 headers with the same key will use an array to store their values.

Change History

0.7.5 - 20 Februrary 2013

0.7.4 - 19 Februrary 2013

0.7.3 - 18 Februrary 2013

0.7.2 - 01 November 2012

0.7.1 - 27 October 2012

0.7.0 - 04 September 2012

0.621 - 12 March 2012

0.62 - 01 March 2012

0.61 - 16 January 2012

0.60 - 29 December 2011

0.58 - 29 December 2011

0.57 - 11 December 2011

0.56 - 29 September 2011

0.55 - 29 September 2011

0.54 - 29 September 2011

0.53 - 15 July 2011

0.52 - 06 July 2011

0.51 - 06 July 2011

0.5 - 29 March 2011

0.4 - 03 March 2011

0.3 - 28 September 2010

0.2 - 17 September 2010

0.14 - 17 September 2010

0.13 - 17 September 2010

0.12 - 17 September 2010

0.11 - 17 September 2010

0.1 - 26 August 2010

Community

License: Apache 2 (see included LICENSE file)

Follow @tmhOAuth to receive updates on releases, or ask for support Follow me on Twitter: @themattharris Check out the Twitter Developer Resources: https://dev.twitter.com

To Do