Download the PHP package dg/twitter-php without Composer

X for PHP

Small and easy-to-use library for the X (formerly Twitter) API v2.

Installation

Install via Composer:

Requirements: PHP 8.2 or higher.

Getting API Keys

1. Go to X Developer Portal
2. Sign in and create a Developer account (Free tier is sufficient)

3. Create a new Project and App

4. Set up permissions (important!):

   • App Settings → User authentication settings → Edit
   • App permissions: Read and Write
   • Type of App: Web App
   • Callback URI: https://localhost/callback (placeholder, not used)
   • Website URL: any valid URL

5. Generate keys:

   • Keys and tokens → API Key and Secret → Generate
   • Keys and tokens → Access Token and Secret → Generate

   ⚠️ Note: After changing permissions, you must regenerate the Access Token!

6. Use case description (required by X, min. 250 characters):

Usage

Create the client using your API credentials:

Note: The Free tier of the X API only allows sending and deleting tweets and reading your own profile (authenticate()). Reading timelines, searching, user info, followers and other read endpoints require the Basic tier or higher.

Sending Tweets

With an image:

With multiple images:

Timelines

Get your own tweets:

Get your home timeline (you and people you follow):

Get your mentions:

Displaying Tweets

The static method Client::clickable() makes links, mentions and hashtags in tweets clickable:

Searching

Users

Social Actions

Authentication

Test if user credentials are valid:

Custom API Requests

You can call any X API v2 endpoint directly:

Error Handling

All methods throw DG\X\Exception on error:

Backward Compatibility

The old class names DG\Twitter\Twitter, DG\Twitter\Exception, Twitter and TwitterException are available as aliases for DG\X\Client and DG\X\Exception.

Support Me

Thank you!

Changelog

v5.0 (2/2026)

• new namespace DG\X with Client class
• uses X API v2 endpoints
• uses Guzzle HTTP client (replaces raw CURL)
• simplified inline OAuth 1.0a
• clean API: sendTweet(), deleteTweet(), getTweet(), getMyTweets(), getTimeline(), getMentions(), search(), getUser(), getUserById(), getFollowers(), follow(), sendDirectMessage()
• PHPStan level 8
• Nette Tester tests
• requires PHP 8.2+

v4.1 (11/2019)

• added Delete Method (#68)
• token is optional throughout + supply get() method

v4.0 (2/2019)

• requires PHP 7.1 and uses its advantages like typehints, strict types etc.
• class Twitter is now DG\Twitter\Twitter
• class TwitterException is now DG\Twitter\Exception

v3.8 (2/2019)

• Twitter::sendDirectMessage() uses new API
• Twitter::clickable: added support for $status->full_text (#60)

v3.7 (3/2018)

• minimal required PHP version changed to 5.4
• Twitter::send() added $options
• Twitter::clickable() now works only with statuses and entites
• fixed coding style

v3.6 (8/2016)

• added loadUserFollowersList() and sendDirectMessage()
• Twitter::send() allows to upload multiple images
• changed http:// to https://

v3.5 (12/2014)

• allows to send message starting with @ and upload file at the same time in PHP >= 5.5

v3.4 (11/2014)

• cache expiration can be specified as string
• fixed some bugs

v3.3 (3/2014)

• Twitter::send($status, $image) can upload image
• added Twitter::follow()

v3.2 (1/2014)

• Twitter API uses SSL OAuth
• Twitter::clickable() supports media
• added Twitter::loadUserInfoById() and loadUserFollowers()
• fixed Twitter::destroy()

v3.1 (3/2013)

• Twitter::load() - added third argument $data
• Twitter::clickable() uses entities; pass as parameter status object, not just text
• added Twitter::$httpOptions for custom cURL configuration

v3.0 (12/2012)

• updated to Twitter API 1.1

v2.0 (8/2012)

• added support for OAuth authentication protocol
• added Twitter::clickable() which makes links, @usernames and #hashtags clickable
• installable via composer require dg/twitter-php

v1.0 (7/2008)

• initial release

(c) David Grudl, 2008, 2026 (https://davidgrudl.com)