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

转载请注明本文原作者：FignerLiu

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

首先将Apache配置为自启动服务，可参考这篇文章
服务启动成功后，在浏览器输入你的服务器ip,可看到如下It works! 字样,则表示Apache安装成功。接下来修改Apache配置文件，打开文件/usr/local/apache/httpd.conf,分别在对应位置添加如下配置
在<Directory "/usr/local/apache/htdocs">下面添加

<Directory "/usr/local/apache/htdocs/daemon/webchat">

    SetHandler mod_python

    PythonHandler index

    PythonDebug On

    Order allow,deny

    Allow from all

</Directory>

在<IfModule alias_module>下面添加

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

上面的配置的意思是：1.告诉Apache，目录/usr/local/apache/htdocs/daemon/webchat将使用mod_python处理客户端请求，所有请求交给这个目录下的index.py来处理；2.告诉Apache，为路径/usr/local/apache/htdocs/daemon/webchat/mywechat.py起了个别名，当客户端访问/mywechat的时候，实际上就是在访问/usr/local/apache/htdocs/daemon/webchat。
注，上述配置需要设置了DocumentRoot为/usr/local/apache/htdocs才有效

功能开发

接下来我们只需要向index.py和mywechat.py中添加对应的请求处理逻辑即可！
我们实现最简单的功能，即接收服务器请求，并给客户端发送消息。
要完成这一步，我们首先要了解我们都可能收到哪些请求，以及这些请求的作用。

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

示例代码

index.py

#encoding:utf-8

from mod_python import apache

import os

def 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/python

from mod_python import apache

from mod_python import util

import os

from wechat_sdk import WechatBasic

import sys

import _apache

parse_qsl = _apache.parse_qsl

def handler(req):

        req.no_cache=True

        wechat = 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.OK

def 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.OK

        else:

                apache.log_error("check failed")

                return apache.HTTP_UNAUTHORIZED

def parse(req,wechat):

        #get request body

        try:

                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 body

        try:

                wechat.parse_data(req_body)

                message = wechat.get_message()

                response = None

                if 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

mod_python比较蛋疼的一个地方就是，很多时候出错了它在log里只说一句：Segment Fault.....，根本就没什么用，所以你需要在可能出现异常的地方将它们捕获，并用apache.log_error(str(e))将错误信息输出到log中。
实际安装过程中，遇到了很多由于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来解决这个问题。
使用这种方式实际使用时我还遇到了这个错误“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

TODO

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