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

1. 概述:

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

image.png

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

 

1.1 準備事項

申請微信公衆號

微信公衆號申請連接:https://mp.weixin.qq.com/cgi-bin/loginpage?t=wxm2-login&lang=zh_CNc++

image.png

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

購買華爲彈性雲服務安全

華爲彈性雲服務購買連接:https://console.huaweicloud.com/ecm/?region=cn-east-2#/ecs/createVm服務器

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

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

image.png

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

image.png

2. 操做步驟:

2.1 基礎軟件安裝

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

升級默認Python版本

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

一、  查看Python版本,使用命令:

python --version


image.png

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

wget https://www.python.org/ftp/python/3.6.0/Python-3.6.0a1.tar.xz

image.png

三、  解壓安裝包,使用命令:

tar xvf Python-3.6.0a1.tar.xz

image.png

四、  執行命令:

./configure

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

image.png

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

image.png

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

sudo yum install gcc-c++

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

image.png

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

五、  執行命令:

make && make install

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

image.png

六、  查看python3版本,使用命令:

<span style="color:#333333">  python3 --version</span>

image.png

七、  再使用命令:

<span style="color:#333333">   python3</span>

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

image.png

升級默認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>

 

image.png

二、從新執行命令:

<span style="color:#333333">  make && make install</span>

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

image.png

三、升級pip3,使用命令:

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

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

image.png

安裝Web.py框架

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

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

image.png

安裝WinSCP

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

WinSCP安裝連接:https://winscp.net/eng/docs/lang:chs

2.2 上傳代碼

一、新建main.py文件,拷貝以下代碼:

# -*- coding: utf-8 -*-
# filename: main.py
import web
from handle import Handle
 
urls = (
    '/wx', 'Handle',
)
 
if __name__ == '__main__':
    app = web.application(urls, globals())
    app.run()

二、新建handle.py文件,拷貝以下代碼:

# -*- coding: utf-8 -*-
# filename: handle.py
 
import hashlib
import web
import receive
import time
import 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

三、新建receive.py文件,拷貝以下代碼:

# -*- coding: utf-8 -*-
# filename: receive.py
import 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

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

$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>

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

image.png

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

image.png

2.3 啓動服務

使用以下命令啓動服務:

python3 main.py 80

未報錯,則說明啓動成功,參考以下:

image.png

2.4 啓用開發者模式

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

image.png

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

image.png

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

image.png

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

image.png

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

2.5 驗證

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

image.png

相關文章
相關標籤/搜索