目次
サンプル・プログラムの実行例
サンプル・プログラム
| putTwitter.php | サンプル・プログラム本体 |
| pahooTwitterAPI.php | Twitter APIに関わるクラス pahooTwitterAPI。 使い方は「PHPでTwitterに投稿（ツイート）する」などを参照。include_path が通ったディレクトリに配置すること。 |
| pahooInputData.php | データ入力に関わる関数群。 使い方は「数値入力とバリデーション」「文字入力とバリデーション」などを参照。include_path が通ったディレクトリに配置すること。 |
| バージョン | 更新日 | 内容 |
|---|---|---|
| 5.2.0 | 2025/08/22 | .pahooEnv 導入 |
| 5.1.0 | 2024/05/18 | twitter.com → x.com 変更対応 |
| 5.0.0 | 2023/07/02 | Twitter API v2対応 |
| 4.1 | 2022/01/04 | PHP8対応，リファラ・チェック改良 |
| 4.0 | 2016/02/11 | pahooTwitterAPIクラスを分離 |
| バージョン | 更新日 | 内容 |
|---|---|---|
| 5.6.0 | 2025/08/13 | .pahooEnv導入 |
| 5.5.1 | 2024/11/23 | __construct() -- PHP8.4における応急処置 |
| 5.5.0 | 2024/06/21 | TwitterOAuth 7.0.0 対応 |
| 5.4.0 | 2024/05/18 | twitter.com → x.com 変更対応 |
| 5.3.0 | 2023/08/15 | tweet3() -- メディアのシャフル機能 |
| バージョン | 更新日 | 内容 |
|---|---|---|
| 2.0.1 | 2025/08/11 | getParam() bug-fix |
| 2.0.0 | 2025/08/11 | pahooLoadEnv() 追加 |
| 1.9.0 | 2025/07/26 | getParam() 引数に$trim追加 |
| 1.8.1 | 2025/03/15 | validRegexPattern() debug |
| 1.8.0 | 2024/11/12 | validRegexPattern() 追加 |
準備：PHP の https対応
Windowsでは、"php.ini" の下記の行を有効化する。
extension=php_openssl.dllLinuxでは --with-openssl=/usr オプションを付けて再ビルドする。→OpenSSLインストール手順
これで準備は完了だ。
準備：pahooInputData 関数群
また、各種クラウドサービスに登録したときに取得するアカウント情報、アプリケーションパスワードなどを登録した .pahooEnv ファイルから読み込む関数 pahooLoadEnv を備えている。こちらについては、「各種クラウド連携サービス（WebAPI）の登録方法」をご覧いただきたい。
準備：pahooTwitterAPI クラス
pahooTwitterAPI.php
11: // TwitterOAuth クラスをロードする．
12: $version = explode('.', phpversion());
13: if ($version[0] >= 8) {
14: require __DIR__ . '/vendor/autoload.php';
15: }
16: use Abraham\TwitterOAuth\TwitterOAuth;
17:
「Twitter API」を利用するために、API key、API key secret、Access Token、Access Token secret が必要で、入手方法は「Twitter API - WebAPIの登録方法」を参照されたい。
PHPのクラスについては「PHPでクラスを使ってテキストの読みやすさを調べる」を参照されたい。
OAuth認証 および Twitter API へのアクセスには、TwitterOAuth を利用する。導入方法は公式サイトにあるように composer を使うことを推奨している。
⚠ TwitterOAuth 7.0.0 は PHP 8.4（2024年11月21日リリース）でいくつかのエラーが発生する。これは、引数に暗黙の null を指定することが非推奨になったためで、プログラムの改修が行われるまでは PHP 8.3 で利用することをおすすめする。
TwitterOAuth クラスをロードする。composer でインストールされたフォルダ "\vendor" を "pahooTwitterAPI.php" と同じフォルダへコピーすること。
pahooTwitterAPI.php
37: /**
38: * コンストラクタ
39: * @param なし
40: * @return なし
41: */
42: function __construct() {
43: if (isset($_ENV['PAHOO_TWTR_CONSUMER_KEY'])) {
44: $this->TWTR_CONSUMER_KEY = $_ENV['PAHOO_TWTR_CONSUMER_KEY'];
45: }
46: if (isset($_ENV['PAHOO_TWTR_CONSUMER_SECRET'])) {
47: $this->TWTR_CONSUMER_SECRET = $_ENV['PAHOO_TWTR_CONSUMER_SECRET'];
48: }
49: if (isset($_ENV['PAHOO_TWTR_ACCESS_KEY'])) {
50: $this->TWTR_ACCESS_KEY = $_ENV['PAHOO_TWTR_ACCESS_KEY'];
51: }
52: if (isset($_ENV['PAHOO_TWTR_ACCESS_SECRET'])) {
53: $this->TWTR_ACCESS_SECRET = $_ENV['PAHOO_TWTR_ACCESS_SECRET'];
54: }
55:
56: // プロパティを初期化する．
57: $this->responses = array();
58: $this->webapi = '';
59: $this->error = FALSE;
60: $this->errmsg = '';
61: $this->errcode = 0;
62:
63: $this->connection = new TwitterOAuth($this->TWTR_CONSUMER_KEY, $this->TWTR_CONSUMER_SECRET, $this->TWTR_ACCESS_KEY, $this->TWTR_ACCESS_SECRET);
64: // v2使用を宣言
65: $this->connection->setApiVersion('2');
66:
67: // PHP8.4で暗黙的にnullableを指定することが非推奨になったため
68: // TwitterOAuthが対応するまでの応急処置
69: error_reporting(E_ALL & ~E_DEPRECATED & ~E_USER_DEPRECATED);
70: }
pahooTwitterAPI.php
30: // OAuth用パラメータ
31: // https://apps.twitter.com/
32: public $TWTR_CONSUMER_KEY = ''; // Cunsumer key
33: public $TWTR_CONSUMER_SECRET = ''; // Consumer secret
34: public $TWTR_ACCESS_KEY = ''; // Access Token (oauth_token)
35: public $TWTR_ACCESS_SECRET = ''; // Access Token Secret (oauth_token_secret)
36:
事前にプログラムを登録しておく必要があり、その方法は「Twitter API - WebAPIの登録方法」を参照されたい。入手したパラメータを、上述の変数に代入しておくこと。
Twitter API：POST /2/tweets
| ＵＲＬ |
|---|
| https://api.twitter.com/2/tweets |
| フィールド名 | 要否 | 内 容 |
|---|---|---|
| text | 必須 | 投稿文。UTF-8でエンコードされたテキストで、140文字以下。 |
解説：ツイート
pahooTwitterAPI.php
470: /**
471: * メッセージをツイートする．
472: * Tweetet API v2 を使用する．
473: * @param string $message 投稿メッセージ（UTF-8限定）
474: * @return bool TRUE：ツイート成功／FALSE：失敗
475: */
476: function tweet($message) {
477: //メッセージをツイートする．
478: $option = [
479: 'text' => $message
480: ];
481: // $status = $this->connection->post('tweets', $option, TRUE);
482: $status = $this->connection->post('tweets', $option, ['jsonPayload' => true]); //twitteroauth 7.0.0 対応
483: $this->webapi = 'https://api.twitter.com/2/tweets';
484:
485: //処理に成功した．
486: if ($this->isSuccess()) {
487: $this->responses = $status->data;
488: $this->errcode = NULL;
489: $this->errmsg = '';
490: $this->error = FALSE;
491: $res = TRUE;
492: //処理に失敗した．
493: } else {
494: if ($this->isAuthError() == FALSE) {
495: $this->errmsg = $status->detail;
496: $this->error = TRUE;
497: }
498: $res = FALSE;
499: }
500: return $res;
501: }
解説：メイン・プログラム
putTwitter.php
190: // ツイート実行
191: if ($msg != '') {
192: $msg = htmlspecialchars($msg);
193: if ($ptw->twitter_strlen($msg) <= 140) {
194: $res = $ptw->setting();
195: if ($res) {
196: $screen_name = (string)$ptw->responses->screen_name;
197: $res = $ptw->tweet($msg);
198: }
199: if ($res == FALSE) {
200: $outmsg = '<p style="color:red;">投稿失敗：' . $ptw->errmsg . '</p>';
201: } else {
202: $id_str = $ptw->responses->id;
203: // $url = 'https://twitter.com/' . $screen_name . '/status/' . $id_str;
204: $url = 'https://x.com/' . $screen_name . '/status/' . $id_str;
205: $outmsg = '<p style="color:blue;">投稿成功：<a href="' . $url . '">' . $url . '</a></p>';
206: }
207: } else {
208: $outmsg = '<p style="text:red;">メッセージを 140 文字以下にしてください．</p>';
209: }
210: }
211:
一度に投稿できるツイートは、半角でも全角でも140文字以下なので、入力文字数のチェックをしておく。
ユーザー関数 twitter_strlen は、英数字も日本語も1文字としてカウントするが、URLのみ23文字としてカウントするTwitter仕様である。140文字を超えた場合にはツイートしない。
tweet を実行した後、戻り値を解析し、成功した場合には投稿メッセージへのリンクを表示する。
Twitterへの再登録が必要な場合も
プログラムのバージョンアップで正常に動作しない場合は、Twitterへ新規登録してみるといいだろう。
質疑応答
とっさん様【回答】
Twitterへの投稿プログラムを使ってみようと思ったのですが、
putTwitter.phpを実行すると、次のファイルがないので動きません
require_once('pahooInputData.php');
このファイルはどこからダウンロードできますか？
配布ファイルから漏れており、失礼しました。【質問】
"pahooInputData.php" を追加した配布ファイルをアップロードしました。お手数ですが、再ダウンロードをお願いします。
とっさん様【回答】
"pahooInputData.php" を追加した配布ファイルはどこからダウンロードできますか？
本ページの上の方にある「ダウンロード」ボタンをクリックして、再ダウンロードをお願いします。【質問】
よし様【回答】
TwitterOAuthのバージョンはいくつでしょうか？
現在、7.0.0のようです。
下記、エラーが発生しました。
Fatal error: Uncaught Error: Call to undefined method Abraham\TwitterOAuth\TwitterOAuth::setApiVersion() ～pahooTwitterAPI.php
TwitterOAuthのバージョンは 5.0.0 でした。
2024年（令和6年）6月21日に、TwitterOAuth 7.0.0 に対応した "pahooTwitterAPI.php" を同梱した圧縮ファイルを公開しました。お試しください。
参考サイト
- Twitter Developer Platform Documentation：公式サイト
- PHPでTwitterに投稿する：ぱふぅ家のホームページ
- PHPでTwitterに画像付きメッセージ投稿：ぱふぅ家のホームページ
- PHPでツイートの埋め込み用HTMLを取得：ぱふぅ家のホームページ
Twitter社がイーロン・マスク氏に買収され、API有料化などの情報が流れたが、2023年（令和5年）6月現在、24時間に50ツイートまで、アプリケーションは1つまでなどの条件付きで、freeプラン（無料）が利用できる。Twitter API v2 のみ利用できるが、v2へ移行していない機能については Twitter API v1.1 を併用していく形になっている。