WeRoBot 1.10.0 微信公众号开发框架文档

• 语言: 英语
• 格式: .epub
• 来源: werobot.readthedocs.io

摘要

文档主要介绍了WeRoBot 1.10.0微信公众号开发框架的功能和使用方法。内容涵盖了消息处理、自定义菜单、素材管理、用户管理、账户管理、模板消息等功能模块。文档还详细说明了版本更新、与Django、Flask等框架的集成、Session管理、消息加解密、错误处理以及部署运行的相关配置。此外，文档提到了对不同版本Python和Django的支持，以及使用Supervisor和Nginx进行生产环境部署的建议。

AI总结

《WeRoBot 1.10.0 微信公众号开发框架文档》总结如下：

### 1. 框架概述
WeRoBot 是一个用于微信公众号开发的高性能Python框架，支持消息处理、自定义菜单、会话管理、素材管理等功能，适用于开发微信公众号机器人。

### 2. 核心功能
- **消息处理**：支持文本、图片、链接、位置、语音、视频等多种消息类型，可自定义消息处理器。
- **自定义菜单**：支持创建、查询和删除自定义菜单，提供灵活的菜单管理能力。
- **会话管理**：支持开启/关闭会话，使用Session记录用户状态，提供多种存储方案（如SQLite、FileStorage）。
- **消息加解密**：支持微信消息的加密和解密功能。
- **集成支持**：支持与Django、Flask、Bottle、Tornado等Web框架集成，适应多种开发场景。

### 3. 部署与运行
- **独立服务器部署**：支持在独立服务器上运行，推荐使用Gunicorn等高性能服务器。
- **SAE部署**：支持在SAE（Server App Engine）上部署，适合云服务环境。
- **WSGI支持**：提供WSGI应用接口，支持通过Nginx进行反向代理。

### 4. 版本更新
- **1.10.0版本**：
- 增加了多种事件处理器（如地理位置选择事件、商品审核结果推送事件）。
- 完善了`WeRoBot.Client`类的API文档。
- 修复了打包时的错误页面问题、直接GET访问主页返回500的问题。
- 支持Python 3.6+，优先使用`secrets.choice`生成token。
- 增加了`werobot.session.mysqlstorage.MySQLStorage`，支持MySQL存储。
- 增加了`video`和`shortvideo`修饰器，完善消息处理能力。
- 修复了`werobot.client.Client.get_media_list()`的调用参数错误。
- 支持Django 2.0，不再支持Django 1.8及以下版本。

### 5. 使用建议
- **日志管理**：Handler中的异常会以Error级别记录到日志中，便于排查问题。
- **性能优化**：WSGIRef性能较差，仅适合开发环境；生产环境建议使用Gunicorn等高性能服务器。
- **进程管理**：推荐使用Supervisor管理WeRoBot进程，确保服务稳定运行。

### 6. 快速入门
- **Hello World示例**：

  import werobot

  robot = werobot.WeRoBot(token='tokenhere')

  @robot.handler
  def hello(message):
      return 'Hello World!'
  
  robot.run()

- **消息处理示例**：

  @robot.text
  def echo(message):
      return message.content
  
  @robot.image
  def handle_image(message):
      return '收到图片消息'

### 7. 返回码说明
- **48001**：API未授权，需检查AppID和AppSecret是否正确。

### 总结
WeRoBot 1.10.0版本功能完善，支持多种消息类型和事件处理，适合开发微信公众号机器人。框架提供灵活的部署方式和强大的扩展性，适用于个人开发者和企业级应用。