基本过程
在开发微信公众平台前,需要申请一个微信公共账号,此处不做赘述,笔者使用的微信公共账号名称为:"IBM蓝色精英",代号为:"IBM_BluElite"。如何申请微信公共账号,笔者不做赘述。
在 Bluemix 中开发微信公众平台主要包括如下步骤:
-
申请 Bluemix 账号
-
下载并安装 Cloud Foundry 程序
-
编制一个应用的配置文件
-
在微信公众平台设置为开发模式
-
设置一个基于 Bluemix 的网址 URL
-
设置微信公众平台应用的令牌(Token)
-
下载微信公众平台的范例程序,笔者采用 PHP 语言,对该程序进行修改,设置令牌(TOKEN)
-
上传(push)PHP 文件,应用开始执行
-
在微信公众平台中,验证通过编辑模式。
-
利用手机微信,向微信公众平台发送信息,获得微信公众平台返回的信息。
至此,基于 Bluemix 的微信公众平台应用开发顺利完成,开发者可以在此基础上进行进一步的发展。
图 1.系统框架
过程描述
-
申请 Bluemix 账号
进入网址:www.bluemix.net
图 2
-
下载并安装 Cloud Foundry 程序
进入网址:https://github.com/Cloud Foundry/cli
图 3
根据开发者的程序操作系统下载对应的程序。
图 4
例如笔者下载地址是: Stable Installers 下的"Windows 64 bit"
下载了一个文件,该文件为 installer-windows-amd64 .zip
安装该文件后,在 C:\Program Files (x86)\Cloud Foundry 下产生了一个 cf.exe 文件。同时经过检查发现,在系统的 PATH 路径中,也增加了该目录,也就是说可以直接在 DOS COMMAND 环境下输入 CF 命令执行该文件。
-
编制一个应用的配置文件
文件名为:manifest.yml 作为一个应用,需要设置应用的名称、应用产生的网址,范例的文件为:
---
applications:
- name: cf-php-mysql1
memory: 256M
instances: 1
host: lzhfirstphp
domain: ng.bluemix.net
path: .
buildpack: https://github.com/dmikusa-pivotal/cf-php-build-pack.git
说明:
name 指定了应用的名称
host 指定了应用的扩展域名,如上面的范例文件则生成域名:
lzhfirstphp. ng.bluemix.net
其他不做变动,修改完成后,将文件保存。
编制该文件有三个注意事项:
-
文件格式需要指定为 UTF-8 的格式
-
设置应用名称时,需要注意不能重复。
-
设置 HOST 名称时,尽可能长一些,或者按照个人姓名、公司名称进行设置,笔者上传部署时曾经出现过错误,估计是名称重复,后来修改后,部署成功。
-
在微信公众平台设置为开发模式
进入微信公众平台,登录后,进入高级功能,设置开始开发模式。
图 5
图 6
在微信公众平台接口中,设置对应的 URL 及令牌。
图 7
-
设置一个基于 Bluemix 的网址
在 URL 中设置网址,注意此处的形式必须与前面设置的一致。
-
设置微信公众平台应用的令牌(token)
设置一个令牌信息,该令牌信息是由自己指定的,一般采用特别的字符进行,以保证安全性。
-
下载微信公众平台的范例程序,笔者采用 PHP 语言,对该程序进行修改,设置令牌(token)等相关信息。开发者可以在微信公众平台开发者文档中下载 DEMO 文件。
图 8
清单 1
<?php
/**
* wechat php test
*/
//define your token
define("TOKEN", "weixin");
$wechatObj = new wechatCallbackapiTest();
$wechatObj->valid();
class wechatCallbackapiTest
{
public function valid()
{
$echoStr = $_GET["echostr"];
//valid signature , option
if($this->checkSignature()){
echo $echoStr;
exit;
}
}
public function responseMsg()
{
//get post data, May be due to the different environments
$postStr = $GLOBALS["HTTP_RAW_POST_DATA"];
//extract post data
if (!empty($postStr)){
$postObj = simplexml_load_string($postStr, 'SimpleXMLElement', LIBXML_NOCDATA);
$fromUsername = $postObj->FromUserName;
$toUsername = $postObj->ToUserName;
$keyword = trim($postObj->Content);
$time = time();
$textTpl = "<xml>
<ToUserName><![CDATA[%s]]></ToUserName>
<FromUserName><![CDATA[%s]]></FromUserName>
<CreateTime>%s</CreateTime>
<MsgType><![CDATA[%s]]></MsgType>
<Content><![CDATA[%s]]></Content>
<FuncFlag>0</FuncFlag>
</xml>";
if(!empty( $keyword ))
{
$msgType = "text";
$contentStr = "Welcome to wechat world!";
$resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time,
$msgType, $contentStr);
echo $resultStr;
}else{
echo "Input something...";
}
}else {
echo "";
exit;
}
}
private function checkSignature()
{
$signature = $_GET["signature"];
$timestamp = $_GET["timestamp"];
$nonce = $_GET["nonce"];
$token = TOKEN;
$tmpArr = array($token, $timestamp, $nonce);
sort($tmpArr, SORT_STRING);
$tmpStr = implode( $tmpArr );
$tmpStr = sha1( $tmpStr );
if( $tmpStr == $signature ){
return true;
}else{
return false;
}
}
}
?>
在这个文件中,有三处需要改动:
第一:设置 TOKEN
define("TOKEN", "abcdefg123");//第一处修改
这里的数值,需要与前面网页中的 Token 的设置严格一致。
第二:这个范例程序中只是设置了验证模式,而没有消息的响应处理,笔者将该文件进行了修改,当存在验证参数时进行验证,而不存在验证信息时,则调用响应方法。
if ( $_GET["echostr"] )
{
$wechatObj->valid();
}
else
{
$wechatObj->responseMsg();
}
第三:在范例程序中,对输入信息进行了一点处理,设置为返回信息。
$contentStr = "Welcome to wechat world!".$keyword;
也就是将微信粉丝输入的信息,加上"Welcome to wechat world!"后返回。
另外需要注意的是该 PHP 文件的编码也必须是 UTF-8 的。上传(push)PHP 文件,如果上传正确,则等待应用执行。
该文件名指定必须与前述的配置文件完全一致。
在正常的配置结束后,就可以在 Bluemix 中看到该应用,该应用处于正常运行的状态。
图 9
-
cf api https://api.ng.bluemix.net
-
cf login
此处输入申请的用户邮件、密码,执行至运行结束。
-
cf push -f manifest.yml
-
在微信公众平台中,点击提交,系统会提示验证通过。如果提示验证不通过,需要检查 URL、Token、程序中的 Token 以及程序代码的正确性。
另外,需要注意的是,腾讯要求服务器响应必须在 5 秒以内,因此在网络环境不够好的情况下,也许需要多提交几次才可以完成。
特别需要注意的是,笔者曾经进行过新浪的微博开发,新浪微博开发可以采取本地服务器,一样可以验证通过,而腾讯的这种验证必须使用外部可以访问的网址,笔者曾经为此很困扰,而且腾讯的验证必须使用 80 端口,不支持 URL 带端口号,这也曾经困扰过笔者。幸而 IBM 的 Bluemix 平台可以支持。
-
利用手机微信,向微信公众平台发送信息,获得微信公众平台返回的信息。
设置成功后,例如手机微信关注该微信公众平台账号,例如笔者的"正海说知识创新",账号:"zhszscx"关注的方法可以是名称查询、代号查询,也可以扫描如下的二维码,进行体验。
想该账号发送:hello!
将会收到系统返回的:Welcome to wechat world! hello!
这就表示基于 Bluemix 的微信公众平台开发顺利完成。
开发中注意事项
对于前面开发中介绍到的可能出现问题的地方再做一些总结:
-
正确设置 HOST 名称,不可以重复。
-
HOST 名称加上域名,需要和微信公众平台中的 URL 相匹配。
-
程序中的 Token 的设置必须同微信公众平台中的设置相匹配。
-
配置文件必须使用 UTF-8 格式。
-
Index.php 程序文件格式必须使用 UTF-8 格式。
-
系统未做说明,但是默认采用的是 index.php 文件作为入口,也就是说,如果按本文所叙述的程序编制方法,利用域名访问时,将没有结果展示。
-
在微信公众平台提交时,可能显示失败,需要提交多次,知道显示成功。
另外需要说明的是,目前的程序只对文本型微信信息进行了回复,其他信息未做处理。而开发者如果在开发中需要变更程序,则需要再次 PUSH 就可以,但是不需要在微信编辑模式再次提交。
发展展望
笔者在前述的基础上,又增加了数据库的链接,主要是 MYSQL 服务的建立、MYSQL 服务与应用的绑定,在 PHP 程序文件中实现服务的参数调用,数据表的创建、插入、显示,成功实现了数据库的处理,另外也成功部署了基于 PHP 的网站形式的应用,有了这样的基础,说明可以利用 IBM 的 Bluemix 平台实现开发微信公共账号应用。
笔者同时也必须要说明的是,本文只是对 Bluemix 的一个入门级应用的简要总结,算是抛砖引玉,对于 Bluemix 还只是冰山一角,有待更多研究,希望与广大开发者合作共进