PHPでTwitter(現・X)に画像付きメッセージ投稿

(1/1)
PHPでTwitterに画像付きメッセージ投稿
今回は、PHPで「Twitter API」を利用し、画像付きのメッセージを投稿する。リプライ（返信）指定もできる。画像は最大4つまで。動画を投稿することもできる。

（2024年6月21日）TwitterOAuth 7.0.0 対応
（2024年5月18日）ドメイン変更 twitter.com → x.com に対応
（2022年1月9日）Twitter API v2対応，その他大幅改訂

目次

  1. サンプル・プログラム：実行例
  2. サンプル・プログラム
  3. サンプル・プログラムの流れ
  4. 準備：pahooTwitterAPI クラス
  5. PHP の https対応
  6. Twitter API：POST media/upload
  7. 解説：画像アップロード
  8. 解説：画像付き投稿
  9. 参考サイト

サンプル・プログラム：実行例

PHPでTwitterに画像付きメッセージ投稿
本プログラムは、パラメータをGET渡すことで実行することもできる。
たとえば、"putTweetMedia.php?msg=%E5%B0%8F%E7%94%B0%E5%8E%9F%E5%9F%8E%E3%81%AF%E9%9B%A3%E6%94%BB%E4%B8%8D%E8%90%BD+https%3A%2F%2Fwww.pahoo.org%2Fathome%2Falbum%2F2019%2Fimg20190907-173131e.jpg&reply=https%3A%2F%2Ftwitter.com%2Fpapa_pahoo%2Fstatus%2F123456789" のようにすると、"https://twitter.com/papa_pahoo/status/123456789" にリプライ（返信）する形で、メッセージ「小田原城は難攻不落」と画像ファイル "/athome/album/2019/img20190907-173131e.jpg" を付けることができる。

サンプル・プログラム

download ダウンロード（PHP8対応）

圧縮ファイルの内容
putTweetMedia.phpサンプル・プログラム本体
pahooTwitterAPI.phpTwitter APIを利用するクラス pahooTwitterAPI。
使い方は「PHPでTwitterに投稿（ツイート）する」などを参照。include_path が通ったディレクトリに配置すること。
圧縮ファイルの内容
putTweetMedia.phpサンプル・プログラム本体
pahooTwitterAPI.phpTwitter APIに関わるクラス pahooTwitterAPI。
使い方は「PHPでTwitterに投稿（ツイート）する」などを参照。include_path が通ったディレクトリに配置すること。
putTweetMedia.php 更新履歴
バージョン 更新日 内容
2.1.0 2024/05/18 twitter.com → x.com 変更対応
2.0.0 2023/07/16 Twitter API v2対応，その他大幅改訂
1.1 2022/01/09 PHP8対応，リファラ・チェック改良
1.0 2016/02/13
pahooTwitterAPI.php 更新履歴
バージョン 更新日 内容
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() -- メディアのシャフル機能
5.2.1 2023/07/22 bug-fix
5.2.0 2023/07/17 oembed() v2対応
pahooInputData.php 更新履歴
バージョン 更新日 内容
1.5.0 2024/01/28 exitIfExceedVersion() 追加
1.4.2 2024/01/28 exitIfLessVersion() メッセージ修正
1.4.1 2023/09/30 コメントの訂正
1.4.0 2023/09/09 $_GET, $_POST参照をfilter_input()関数に置換
1.3.0 2023/07/11 roundFloat() 追加
OAuth認証 および Twitter API へのアクセスには、TwitterOAuth を利用する。導入方法は公式サイトにあるように composer を使うことを推奨している。

準備：pahooTwitterAPI クラス

  11: //TwitterOAuth クラスをロードする．
  12: $version = explode('.', phpversion());
  13: if ($version[0] >= 8) {
  14:     require __DIR__ . '/vendor/autoload.php';
  15: }
  16: use Abraham\TwitterOAuth\TwitterOAuth;
  17: 

前述の TwitterOAuth クラスをロードする。composer でインストールされたフォルダ "\vendor" を "pahooTwitterAPI.php" と同じフォルダへコピーすること。

  34: /**
  35:  * コンストラクタ
  36:  * @param   なし
  37:  * @return  なし
  38: */
  39: function __construct() {
  40:     $this->responses = array();
  41:     $this->webapi    = '';
  42:     $this->error     = FALSE;
  43:     $this->errmsg    = '';
  44:     $this->errcode   = 0;
  45: 
  46:     $this->connection = new TwitterOAuth($this->TWTR_CONSUMER_KEY, $this->TWTR_CONSUMER_SECRET, $this->TWTR_ACCESS_KEY, $this->TWTR_ACCESS_SECRET);
  47:     //v2使用を宣言
  48:     $this->connection->setApiVersion('2');
  49: }

TwitterOAuth クラスは pahooTwitterAPI のコンストラクタでインスタンス化しておく。

  27:     //OAuth用パラメータ
  28:     // https://apps.twitter.com/
  29:     var $TWTR_CONSUMER_KEY    = '***************';  //Cunsumer key
  30:     var $TWTR_CONSUMER_SECRET = '***************';  //Consumer secret
  31:     var $TWTR_ACCESS_KEY      = '***************';  //Access Token (oauth_token)
  32:     var $TWTR_ACCESS_SECRET   = '***************';  //Access Token Secret (oauth_token_secret)
  33: 

TwitterAPI を利用するために、クラスファイル "pahooTwitterAPI.php" を使用する。組み込み関数  require_once  を使って読めるディレクトリに配置する。ディレクトリは、設定ファイル php.ini に記述されているオプション設定 include_path に設定しておく。

事前にプログラムを登録しておく必要があり、その方法は「Twitter API - WebAPIの登録方法」を参照されたい。入手したパラメータを、上述の変数に代入しておくこと。

PHP の https対応

Twitter APIの呼び出しはhttps通信で行うため、PHPにOpenSSLモジュールが組み込まれている必要がある。
関数  phpinfo  を使って、下図のように表示されればＯＫ。
OpenSSL - PHP
そうでない場合は、次の手順に従ってOpenSSLを有効化し、PHPを再起動させる必要がある。

Windowsでは、phop.iniの下記の行を有効化する。
extension=php_openssl.dll


Linuxでは --with-openssl=/usr オプションを付けて再ビルドする。→OpenSSLインストール手順

これで準備は完了だ。

Twitter API：POST /2/tweets

ツイートするには、「Twitter API：POST /2/tweets」を用いる。
WebAPIのURL
ＵＲＬ
https://api.twitter.com/2/tweets

入力パラメータ
フィールド名 要否 内　　容
text 必須 投稿文。UTF-8でエンコードされたテキストで、140文字以下。
media media_ids 任意 メディアID。最大4つ。
reply in_reply_to_tweet_id> 任意 リプライID。
応答データ（json） id 投稿ID text 投稿文

Twitter API：POST media/upload

画像を含むメディア・ファイルをアップロードするAPIはv.1.1のままで、「Twitter API：POST media/upload」を用いる。
Twitter API (POST)
ＵＲＬ
https://upload.twitter.com/1.1/media/upload.json

入力パラメータ
フィールド名 要否 内　　容
media mediaまたはmedia_dataが必須 media：メディアデータ（バイナリ）
media_data mediaまたはmedia_dataが必須 media_data：メディアデータ（base64形式）
応答データ（json） media_id メディアID media_id_string メディアID（文字列） size データサイズ image w 幅（ピクセル） h 高さ（ピクセル） image_type 形式

解説：メディア付きツイート

メディア付きツイート
まず、リプライ先のIDとスクリーンネームを取り出す。
続いて、メッセージの中からユーザー関数 extractMediaURL( を使ってメディアURLを取り出す。
メディアURLが1つでもあれば、「Twitter API：POST media/upload」を使ってアップロードする。
アップロードに成功すると、メディアIDを返す。これはツイートの時に必要になるので、配列 $media_ids に格納しておく。
1つのツイートに含めることができる画像の数は4つなので、この作業を最大4回繰り返す。

次に、「PHPでTwitterに投稿（ツイート）する」と同じ要領で、「Twitter API：POST /2/tweets」を使ってツイートする。オプションに配列 $media_ids を追加することで、先ほどアップロードした画像が付いたメッセージとなる。

 818: /**
 819:  * 指定したテキストをツイートする．
 820:  * リプライ（返信）先を指定したり，メディアを投稿できる．
 821:  * Tweetet API v2 を使用する．
 822:  * @param   string $message 投稿メッセージ（UTF-8限定）；メディアを指定するときは 'http(s)://' または 'file:///' を含める．メディアが5つ以上あるときにはランダムに4つを選ぶ．
 823:  * @param   string $reply   リプライ先のURL（省略可能）
 824:  * @return  bool TRUE：リクエスト成功／FALSE：失敗
 825: */
 826: function tweet3($message, $reply=NULL) {
 827:     $id    = NULL;
 828:     $name  = NULL;
 829: 
 830:     //リプライ先のidを取り出す．
 831:     if ($reply != NULL) {
 832:         if (preg_match('/\/([0-9]+$)/i', $reply, $arr) > 0) {
 833:             $id = (string)$arr[1];
 834:         } else {
 835:             $this->error  = TRUE;
 836:             $this->errmsg = 'リプライ先のURLが間違っています';
 837:             return FALSE;
 838:         }
 839:     }
 840:     //スクリーンネームを取り出す
 841:     if ($reply != NULL) {
 842: //      if (preg_match('/https\:\/\/twitter\.com\/([^\/]+)\//i', $reply, $arr) > 0) {
 843:         if (preg_match('/https\:\/\/x\.com\/([^\/]+)\//i', $reply, $arr) > 0) {
 844:             $name = (string)$arr[1];
 845:         } else {
 846:             $this->error  = TRUE;
 847:             $this->errmsg = 'リプライ先のURLが間違っています';
 848:             return FALSE;
 849:         }
 850:     }
 851: 
 852:     //メディアURLを取り出す．
 853:     $mediaURLs = array();
 854:     $str = $this->extractMediaURL($message, $mediaURLs);
 855:     //メディアが5つ以上あるときにはシャフルする．
 856:     if (count($mediaURLs) >= 5)     shuffle($mediaURLs);
 857: 
 858:     //スクリーンネームを追加する．
 859:     if ($id != NULL) {
 860:         $str = '@' . $name . ' ' . $str;
 861:     }
 862: 
 863:     //メディア付きリプライを行う．（Tweetet API v2 を使用する）
 864:     if (count($mediaURLs) > 0) {
 865:         $media_ids = array();
 866:         $cnt = 0;
 867:         //メディアのアップロード．
 868:         //Tweetet API v1.1 を使用する（v2にメディアアップロードが未実装のため）
 869:         $this->connection->setApiVersion('1.1'); 
 870:         foreach ($mediaURLs as $fname) {
 871:             $tmpname = $this->media2temp($fname);
 872:             if ($tmpname == FALSE) {
 873:                 echo 'failure';
 874:                 exit(1);
 875:             }
 876: //          $media = $this->connection->upload('media/upload', ['media' => $tmpname]);
 877:             $media = $this->connection->upload('media/upload', ['media' => $tmpname], ['chunkedUpload' => true]);   //twitteroauth 7.0.0 対応
 878:             unlink($tmpname);
 879:             if (! isset($media->media_id_string))       break;
 880:             $media_ids[] = (string)$media->media_id_string;
 881:             $cnt++;
 882:             if ($cnt > 3)   break;      //最大4つまで
 883:         }
 884: 
 885:         //メディア付きリプライ
 886:         $this->connection->setApiVersion('2'); 
 887:         $option = [
 888:             'text' => $str,
 889:             'media' => [
 890:                 'media_ids' => $media_ids
 891:             ]
 892:         ];
 893:         if ($id != NULL) {
 894:             $option = array_merge($option, [
 895:                 'reply' => [
 896:                     'in_reply_to_tweet_id' => $id
 897:                 ]
 898:             ]);
 899:         }
 900: 
 901:     //メディアなしリプライを行う．
 902:     } else {
 903:         $option['text'] = $str;
 904:         if ($id != NULL) {
 905:             $option = array_merge($option, [
 906:                 'reply' => [
 907:                     'in_reply_to_tweet_id' => $id
 908:                 ]
 909:             ]);
 910:         }
 911:     }
 912: //  $status = $this->connection->post('tweets', $option, TRUE);
 913:     $status = $this->connection->post('tweets', $option, ['jsonPayload' => true]);  //twitteroauth 7.0.0 対応
 914:     $this->webapi = 'https://api.twitter.com/2/tweets';
 915: 
 916:     //処理に成功した．
 917:     if ($this->isSuccess()) {
 918:         $this->responses = $status->data;
 919:         $this->errcode   = NULL;
 920:         $this->errmsg    = '';
 921:         $this->error     = FALSE;
 922:         $res = TRUE;
 923:     //処理に失敗した．
 924:     } else {
 925:         if ($this->isAuthError() == FALSE) {
 926:             $this->errmsg = $status->detail;
 927:             $this->error  = TRUE;
 928:         }
 929:         $res = FALSE;
 930:     }
 931:     return $res;
 932: }

参考サイト

（この項おわり）
前へ 目次 次へ
関連ページ bluesky
Valid HTML5 正当なCSSです!
2016年02月13日 作成／2024年06月21日 更新
Copyright by studio pahoo, (C)2016-2024
（※）本ページはリンクフリーですが、複製・転載時にはご一報ください。
★本ページへのご意見・ご質問・お便りは、こちらへお願いします。
header
ホーム  > Web技術  > PHPでクラウド連携