node-wechat 微信实践
jopen
9年前
node-wechat
从去年开始微信开发越来越火了，体现在sdk和h5上（h5如果大家想听，可以回复），这里就简单介绍一下sdk开发
既然是noder，那肯定要用nodejs写，不然会被鄙视的。
node-webot简介
node-webot是老朴几个人建的org，主要开发微信sdk相关的node modules
地址 https://github.com/node-webot/
- wechat 微信公共平台消息接口服务中间件
- weixin-robot 微信公共帐号自动回复机器人 A Node.js robot for wechat.
- wechat-oauth 授权
- wechat-api Wechat API/主动调用API
wechat sdk开发常用包
- wechat-oauth
- wechat-api（菜单，消息回复等）
- wx_jsapi_sign（js-sdk）
创建菜单
wxapi.js
var API = require('wechat-api'); var config = require('config'); var menu_config = config.get('wx.wx_menu'); var app_id = config.get('wx.app_id'); var app_secret = config.get('wx.app_secret'); //配置 var api = new API(app_id, app_secret); //测试 function app(){ api.createMenu(menu_config, function(err, result){ console.log(result); }); } module.exports = app;把数据放到配置文件中
config/default.json
{ "domain": "xxxxxxxx.com", "is_debug": true, "mongodb": { "host": "127.0.0.1", "port": "27017", "db": "node-webot" }, "sms": { "host": "127.0.0.1", "port": "5001" }, "wx": { "app_id": "wx04014b02asdsfdsfsf", "app_secret": "cc4c224b50fkjlksdafkldfsakljsdfk", "wx_menu": { "button": [ { "name": "菜单", "sub_button": [ { "type": "view", "name": "资讯菜单", "url": "http://ip:port/all" } ] }, { "name": "菜单2", "sub_button": [ { "type": "view", "name": "我的11", "url": "http://ip:port/all" } ] }, { "name": "助理", "sub_button": [ { "type": "view", "name": "大学", "url": "http://ip:port/all" }, { "type": "view", "name": "社区", "url": "http://ip:port/all" } ] } ] } } }oauth
使用微信的用户，或者绑定微信账号
微信有一个唯一的id是openid，它是辨别的唯一标识。
routes/weixin.js
// 微信授权和回调 var client = new OAuth(app_id, app_secret); // 主页,主要是负责OAuth认真 router.get('/', function(req, res) { var url = client.getAuthorizeURL('http://' + domain + '/weixin/callback','','snsapi_userinfo'); res.redirect(url) }) /** * 认证授权后回调函数 * * 根据openid判断是否用户已经存在 * - 如果是新用户，注册并绑定，然后跳转到手机号验证界面 * - 如果是老用户，跳转到主页 */ router.get('/callback', function(req, res) { console.log('----weixin callback -----') var code = req.query.code; var User = req.model.UserModel; client.getAccessToken(code, function (err, result) { console.dir(err) console.dir(result) var accessToken = result.data.access_token; var openid = result.data.openid; console.log('token=' + accessToken); console.log('openid=' + openid); User.find_by_openid(openid, function(err, user){ console.log('微信回调后，User.find_by_openid(openid) 返回的user = ' + user) if(err || user == null){ console.log('user is not exist.') client.getUser(openid, function (err, result) { console.log('use weixin api get user: '+ err) console.log(result) var oauth_user = result; var _user = new User(oauth_user); _user.username = oauth_user.nickname; _user.nickname = oauth_user.nickname; _user.save(function(err, user) { if (err) { console.log('User save error ....' + err); } else { console.log('User save sucess ....' + err); req.session.current_user = void 0; res.redirect('/user/' + user._id + '/verify'); } }); }); }else{ console.log('根据openid查询，用户已经存在') // if phone_number exist,go home page if(user.is_valid == true){ req.session.current_user = user; res.redirect('/mobile') }else{ //if phone_number exist,go to user detail page to fill it req.session.current_user = void 0; res.redirect('/users/' + user._id + '/verify'); } } }); }); });上面的简单介绍一下
wx_jsapi_sign(nodejs)
wx_jsapi_sign = wechat(微信) js-api signature implement.
- 支持集群，将获得的前面写到cache.json里
- 使用cache.json保存，比如用redis省事，更省内存
- 足够小巧，便于集成
Install
npm install --save wx_jsapi_sign
Usage
copy config file
cp node_modules/wx_jsapi_sign/config.example.js config.js
change appId && appSecret
then mount a route in app.js
var signature = require('wx_jsapi_sign'); var config = require('./config')(); .... app.post('/getsignature', function(req, res){ var url = req.body.url; console.log(url); signature.getSignature(config)(url, function(error, result) { if (error) { res.json({ 'error': error }); } else { res.json(result); } }); });more usages seetest/public/test.html
Test
微信访问网址http://yourserver.com:1342/test
原作者博客
我为什么要重写这个模块？
微信签名7200秒可以查看一次，所以就要考虑缓存问题
- wx_jsapi_sign是一个开源项目，使用redis作为缓存，思路挺好，但依赖redis，还是有点重，没必要
- xinshangshangxin写的模块使用cache.json做缓存，然后把获取的时间保存到配置文件里，每次请求只要读取文件即可。这个思路非常好，依赖少，省内存，简单，支持集群
那哥们写的已经很不错了，但是有几个问题
- 他不太了解如何写通用模块（复用程度比较低）
- 代码比较乱（抽取了配置，很好，但想art-template之类的都混在里面看的人顿时头大）
- 没有发布到npm上
如果各位想了解是如何做的，请移步http://www.github.com/i5ting/wx_jsapi_sign
- 依赖管理（区分模块依赖的，还是开发阶段依赖的）
- npmjs.org上如何发布模块
配置文件实际
上面的微信的菜单，db连接，还是wx_jsapi_sign都是基于配置的，使用配置文件会有一些问题
比如config.json作为配置文件，你需要在版本控制里放一个config.example.json，然后把config.json放到.gitinore里。
然后每个使用的人，需要先拷贝一个config.example.json为config.json。
这样做的好处
- 敏感信息不能提交上去
- 部署服务器的时候，不会冲突（比如配置文件里有一个is_debug选项，服务器上必须是false，而开发阶段是要用true的）
另外配置文件格式，推荐json和yaml，而不是js，不要在配置文件了写逻辑，虽然没问题，但实为陋习。
纠正一下价值观
很多人都认为现在啥模块都有了，随便找一个用就可以了，但这种想法是危险的
- 第一件事儿是思考，而不是想找一个随便xx
- 不要造重复的轮子，除非必要（先到github或相关网站上找对应模块，要有可以修改对应模块源码的能力）
- 反身而诚，乐莫大焉
全文完
欢迎关注我的公众号【node全栈】来自：http://my.oschina.net/nodeonly/blog/476894