3.4 开发第一个应用
当你决定进行微信公众平台开发时,有一件最重要的事情摆在你面前——申请公众账号和相关接口。在等待微信官方审核的过程中,我们可以利用微信公众平台提供的测试账号进行开发。
3.4.1 下载PHP SDK
微信公众平台提供了多个接口,而网上也有很多开源的微信公众平台PHP SDK。作为一个开发者,“重复造轮子”实现所有接口不是明智之举。最好根据自身的用途(是否商用、是否再分发)选择合适的开源软件。这里推荐几个:
(1)https://github.com/spetacular/weixin本书作者开发的SDK,采用MIT License。
(2)https://github.com/zemzheng/WeChatPHP-SDK采用MIT License。
(3)https://github.com/dodgepudding/wechat-php-sdk采用GNU LGPL version 2.1 License。
本书采用第一个SDK。如果读者电脑上装有git,可以复制一份:git clone https://github.com/spetacular/weixin.git。
或者单击项目主页右下角的Download Zip直接下载,下载地址为:https://github.com/spetacular/weixin/archive/master.zip。
解压后的代码结构如下:
- README.md使用说明。
- api.php公众平台消息接口。
- defaultweixin.php扩展逻辑实现。
- weixin.class.php微信接口实现类。
- weixin.config.php微信配置文件。
3.4.2 微信公众平台接口测试账号申请
微信公众平台提供了测试账号,在公众账号没审核之前也能进行开发。网址为:http://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login。
进入登录界面,会看到如图3-39所示的页面。
左边是一个二维码,用微信扫一扫后会自动登录。如果页面放置一段时间后再登录,微信扫一扫后出现错误提示,如图3-40所示。
图3-39
图3-40
因为这个二维码是带时间参数的临时二维码,时间过期后会失效,第8章会详细说明如何实现。
右侧提供了手机短信验证码的登录方式,此处不再赘述。
登录后出现测试号的管理页。这里重要的信息是测试号信息中的appID和appsecret,访问接口时需要用到。接口配置信息URL是服务器地址中公众平台消息接口的网址,Token是与微信服务器约定的密码,如图3-41所示。
图3-41
3.4.3 上传服务器
在上传服务器之前需要修改weixin.config.php里的配置项,包括appID、appsecret和Token。
<?php define('APPID','APPID'); //这里的APPID替换为你的appID define('APPSECRET','APPSECRET'); //这里的APPSECRET替换为你的appsecret define('TOKEN','Token'); //这里的TOKEN请与接口配置信息里的Token保持一致 ?>
将代码上传到服务器上,这时如果api.php的网址是http://www.example.com/api.php,那么测试管理页的URL就填写http://www.example.com/api.php,如图3-42所示。
图3-42
单击“提交”按钮,微信服务器会自动验证接口和签名是否正确。验证过程就像装电脑主机时连各种各样的线一样,能连上就是正确的。如果正确,那么修改生效,恭喜已接入开发者模式。如果提示配置失败,就要检查各个配置项是否正确。
3.4.4 扫描二维码
扫描测试公众号的二维码并关注,就能在管理测试页看到用户列表,如图3-43所示。
图3-43
PHP SDK默认的用户消息处理方法是返回用户发送的信息,也就是“鹦鹉学舌”,如图3-44所示。
图3-44
至此,一个简单的应用就完成了。