linux+apache+mod_python+wechat_sdk搭建微信公共账号服务器

linux+apache+mod_python+wechat_sdk搭建微信公共账号服务器

PRE

最近尝试了下使用python搭建微信公共账号服务器，实现了简单的消息收发功能。其中遇到了很多问题，特此记录下来。

服务器的选择

如果使用python做开发语言，一般选用以下几种服务器可以用来做微信公共账号服务器(如果不全，欢迎大家补充)：

• SAE + wsgi
• apache + mod_python
• apache + mod_wsgi
• nginx + wsgi

如果对使用独立的服务器没有需求，或者对apache和nginx的配置不熟悉，一般采用SAE + wsgi做服务器。由于手头正好有闲置的Apache，本着生命在于折腾，从折腾中学习的目的，我选择了apache + mod_python作为我的服务器。以下的内容均以此为背景。 在后面的开发过程中我体会到，我的这个选择绝对是最折腾人的 = 。=

sdk的选择

除了微信官方的sdk外，github上找到两个第三方sdk：

• wechat-python-sdk
• WeRoBot

这两个sdk各有优劣，wechat-python-sdk代码更简洁易懂，而WeRoBot功能更全,包含微信支付API操作类等wechat-python-sdk不具有的功能。本次我选择使用了wechat-python-sdk

服务器搭建与配置

首先操作系统我选择的是放在阿里云上的centos 5.10 需要安装如下软件包：

• apache 我选用的是httpd-2.4.10
• expat expat是用来解析xml等文件的库，我选用的是expat-2.0.1.tar.gz
• apr  Apache Portable Runtime 我选用的是apr-1.5.1.tar.gz
• apr-util 我选用的是apr-util-1.5.4.tar.gz
• prce  Perl Compatible Regular Expressions  我选用的是pcre-8.36.tar.gz 。 上述expat，apr,apr-util,prce均为安装Apache时的依赖项，注意各软件包的版本，如果不一致可能导致不兼容的问题。
• mod_python Apache处理python的模块，我选用的是mod_python-3.5.0.tgz
• python-devel mod_python的安装依赖项，我选用的是python-devel-2.6.6-52.el6.x86_64，应和系统使用的python版本一致。
• python-pip python库安装工具，用来安装wechat-sdk
• wechat-sdk 微信平台第三方sdk
• virtualenv(可选)  virtualenv的简介
  

  首先安装各软件包

  为了统一和方便，我把所有软件包都安装到了/usr/local下，均为编译安装。 
  以下是部分安装配置命令

#pcre
./configure --prefix=/usr/local/pcre
#apr
./configure --prefix=/usr/local/apr
#apr-util
./configure --prefix=/usr/local/apr-util --with-apr=/usr/local/apr --with-expat=/usr/local/expat/#apache
./configure --prefix=/usr/local/apache --with-expat=/usr/local/epxat --with-apr=/usr/local/apr --with-apr-util=/usr/local/apr-util --with-pcre=/usr/local/pcre/或者
./configure --prefix=/usr/local/apache --with-expat=/usr/local/epxat --with-apr=/usr/local/apr --with-apr-util=/usr/local/apr-util --with-pcre=/usr/local/pcre/#mod_python
./configure --prefix=/usr/local/mod_python --with-apxs=/usr/local/apache/bin/apxs

除wechat-sdk外，安装命令均为 make && make install 。wechat-sdk安装方法为 pip install wechat-sdk

配置apache

<Directory "/usr/local/apache/htdocs/daemon/webchat">SetHandler mod_python
PythonHandler index
PythonDebug OnOrder allow,deny
Allow from all</Directory>

在 <IfModule alias_module> 下面添加

Alias /mywechat "/usr/local/apache/htdocs/daemon/webchat/mywechat.py"

功能开发

1. 首先在你登录微信公共账号，并点击成为开发者后，系统会让你验证你的服务器配置，这时微信公共平台服务器会向你的系统发送一个GET请求，来验证你的服务器，你需要按照微信制定的规则来返回验证信息。
2. 当验证通过后，微信普通用户向你发送消息时，普通用户会发送给你的服务器一个POST请求，这个请求将请求内容包含在一个xml文档中。 
   简单来说，你需要处理这两种正常请求。此外，在你公共账号投入商业使用之前，还需要能够处理别人伪造的非法请求，从而避免信息被窃取。

示例代码

index.py

#encoding:utf-8from mod_python import apacheimport osdef handler(req):handler = req.uri[req.uri.rfind('/')+1:]if handler[-3:] == ".py" :
handler = handler[0:-3]if not handler == "index" :
req.add_handler("PythonHandler", handler);else:
req.write("using the default handler : index")return apache.OK

mywechat.py

# -*- coding: utf-8 -*-#!/usr/bin/pythonfrom mod_python import apachefrom mod_python import utilimport osfrom wechat_sdk import WechatBasicimport sysimport _apache
parse_qsl = _apache.parse_qsldef handler(req):req.no_cache=Truewechat = WechatBasic(token='yourtoken')if req.method == "GET":
req.content_type = "text/plain"args=req.args
apache.log_error("get req caught!!!")
check(req,wechat)elif req.method == "POST":
req.content_type = "text/xml"apache.log_error("post req caught!!!")
parse(req,wechat)else:
apache.log_error("unknown req method")return apache.OKdef check(req,wechat):parameters = util.FieldStorage(req)
apache.log_error(str(parameters))
signature = parameters.get('signature',None)
timestamp = parameters.get('timestamp',None)
nonce = parameters.get('nonce',None)
echostr = parameters.get('echostr','')if wechat.check_signature(signature=signature, timestamp=timestamp, nonce=nonce):
apache.log_error("check succeed")
req.write(echostr)return apache.OKelse:
apache.log_error("check failed")return apache.HTTP_UNAUTHORIZEDdef parse(req,wechat):#get request bodytry:
clen = int(req.headers_in["content-length"])except (KeyError,ValueError):raise apache.SERVER_RETURN(apache.HTTP_LENGTH_REQUIRED)
req_body = req.read(clen)
apache.log_error(req_body)#parse bodytry:
wechat.parse_data(req_body)
message = wechat.get_message()
response = Noneif message.type == 'text':if message.content == 'wechat':
response = wechat.response_text('^_^')else:
text=u'text'response = wechat.response_text(text.encode('utf-8') + message.content.encode('utf-8'))elif message.type == 'image':
response = wechat.response_text('image')elif message.type == 'subscribe':
response = wechat.response_text('welcome to mywechat!!!')else:
response = wechat.response_text('unknown'+message.type)
req.write(response)
apache.log_error(response)except Exception as e:
apache.log_error("\n\n@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@\n\n")
apache.log_error(str(e))
apache.log_error("\n\n@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@\n\n")

这样简单的demo就Ok了！ 你可以拿起手机给自己的公共账号发消息来测试了！

tips

1. mod_python比较蛋疼的一个地方就是，很多时候出错了它在log里只说一句：Segment Fault.....，根本就没什么用，所以你需要在可能出现异常的地方将它们捕获，并用 apache.log_error(str(e)) 将错误信息输出到log中。
2. 实际安装过程中，遇到了很多由于expat不兼容而出现的问题，而官方又没有说明，所以我在这上面花了很多时间。实际上centos 5.10系统中预装了expat，但配置Apache安装项时，指定系统的expat的时候总会报错，所以决定自己编译安装expat。mod_python使用过程中，会加载pyexpat.so,而我的系统中pyexpat.so仅支持版本为2.0.1的expat。由于pyexpat.so为python安装包内的内容，我们无法更改，所以我们只能安装版本为2.0.1的expat来解决这个问题。
3. 使用这种方式实际使用时我还遇到了这个错误“symbol XML_SetHashSalt, version EXPAT_2_0_1_RH not defined in file libexpat.so.1 with link time reference”，通过strings libexpat.so.1.5.2 |grep expat -i 我发现我安装的expat中不包含“EXPAT_2_0_1_RH”这个字段，而系统自带的则包括。 
   解决方法是

   cd d /usr/local/expat/lib
   ln -s /lib64/libexpat.so.1.5.2 libexpat.so.1.5.2

   这个解决方法很不漂亮，但是目前没找到别的解决办法。

useful links

1. 微信公共平台开发者文档
2. 微信公众平台 Python 开发包文档
3. modpython官方文档
4. python_publisher对post请求content-type的限制
5. logging with modpython
6. 解决expat版本兼容问题IssuesWithExpatLibrary

TODO

文字编码问题还没有解决，当前环境无法给用户发送中文消息

本文原作者：FignerLiu