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 验证

使用微信关注公众号，任意发送一条文本消息，看是否可以收到回复。出现以下回复则代表系统处理正常。