Python微信公衆號教程基礎篇——收發文本消息

Python微信公衆號教程基礎篇——收發文本消息

1. 概述：

在本篇教程中，你將學會使用華爲雲彈性雲服務器（如下簡稱 ECS）搭建微信公衆號處理後臺，使用Python語言編寫對應的微信消息處理邏輯代碼，接收從微信服務端轉發過來的消息，並返回處理結果給最終用戶。整個處理流程以下圖所示：

您須要瞭解的背景知識有： CentOS（Linux）操做系統、PHP語言、Web.py框架、HTTP/XML協議。

1.1 準備事項

申請微信公衆號

微信公衆號申請連接：mp.weixin.qq.com/cgi-bin/log…

考慮到申請便利性，本教程中使用訂閱號「雲圖說」爲例說明。

購買華爲彈性雲服務

華爲彈性雲服務購買連接：console.huaweicloud.com/ecm/?region…

若是沒有華爲雲帳號，需先註冊華爲雲帳號並完成實名認證。

本教程中，使用公共鏡像CentOS 7.4

建議同時購買彈性IP，後面須要再微信公衆號上配置服務地址須要公網IP。

2. 操做步驟：

2.1 基礎軟件安裝

本教程中使用Python+Web.py組合完成微信公衆號開發，須要安裝以下軟件：

升級默認Python版本

CentOS 7.4自帶Python版本比較老，建議升級到Python3。

一、 查看Python版本，使用命令：

<span style="color:#333333">  python --version</span>複製代碼

二、 下載Python安裝包，這裏以Python 3.6.0版本爲例，使用命令：

<span style="color:#333333">  wget https://www.python.org/ftp/python/3.6.0/Python-3.6.0a1.tar.xz</span>複製代碼

三、 解壓安裝包，使用命令：

<span style="color:#333333">  tar xvf Python-3.6.0a1.tar.xz</span>複製代碼

四、 執行命令：

<span style="color:#333333">  ./configure</span>複製代碼

執行成功出現相似以下提示：

若是出現相似「configure: error: no acceptable C compiler found in $PATH」提示，是由於未安裝合適的編譯器。

解決方法：安裝/升級gcc及其餘依賴的包，使用命令:

<span style="color:#333333">  sudo yum install gcc-c++</span>複製代碼

並在隨後提示安裝包是否OK是，輸入y並回車。出現相似以下提示說明依賴的包安裝成功：

再從新執行./configure 命令便可。

五、 執行命令：

<span style="color:#333333">  make && make install</span>複製代碼

執行成功，提示pip錯誤，緣由是個人系統中少了openssl-devel包，能夠先忽略。

六、 查看python3版本，使用命令：

<span style="color:#333333">  python3 --version</span>複製代碼

七、 再使用命令：

<span style="color:#333333">   python3</span>複製代碼

出現相似以下提示，則說明python3安裝成功。

升級默認pip版本

pip通用的 Python 包管理工具。提供了對 Python 包的查找、下載、安裝、卸載的功能。Python3安裝成功後自帶pip3，但版本比較老，建議升級到pip最新版本。同時前面安裝python3提示「Ignoring ensurepip failure: pip 8.1.1 requires SSL/TLS」錯誤，致使pip未成功安裝。

一、先安裝openssl-devel包，使用命令：

<span style="color:#333333"> yum install openssl-devel -y</span>複製代碼

二、從新執行命令：

<span style="color:#333333">  make && make install</span>複製代碼

出現以下提示說明安裝pip成功：

三、升級pip3，使用命令：

<span style="color:#333333">  pip3 install --upgrade pip</span>複製代碼

出現以下提示說明升級pip到最新版本了：

安裝Web.py框架

這裏爲和微信公衆技術平臺教程保持一致，也使用Web.py框架。Web.py官方教程地址：webpy.org/，使用以下命令安裝web.py：

<span style="color:#333333">pip3 install web.py==0.40.dev0</span>複製代碼

安裝WinSCP

一般狀況下，咱們在本地Windows操做系統上編輯代碼，完成後再上傳至彈性雲服務器上（CentOS Linux系統）。WinSCP 是一個 Windows 環境下使用的 SSH 的開源圖形化 SFTP 客戶端, 同時支持 SCP 協議。它的主要功能是在本地與遠程計算機間安全地複製文件，而且能夠直接編輯文件。

WinSCP安裝連接：winscp.net/eng/docs/la…

2.2 上傳代碼

一、新建main.py文件，拷貝以下代碼：

<span style="color:#333333"># -*- coding: utf-8 -*-# filename: main.pyimport webfrom handle import Handle urls = ( '/wx', 'Handle',) if __name__ == '__main__': app = web.application(urls, globals()) app.run()</span>複製代碼

二、新建handle.py文件，拷貝以下代碼：

<span style="color:#333333"># -*- coding: utf-8 -*-# filename: handle.py import hashlibimport webimport receiveimport timeimport os class Handle(object): def __init__(self): self.app_root = os.path.dirname(__file__) self.templates_root = os.path.join(self.app_root, 'templates') self.render = web.template.render(self.templates_root) def GET(self): try: data = web.input() if len(data) == 0: return "hello, this is handle view" signature = data.signature timestamp = data.timestamp nonce = data.nonce echostr = data.echostr token = "此處內容與公衆號基本配置裏Token字段取值保持一致" list = [token, timestamp, nonce] list.sort() s = list[0] + list[1] + list[2] hashcode = hashlib.sha1(s.encode('utf-8')).hexdigest() print( "handle/GET func: hashcode, signature: ", hashcode, signature) if hashcode == signature: return echostr else: return echostr except (Exception) as Argument: return Argument def POST(self): try: webData = web.data() print("Handle Post webdata is:\n", webData) #打印消息體日誌 recMsg = receive.parse_xml(webData) if isinstance(recMsg, receive.Msg) and recMsg.MsgType == 'text': toUser = recMsg.FromUserName fromUser = recMsg.ToUserName content = "歡迎關注雲圖說！" + str(recMsg.Content) print('Reply message info:\n') print('toUser =', toUser) print('fromUser = ', fromUser) print('content = ', content) return self.render.reply_text(toUser, fromUser, int(time.time()), content) else: print("不支持的消息類型：",recMsg.MsgType) return "success" except (Exception) as Argment: return Argment</span>複製代碼

三、新建receive.py文件，拷貝以下代碼：

<span style="color:#333333"># -*- coding: utf-8 -*-# filename: receive.pyimport xml.etree.ElementTree as ET def parse_xml(web_data): if len(web_data) == 0: return None xmlData = ET.fromstring(web_data) msg_type = xmlData.find('MsgType').text if msg_type == 'text': return TextMsg(xmlData) elif msg_type == 'image': return ImageMsg(xmlData) elif msg_type == 'location': return LocationMsg(xmlData) elif msg_type == 'event': return EventMsg(xmlData) class Event(object): def __init__(self, xmlData): self.ToUserName = xmlData.find('ToUserName').text self.FromUserName = xmlData.find('FromUserName').text self.CreateTime = xmlData.find('CreateTime').text self.MsgType = xmlData.find('MsgType').text self.Eventkey = xmlData.find('EventKey').text class Msg(object): def __init__(self, xmlData): self.ToUserName = xmlData.find('ToUserName').text self.FromUserName = xmlData.find('FromUserName').text self.CreateTime = xmlData.find('CreateTime').text self.MsgType = xmlData.find('MsgType').text self.MsgId = xmlData.find('MsgId').text class TextMsg(Msg): def __init__(self, xmlData): Msg.__init__(self, xmlData) self.Content = xmlData.find('Content').text class ImageMsg(Msg): def __init__(self, xmlData): Msg.__init__(self, xmlData) self.PicUrl = xmlData.find('PicUrl').text self.MediaId = xmlData.find('MediaId').text class LocationMsg(Msg): def __init__(self, xmlData): Msg.__init__(self, xmlData) self.Location_X = xmlData.find('Location_X').text self.Location_Y = xmlData.find('Location_Y').text class EventMsg(Msg): def __init__(self, xmlData): Event.__init__(self, xmlData) self.Event = xmlData.find('Event').text</span>複製代碼

四、新建templates文件夾，在文件夾下新建reply_text.xml文件，拷貝以下代碼：

<span style="color:#333333">$def with (toUser,fromUser,createTime,content)<xml><ToUserName><![CDATA[$toUser]]></ToUserName><FromUserName><![CDATA[$fromUser]]></FromUserName><CreateTime>$createTime</CreateTime><MsgType><![CDATA[text]]></MsgType><Content><![CDATA[$content]]></Content></xml></span>複製代碼

五、最終本地代碼文件造成以下：

經過WinSCP工具將上述文件與目錄上傳至彈性雲服務指定目錄下：

2.3 啓動服務

使用以下命令啓動服務：

<span style="color:#333333">python3 main.py 80</span>複製代碼

未報錯，則說明啓動成功，參考以下：

2.4 啓用開發者模式

一、公衆平臺官網登陸以後，找到「開發」——>「基本配置」菜單欄，點擊「修改配置」。

二、填寫URL與Token取值，EncodingAESKey能夠隨機生成，加解密方式簡單起見使用「明文模式」，點擊「提交」。參考以下：

三、在彈出的提示框中，點擊「肯定」。

四、驗證token成功，點擊啓用。

備註：若是token驗證失敗，請檢查Token取值配置與handle.py中GET消息處理代碼。

2.5 驗證

使用微信關注公衆號，任意發送一條文本消息，看是否可以收到回覆。出現以下回復則代表系統處理正常。