README

PHP library to communicate with Twitter OAuth API version 1.1.

• Namespaced
• PHP 5.3
• PSR-2
• PSR-4
• OOP
  

OAuth Methods Supported

• Single-User OAuth
• Application-Only Authentication

NOTE: Call media/upload supported, call account/update_profile_background_image not supported.

Requirements

• PHP Version >= 5.3
• PHP cURL extension
• PHP JSON extension
• PHP OpenSSL extension
• Lib cURL

NOTE: No external dependencies (Guzzle, Symfony Components. etc...)

Installation

The recommended way to install TwitterOAuth is through Composer:

{
    "require": {
        "ricardoper/twitteroauth": "2.*"
    }
}

NOTE: If you prefer v1 (One Single File), you can get it in v1 branch.

cURL Options

After some complaints, I decided to give access to the default options of cURL. This changes solved every connections issues caused by cURL library.

Please check the examples:

• "SingleUser_With_cURL_Options.php"
• "ApplicationOnly_With_cURL_Options.php"

Examples

Please, see the examples source code from "Examples" folder.

Benchmarks

Very simple benchmarks from "Examples" source code.

Memory Usage

Less than 524Kb except for image uploading. In this case memory depends on the image size.

Stress Bench

Stress bench done without connection request time. Single run bench done with and without connection request time. Connection request time may vary depending on the internet connection.

Machine:
Intel Core 2 Quad Q6600 2.40GHz
4Gb RAM
7200 rpm HDD

Versions:
nginx 1.6.2
PHP v5.5.9
Zend OPcache enabled
SIEGE 3.0.5

Bench Details:
20 concurrent connections
1000 requests per thread
No delays between requests
Command: siege -c20 -b -r1000 "URL"

v1 App Only
Transactions: 20000 hits
Availability: 100.00 %
Elapsed time: 11.44 secs
Data transferred: 0.46 MB
Response time:0.01 secs
Transaction rate: 1748.25 trans/sec
Throughput:0.04 MB/sec
Concurrency: 19.91
Successful transactions: 20000
Failed transactions: 0
Longest transaction: 0.03
Shortest transaction: 0.00

v1 Single User
Transactions: 20000 hits
Availability: 100.00 %
Elapsed time: 10.05 secs
Data transferred: 0.46 MB
Response time:0.01 secs
Transaction rate: 1990.05 trans/sec
Throughput:0.05 MB/sec
Concurrency: 19.86
Successful transactions: 20000
Failed transactions: 0
Longest transaction: 0.05
Shortest transaction: 0.00

v2 App only
Transactions: 20000 hits
Availability: 100.00 %
Elapsed time: 16.62 secs
Data transferred: 0.46 MB
Response time:0.02 secs
Transaction rate: 1203.37 trans/sec
Throughput:0.03 MB/sec
Concurrency: 19.91
Successful transactions: 20000
Failed transactions: 0
Longest transaction: 0.06
Shortest transaction: 0.00

v2 Single User
Transactions: 20000 hits
Availability: 100.00 %
Elapsed time: 15.61 secs
Data transferred: 0.46 MB
Response time:0.02 secs
Transaction rate: 1281.23 trans/sec
Throughput:0.03 MB/sec
Concurrency: 19.91
Successful transactions: 20000
Failed transactions: 0
Longest transaction: 0.04
Shortest transaction: 0.01

v2 App Only (Without Composer)
Transactions: 20000 hits
Availability: 100.00 %
Elapsed time: 15.78 secs
Data transferred: 0.46 MB
Response time:0.02 secs
Transaction rate: 1267.43 trans/sec
Throughput:0.03 MB/sec
Concurrency: 19.91
Successful transactions: 20000
Failed transactions: 0
Longest transaction: 0.04
Shortest transaction: 0.00

v2 Single User (Without Composer)
Transactions: 20000 hits
Availability: 100.00 %
Elapsed time: 15.60 secs
Data transferred: 0.46 MB
Response time:0.02 secs
Transaction rate: 1282.05 trans/sec
Throughput:0.03 MB/sec
Concurrency: 19.90
Successful transactions: 20000
Failed transactions: 0
Longest transaction: 0.06
Shortest transaction: 0.00

License

Released under the MIT License.