微信公众平台开发入门教程（图文） - 贝创工作室-php手册-php.cn

关键字：微信公众平台开发入门

作者：贝创工作室

背景知识：微信公众平台的开发需要有一定的PHP基础知识，PHP是一种HTML内嵌式的语言，广泛用于网站开发。微信服务器和开发者的服务器间有两种数据传输方式，分别是XML和JSON。其中XML主要用在接受发送普通消息和事件推送中，而用户管理、创建自定义菜单和高级群发等则需要用到JOSN格式数据。

在这篇微信公众平台开发教程中，你可以跟着教程一起在整体上感性了解微信公众平台的开发框架，可以帮助你更好的去入手。

我们将使用微信公众账号西安校园创客空间作为讲解的例子，二维码见底部。

这个入门教程将引导你学会完成如下任务：

申请新浪云计算并创建平台应用
申请虚拟主机及为微信平台搭建环境
进入微信公众平台开发模式与接入服务器
接口的调用与常用功能的实现

第一节

申请新浪云计算并创建平台应用

创建新浪云计算SAE应用引擎
申请新浪云账号
如果我们使用SAE新浪云计算平台作为服务器资源，并且申请PHP环境+MySQL数据库作为程序运行环境。
则申请地址为：
http://www.sinacloud.com/
直接点击上述网址，可以看到右上角微博登录的链接。
点击进入之后，使用新浪微博账号进行登录
登录之后，按照提示注册个人信息即可。
创建新应用
回到首页，在菜单顶部选择控制台，再选择云应用SAE
进入SAE应用列表
点击下侧的创建新应用，这时会弹出提示，禁止放置违法违规内容，点击继续创建，弹出如下窗口。
选择一个未使用的appid，如果老是已经被使用不知道该什么好，就填写你的QQ号或者手机号吧。
填写二级域名AppID、应用名称、验证码，开发语言选择PHP5.3，全部应用和框架下面选择第一个【PHP 空应用】。然后点击左下方的创建应用
应用创建成功。并自动跳转到应用列表中，可以看到已经有刚才创建的西安校园创客空间这个应用。
创建版本
点击刚才创建的应用名称，进入应用主页。
点击左侧的应用管理下面的代码管理，
在代码管理中，选择使用SVN托管的方式。
跳转到代码管理
点击右侧的“创建版本”
我创建的是520，但是版本号默认为1，输入后点击创建，会弹出安全登录，需要输入安全密码，如果不知道或者忘记了，就点里面的找回密码，重新设置一下就行了。
验证通过之后，如下所示
到这里，就成功创建了一个域名URL为 http://1.xaxymaker.applinzi.com/ 的应用了，记住你的这个URL，后面开发模式接入时将会用到。
上传代码
下述代码是一个微信接口文件，看不懂没有关系，你把代码拿去直接用就行了，后面你可能慢慢会明白！

 1 php  2 //判断用户发送消息类型 贝创工作室 CopyRight 2016  3  4  5 define("TOKEN", "weixin");  6 // $conn=mysql_connect('localhost','job','G2yI2zFR'); // 使用数据表 a_news  7 // mysql_select_db('sqljob',$conn);  8 // mysql_query("SET NAMES 'UTF8'");  9 // mysql_query("SET CHARACTER SET UTF8"); 10 // mysql_query("SET CHARACTER_SET_RESULTS=UTF8'"); 11 12 $wechatObj = new wechatCallbackapiTest(); 13 if (!isset($_GET['echostr'])) { 14 // $wechatObj->responseMsg(); 15 $wechatObj->responseMsg(); 16 // $test->jianyan(); 17 }else{ 18 $wechatObj->valid(); 19 } 20 21 class wechatCallbackapiTest 22 { 23 public $fromUsername=''; 24 public $toUsername=''; 25 public function valid() 26 { 27 $echoStr = $_GET["echostr"]; 28 if($this->checkSignature()){ 29 echo $echoStr; 30 exit; 31 } 32 } 33 34 private function checkSignature() 35 { 36 $signature = $_GET["signature"]; 37 $timestamp = $_GET["timestamp"]; 38 $nonce = $_GET["nonce"]; 39 $token = TOKEN; 40 $tmpArr = array($token, $timestamp, $nonce); 41 sort($tmpArr, SORT_STRING); 42 $tmpStr = implode($tmpArr); 43 $tmpStr = sha1($tmpStr); 44 45 if($tmpStr == $signature){ 46 return true; 47 }else{ 48 return false; 49 } 50 } 51 52 public function responseMsg(){ 53 $postStr = $GLOBALS["HTTP_RAW_POST_DATA"]; 54 $postObj = simplexml_load_string($postStr, 'SimpleXMLElement', LIBXML_NOCDATA); 55 $fromUsername = $postObj->FromUserName; 56 $toUsername = $postObj->ToUserName; 57 $type = $postObj->MsgType; 58 $event=$postObj->Event; 59 $Event_Key=$postObj->EventKey; 60 $mid=$postObj->MediaId; 61 $link=$postObj->Url; 62 63 $latitude = $postObj->Location_X; 64 $longitude = $postObj->Location_Y; 65 $keyword = trim($postObj->Content); 66 $time = time(); 67 $textTpl = " 68  69  70 %s 71  72  73 "; 74 if($keyword!=''){ $contentStr=$keyword;} 75 elseif($type=="image"){$contentStr="您发送的是图片消息,消息的MediaId是".$mid;} 76 elseif($type=="voice"){$contentStr="您发送的是语音消息,消息的MediaId是".$mid;} 77 elseif($type=="video"){$contentStr="您发送的是视频消息,消息的MediaId是".$mid;} 78 elseif($type=="location"){$contentStr="您发送的是地理位置消息,您的地理位置是：经度".$latitude."维度：".$longitude;} 79 elseif($type=="link"){$contentStr="您发送的是链接消息,消息链接为".$link;} 80 elseif($type=="event" && $event=="subscribe"){$contentStr="欢迎关注西安校园创客空间的微信公众账号，带你进入奇妙有趣的微信公众号开发之旅";} 81 elseif($type="event" && $event=="unsubscribe"){$contentStr="期待您再次关注西安校园创客空间微信公众账号。";} 82 else{echo "";} 83 84 $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $contentStr); 85 echo $resultStr; 86 87 } 88 89 } 90 91 92 ?>

Copy after login

我们将使用上述代码与微信公众平台对接。

将上述代码用专业的软件存为utf-8格式的index.php文件后再使用WinRAR压缩为index.zip，或者关注西安校园创客空间微信公众号免费获取为您打包好的丰富微信公众平台开发代码与开发教程。
回到SAE的代码管理界面中。
再选择“上传代码包”，点击上传文件，选择刚才的index.zip文件，点击上传，上传成功后中间是一个绿色的横条，如下所示
如果没有绿色的横条，表示上传失败，需要重试。可以考虑在Chrome浏览器下重试一下。
点击编辑代码按钮，
有时候需要输入自己的安全密码，如果不记得了就点击“找回密码”。
安全验证成功后继续之前的操作。
我们可以看到index.php已经上传成功，双击可以查看编辑里面的代码
新浪云应用的创建就成功了。
充值（本步骤可选择性进行）
新浪云SAE实行的是配额免费+超额付费的方式，相关标准请查看SAE价格体系介绍。初期对于大部分用户来说免费配额已够用，如果您将来使用量比较大建议预先至少充值100元获得10000云豆，以免超额后应用被禁用而影响业务。

第二节申请虚拟主机及为微信平台搭建环境

申请虚拟主机

这里我使用的是云邦互联的虚拟空间为大家作以演示，首先，打开网站如下图：

然后在右上角按照提示注册即可，选择使用1G的免费空间。

2、开通空间之后打开控制面板，就可以看到主机信息了。

3、接下来我们用8uftp登陆虚拟空间。

4、登录之后，用8uftp将 index.php 文件上传到虚拟空间的根目录中的web文件夹下，如下：

至此，你使用虚拟空间为微信公众平台搭建服务器就成功了，后续只要将实现相应功能的代码通过8uftp上传上去即可。

第三节启用开发模式与接入服务器

微信公众平台开发模式

高级功能

微信公众平台地址：https://mp.weixin.qq.com

登录微信公众平台后台，在左侧列表中最下方，找到“ 基本配置 ”，点击进入

进入服务器配置填写框。

点击“修改配置”按钮，则出现下图。

此处的URL为上篇中介绍的云应用的域名，而Token在index.php中定义为weixin。EncodingAESKey则不用填，点击“随机生成”让自动生成一个，消息加解密方式选择“明文模式”，然后点击“提交”按钮。

在弹出的提示框中，点击“确定”

配置修改后如图所示，再点击“启用”按钮

询问“是否确定开启服务器配置”，点击“确定”

如果提示“token验证失败”，可以先重次几次，微信服务器有时候不稳定。注：如果使用新浪SAE可能要求进行实名认证，请先上传身份证进行实名认证并通过审核后再试！

如果还是失败，请先用微信调试器测试一下url和token是否正确。（直接在百度搜索会有好多免费的哦）

1. 成功启用后如上图。
  这使的你是否有一股兴奋与惊喜，你已经成功的启用微信开发模式。

第四节接口的调用与常用功能的实现

示例1：API调用之百度翻译

申请百度翻译API接口

下面介绍如何使用百度翻译 API 制作拥有翻译功能的公众账号。

1、首先，登陆申请成为百度开发者，申请链接地址为 http://developer.baidu.com/ 。申请成为开发者之后，登陆该网站，在管理控制台的下拉菜单中选择开发者服务管理，如下图所示。

我们通过调用百度翻译的API可以实现英文翻译中文，中文翻译英文，中文翻译日文，日文翻译中文。目前百度AIP支持这三种语言的翻译
首先进入百度翻译的网页，网站如下箭头所示
进入后点击“使用指南”
进入使用智能页面后，网下浏览页面，在页面中间部分，即可看到百度翻译的API接口
根据上面的接口，我们可以构建接口代码：

http://openapi.baidu.com/public/2.0/bmt/translate?client_id=uA6zT1kh5O1UXvTrUuFjFHiK&q={$keyword}&from=auto&to=auto

“9peNkh97N6B9GGj9zBke9tGQ”这一串为自己的百度密钥，在百度的应用中心单击基本信息可以看到
关键代码为：

case "text";

$tranurl="http://openapi.baidu.com/public/2.0/bmt/translate?client_id=uA6zT1kh5O1UXvTrUuFjFHiK&q={$keyword}&from=auto&to=auto";//百度翻译地址

$transtr=file_get_contents($tranurl);//读入文件

$transon=json_decode($transtr);//json解析

//print_r($transon);

$contentStr = $transon->trans_result[0]->dst;//读取翻译内容

break;
登录手机微信，最后实现的结果如下：

所用代码如下：

 1 php  2 // 百度翻译 贝创工作室 CopyRight 2016   3 define("TOKEN", "weixin");  4 $wechatObj = new wechatCallbackapiTest();  5 if (!isset($_GET['echostr'])) {  6 $wechatObj->responseMsg();  7 }else{  8 $wechatObj->valid();  9 } 10 11 class wechatCallbackapiTest 12 { 13 public $fromUsername=''; 14 public $toUsername=''; 15 public function valid() 16  { 17 $echoStr = $_GET["echostr"]; 18 if($this->checkSignature()){ 19 echo $echoStr; 20 exit; 21  } 22  } 23 24 private function checkSignature() 25  { 26 $signature = $_GET["signature"]; 27 $timestamp = $_GET["timestamp"]; 28 $nonce = $_GET["nonce"]; 29 $token = TOKEN; 30 $tmpArr = array($token, $timestamp, $nonce); 31 sort($tmpArr, SORT_STRING); 32 $tmpStr = implode($tmpArr); 33 $tmpStr = sha1($tmpStr); 34 35 if($tmpStr == $signature){ 36 return true; 37 }else{ 38 return false; 39  } 40  } 41 42 public function responseMsg(){ 43 $postStr = $GLOBALS["HTTP_RAW_POST_DATA"]; 44 $postObj = simplexml_load_string($postStr, 'SimpleXMLElement', LIBXML_NOCDATA); 45 $fromUsername = $postObj->FromUserName; 46 $toUsername = $postObj->ToUserName; 47 $type = $postObj->MsgType; 48 $event=$postObj->Event; 49 $Event_Key=$postObj->EventKey; 50 $mid=$postObj->MediaId; 51 $link=$postObj->Url; 52 53 $latitude = $postObj->Location_X; 54 $longitude = $postObj->Location_Y; 55 $keyword = trim($postObj->Content); 56 $time = time(); 57 $textTpl = " 58   59   60  %s 61   62   63 "; 64 if($keyword!=''){ 65 $id="R90FXoW4OPtCbLkD9Aiaihz0"; 66 $url="http://openapi.baidu.com/public/2.0/bmt/translate?client_id=$id&q=$keyword&from=auto&to=auto"; 67 $res=file_get_contents($url); 68 $res=json_decode($res,true); 69 $contentStr=$res['trans_result'][0]['dst']; 70 } $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $contentStr); 71 echo $resultStr; 72  } 73 } 74 ?>

Copy after login

示例2：API调用之小黄鸡

1、注册simsimi 账号

URL:http://developer.simsimi.com/signUp

2、激活账号

3、获取API Key

4、具体实现

调用小黄鸡API 实现

调用simsim($keyword) 函数处理，将其中的“Your API Key” 换成申请到的API Key。

//小黄鸡 贝创工作室 CopyRight 2016 public function simsim($keyword){ $key="41250a68-3cb5-43c8-9aa2-d7b3caf519b1"; $url_simsimi="http://sandbox.api.simsimi.com/request.p?key=".$key."&lc=ch&ft=0.0&text=".$keyword; $json=file_get_contents($url_simsimi);　　// 把整个文件读入一个字符串中 $result=json_decode($json,true);　　// 对JSON 格式的字符串进行编码 //$errorCode=$result['result'];　　// 调试用 $response=$result['response'];　　// 回复的消息 if(!empty($response)){ return $response; }else{ $ran=rand(1,5); switch($ran){ case 1: return "小鸡鸡今天累了，明天再陪你聊天吧。"; break; case 2: return "小鸡鸡睡觉喽~~"; break; case 3: return "呼呼~~呼呼~~"; break; case 4: return "你话好多啊，不跟你聊了"; break; case 5: return "感谢您关注西安校园创客空间"."\n"."微信号：xaxymaker"."\n"; break; default: return "感谢您关注西安校园创客空间"."\n"."微信号：xaxymaker"."\n"; break; } } }