PHP

[記錄] 用 php+MySql 編寫 Line 機器人

2020/05/10, 11:06:30

Line 機器人現在越來越廣泛應用，工作上也有聽到長官想要同事去研究來寫。雖然後來不了了之XD 因為訊息量太大需要$$業主跟部門都不想出！不過因為沒有真的需要，所以自己就一直都沒有去研究。

然後 ami 大大發了這個噗
https://www.plurk.com/p/ntd5bn

剛好是假日，我就開始研究了XD

ami 大大的需求有四項：

輸入日期補登字數功能
每天自動提醒是否填坑功能(這個比較難，可能要研究一下)
最好可以自訂輸入的google表單的功能(這個不難，難在表單要開權限給程式端，所以好像也沒辦法給使用者輸入…)
讚美句+++ XDDD

不過因為我打算用 php+mysql 來寫機器人的反應動作，所以需求的第三項就可以跳過了XD

因為我幾乎從頭到尾也都是參考網路上的教學，所以這篇不會有太詳細的內容，但會記錄我參考的網址，還有遇到的一些問題的解決方法。

寫這個機器人，最重要的就是(1) 申請、設定機器人 (2) 當用戶輸入內容之後，要把資料接收到然後進行分析，再寫入資料庫 (3) 設定排程去主動發送訊息。這篇大概就是以這幾個步驟為主

內容目錄

申請、設定機器人

其實這個應該不大需要講，主要是從 https://developers.line.biz/console/ 開始進行註冊。這部份就不多說，網路上找找都會有很多申請方法！

資料分析

機器人資料分析的 Webhook 需要放在 SSL 的環境中，因為我自己的網站空間是有 SSL 的，所以就直接利用。如果有網頁空間但沒有 SSL ，可以考慮免費的 Let’s Encrypt。

這次寫接收資訊最有用的一篇，是：Line Bot 開發教學，基礎範例程式碼 (PHP) – 輕量版 LINEBotTiny.php

應該說，作者的 git hub 上有提供了完整範例的檔案，只要替換掉自己機器人的 Channel access token 跟 Channel secret，基本上就可以運作了。非常感謝作者！讓我省了很多摸索的時間！而且範例中提供了很多種類的回應方式，都可以直接參考！

因為這個機器人主要是要收到用戶輸入字數，然後要把用戶跟字數都存到資料庫中。字數還好，用戶 id 這個就比較難取得了。

範例中有對應接受 event 的程式碼，於是我就把接收到的訊息抓下來，看一下究竟怎麼抓到用戶 id。

抓到的內容範例如下圖：（也可以參考公式API資料：LINE Developers）

主要就有看到一行是：”userId”: “U4af4980629…” 在 source 節點下。所以照著程式範例的寫法，取得 ID 的程式碼就是：

$getsource = $event[‘source’];
$usr_id = $getsource[‘userId’];

請放在 $client = new LINEBotTiny($channelAccessToken, $channelSecret); 這行之後。

取得這個之後就沒什麼問題了！有 userId 之後，就可以根據不同用戶記錄資料，並且回應各自的資料統計回去給用戶。

資料庫的設定也跳過不說。接下來是分析用戶輸入的資料，基本上考慮到電腦版也方便使用（尤其大家寫稿都用電腦），所以圖形選單或是按鈕就不考慮了（電腦版不支援），所以基本上幾乎都是使用到文字訊息的部份。

先決定好需要存哪些資訊，然後設定好一些制式的指令，比如說要記錄今天的字數，我的設定是「今日 142」，要補登的話是「補 2020-05-03 100」，怎麼設定就是各人喜好，我是把「動作」放第一個，後面才是自己決定的參數內容。

接收到文字訊息事件之後，要分析資料內容就不難了，就是切切貼貼比對比對而已，會寫 php 的人對這個都沒難度，不然就是用 google 也可以找到方法！當然別忘了也要寫防呆的訊息，避免亂測試造成資料庫存了一堆垃圾，影響到後續的統計資料等等。

排程發訊息

需求中有想要每天定時發提醒記錄、寫文的訊息，這個功能分成兩部分：(1) 主動發訊息給所有人 (2) 定時

因為決定也是要用 php 去執行發訊息這個功能（這樣才方便取得自己資料庫記錄的所有人的 userId），網路上找找找之後參考了這篇：用 PHP 實現 Line Message API 接收系統訊息

有看的朋友應該就會發現，是的，這位作者也有範例提供！我拿來參考的是中後半段的 push.php。這次要改的地方比較多，把原本取得 Id 的方式改成我自己的資料庫，並存成 array，組合訊息也依照時間不同（每天兩次，早上跟晚上），要另外擷取各個用戶前一天跟當天的字數登記總和。

不過這倒是不算難，因為是獨立的 php 程式，就跟之前的程式放一起，使用已經寫好的 function 就可以了。

難的是「如何能夠排程執行這隻 php」。這個花了我好多時間去做測試！找了很久，最後發現網站空間中有提供crontab 這個功能，這是利用網站的伺服器定期執行指令的功能。

這雖然在 cPanel 上有設定介面，但要輸入的指令我也是測試了好久，最後終於測試出來是：「wget -q 要執行的網頁網址」，定時的時間設定我的空間是有介面用選的。

wget 其實是抓取網頁資料，但這時候也等於是執行該網頁內容，取巧來使用。指令的參數可以參考這個頁面：wget 指令、 Linux – crontab排程啟動本地PHP網頁

其他及最後成果

記錄一下其他算滿有用的資料：

line sticker 編號：https://devdocs.line.me/files/sticker_list.pdf
可以使用的預設貼圖就這些，要填寫的話要參考這個。

在輸入文字訊息回應之後，我還加了隨機鼓勵話語跟隨機的貼圖，覺得很難被發現但玩得很愉快。

我的成果圖如下，接下來就是等一些朋友幫我測試之後就開給朋友用啦！

這篇其實也真的沒寫到什麼，大概就是把我覺得有用的參考網頁給記錄下來，下次要改的話就可以使用了！

歷史上的今天

Author: 魚ㄦ

愛好玩新東西的魚。從2000年開始擁有自己的空間開始，玩過大大小小的網路程式，從CGI到php，從網站到blog。之前架過 TatterTools、TextCube，2011年開始接觸 Wordpress 之後定居，但現在還是新人。工作上每天接觸程式語言，生活中接觸各種各樣事情。記錄生活、創作、喜好、廢。轉Likecoin贊助我！

View all posts by 魚ㄦ →

14 Comments

最舊

最新最多投票

Inline Feedbacks

View all comments

Hank

4 年前

想請問，最近剛接觸line bot用php開發，今日 100 或是補2020…這種的關鍵字，資料和動作之間是怎麼用程式去區隔的呢？

回應

魚ㄦ

文章發表者

回應 Hank

4 年前

上面的範例程式中（下載的），裡面有分析文字的 text.php，我在這邊多做了一些改造。
這邊收得使用者敲的內容是：$message[‘text’]
接下來就是分解而已，比如說使用者打「今日 500」，使用 php 的 explode 指令去切字串成array，然後再去分解每一個去做對應就可以了。
我的內容是這樣：

$strMsg = $message['text']; //取得輸入的字串
$str_sec = explode(" ",trim($strMsg)); //切成array（用" "隔開）
$msg_header = $str_sec[0];//首字

$msg_count = count($str_sec); //切割後有幾個
switch ($msg_header) { //根據首字來決定後續動作
	
	case 'test':
		$reply_word_msg = 'Hellp world';
		break;
	case "今日":
       //當首字是「今日」的時候，後續動作是把後面的數存去資料庫
		$reply_word_msg = $LINEBotWords->todayword($str_sec,$msg_count,$usr_id);
		break;
}

簡單說就是這樣XD
這算是最簡單的方法吧～

回應

Hank

4 年前

哦！大概了解！那想請問連接php資料庫的程式你是寫在每個function裡還是直接寫在example.php那個統一連接呢？另外想問方便留甚麼聯絡方式能更即時的詢問你嗎？(FB、LINE等等)可能會想要多跟你請教程式的問題

回應

魚ㄦ

文章發表者

回應 Hank

4 年前

重複使用的我都會另外寫成一隻 php 程式，然後在需要連接的程式中 require，這樣比較方便。要寫其他程式的時候可以直接把這一段拆開來用。
如果你就只有這一個程式也是可以寫在一起，只是分開的話，就是屬於自己的程式庫會比較方便。
聯絡方式的話抱歉因為一些事情不能提供，加上 php 我是完全自學，觀念都不見得正確。blog裡面大概也是給自己做記錄而已XD 有需要可以繼續討論的:D

回應

Hank

4 年前

好的，我剛剛在測試的時候發現有錯誤，給你看一下我多加的這幾段程式碼，再麻煩你幫我看一下!

回應

魚ㄦ

文章發表者

回應 Hank

4 年前

我php也是自學沒多久啊XD 其實我blog只是記錄我自己的生活，並不算是程式語言的…XD
我建立database的元件是用POD…給你做參考～

public function tryopenDB()
	{
		//==============DB設定=============
		$host='localhost';
		$root_name='root_name';
		$root_password='root_password';
		$database_name='database_name'; //主DB設定
		$dsn = "mysql:dbname=". $database_name .";host=". $host .";port=3306";
		//==============DB設定=============
		date_default_timezone_set("Asia/Taipei");
		// open db
		try {
		   // 建立MySQL伺服器連接和開啟資料庫 
		   $link = new PDO($dsn, $root_name, $root_password);
		   // 指定PDO錯誤模式和錯誤處理
		   $link->setAttribute(PDO::ATTR_ERRMODE, 
		                PDO::ERRMODE_EXCEPTION);
           $link->query('SET NAMES utf8');
		   //echo "成功建立MySQL伺服器連接和開啟". $database_name ."資料庫"; 
		} catch (PDOException $e) {
		   echo "連接失敗: " . $e->getMessage();
		}		
		return $link;
	}

回應

Hank

4 年前

這是編譯錯誤的

回應

魚ㄦ

文章發表者

回應 Hank

4 年前

另外就是建議先練習普通開關資料庫跟寫入動作，php 的語法好像不大對？sql 的語法中 $user_id 這應該是帶入的，那應該是要用 . 來做連接而不是直接帶入。

select * from line_user where line id=’$usr_id’

這種寫法是表示要找 line id （首先sql欄位應該是不能有空白的吧？）等於 “$usr_id” 這個字串，而不是這個變數吧？

回應

Hank

4 年前

好的，我目前打算先把整體LINE的功能做完再來研究資料庫QQ，請問我照著你的切割下去分析之後，為甚麼會沒有回覆呢?

$strMsg = $message['text']; //取得輸入的字串
$str_sec = explode(" ",trim($strMsg)); //切成array（用" "隔開）
$msg_header = $str_sec[0];//首字
if (strtolower($$msg_header['text']) == "tdee"){
  $client->replyMessage(array(
    'replyToken' => $event['replyToken'],
    'messages' => array(
      array(
        'type' => 'text', // 訊息類型 (文字)
        'text' => '請輸入年齡' // 回復訊息
      )
    )
  ));
}

回應

Hank

回應 Hank

4 年前

不好意思，我解決了！但我還是想問一下我把$msg_header在丟回去給$message[‘text’]，雖然是成功，會不會有bug的疑慮呢?

回應

魚ㄦ

文章發表者

回應 Hank

4 年前

我不是很清楚您指的bug是什麼？他就是你切出來的首字字串，bug是指？

回應

Hank

4 年前

請問一下這兩段取得userID的程式，抓出來的id是字串嗎?

$getsource = $event[‘source’];
$usr_id = $getsource[‘userId’];

我在測試寫進資料庫的時候會出現錯誤，後來我把寫進資料庫的程式碼單獨拉出來，
user id我用隨便一個字串去代替，執行後是可以成功新增資料的，所以我在想是不是userID格式的問題
我後來也有測試用$usr_id去作加好友之後馬上回覆，也是跑不出來，請問怎麼解決呢?
下面是我寫進資料庫的程式碼

$client = new LINEBotTiny($channelAccessToken, $channelSecret);
$getsource = $event['source'];
$usr_id = $getsource['userId'];
require_once 'dbtools.inc.php';
$link = create_connection();//建立資料連結
$sql = "SELECT * FROM user where linid = '{$usr_id}'";
$result = execute_sql($link, "energey3_db", $sql);
mysqli_error($link);
if(mysqli_num_rows($result) > 0)
{
	mysqli_free_result($result);
}
else
{
	mysqli_free_result($result);
	
	$sql = "INSERT INTO user (lineid) VALUES('{$usr_id}')";
	$result = execute_sql($link, "energey3_db", $sql);
}
mysqli_close($link);

回應

魚ㄦ

文章發表者

回應 Hank

4 年前

如果想知道是不是字串，可以試著把那兩個變數 echo 出來。可以另外寫成記錄擋記錄你抓到的東西。這樣你才比較清楚你抓到了什麼。我的只是我根據 API 上的文件去抓到的，所以你也可以參考 API 上的文件。
另外我有注意到您的php語法跟我學的不一樣（我只是自學），所以我不確定是否有幫助：

$sql = "INSERT INTO user (lineid) VALUES('{$usr_id}')";

我會寫成

$sql = "INSERT INTO user (lineid) VALUES('" . $usr_id ."')";

但這也只是我學的是這樣，如果您學的是不一樣的那請依照您學的為主。
我在測試中如果有錯誤會一直把可能相關的語句 echo 出來，這可以提供您參考。因為環境不一樣寫法也不同，單單只看您的錯誤訊息我不清楚您遇到的問題是什麼。
您可以再google是否有跟您遇到一樣的問題～或許比問我有用^^

回應

Hank

回應 Hank

4 年前

PHP Warning:  mysqli_num_rows() expects parameter 1 to be mysqli_result, boolean given in /home2/energey3/public_html/example_bot.php on line 57

PHP Warning:  mysqli_free_result() expects parameter 1 to be mysqli_result, boolean given in /home2/energey3/public_html/example_bot.php on line 63

 Request failed: {"message":"The request body has 1 error(s)","details":[{"message":"May not be empty","property":"messages[0].text"}]}

第一個和第二個錯誤是寫進資料庫出現的錯誤
第三個是我測試用$usr_id去在加入好友這個動作時回覆userID

回應

「strst」於〈留言板〉發佈留言
「魚ㄦ」於〈[WP 外掛] NextGEN Gallery 魚ㄦ流使用小心得〉發佈留言
「Jerry」於〈[WP 外掛] NextGEN Gallery 魚ㄦ流使用小心得〉發佈留言
「魚ㄦ」於〈[開箱] HOBONICHI 2020年 day-free〉發佈留言
「gerlin」於〈[開箱] HOBONICHI 2020年 day-free〉發佈留言
「魚ㄦ」於〈關於我的脫逃記錄〉發佈留言
「Clover」於〈關於我的脫逃記錄〉發佈留言
「塵世中迷茫的小書僮」於〈作品上架電子書店囉！〉發佈留言
「魚ㄦ」於〈作品上架電子書店囉！〉發佈留言
「塵世中迷茫的小書僮」於〈作品上架電子書店囉！〉發佈留言

申請、設定機器人

資料分析

排程發訊息

其他及最後成果

歷史上的今天

相關文章

Author: 魚ㄦ