微信公众号开发（一）服务器及接口的配置

编程小6 (4) 2024-04-19 13:12

Hi，大家好，我是编程小6，很荣幸遇见你，我把这些年在开发过程中遇到的问题或想法写出来，今天说一说微信公众号开发（一）服务器及接口的配置,希望能够帮助你!!!。

微信公众号开发（一）服务器及接口的配置

关于微信公众号中的订阅号和服务的区别这里不多加讨论，网上有很多资源可以搜到，这里直接进入正题，如果是个人开发者，这里建议使用测试号进行开发学习，测试号的权限要比个人订阅号要多的多，而本篇博客也是基于测试号进行开发的。

在开始微信号开发之前需要准备好两样东西，1、需要一个测试号，2、需要一个拥有域名的服务器，下面将分别介绍怎样获取这两样东西。

1、测试号

点击此链接测试号登录可直接用微信扫一扫注册一个测试号，相应的界面如下所示

进入测试号界面之后可以获得一些开发所需要的东西，以及关注者列表和开发权限等，如下所示

2、服务器

微信号开发需要一个第三方服务器来和微信服务器沟通，这里我使用的是一个百度云的BAE虚拟主机，理由有以下几点：

1、性价比高，该主机一天只需要2毛钱，而且不限制充值金额，如果你只是用来学习微信公众号开发，而且预计一个月学会的话，那么你只需要充值6元钱就可以，相比其他最低充值一年的平台相比，要划算的多。

2、可以免去购买域名的费用，该BAE可免费设置一个二级域名，可用于微信公众号开发，并且数据库的使用也是免费的。

3、该BAE的代码可以使用git或svn管理，我们在本地写好代码之后，直接push上去就可以了，相当方便，而且可以设置快捷发布，提交代码当即发布。

缺点就是它的日志系统不够完善，不过这个缺点很容易解决，我们可以自己打印信息到文件里，然后读取出来，下面将会介绍到。

百度云网址是:https://login.bce.baidu.com/?account=，登录之后，点击BAE后如图

好了，这样我们就准备好了微信开发的两个必备的东西。接下来就要配置接口了。

3、配置接口

上面进入测试号界面的时候我们可以看到有一个接口配置信息的模块，如下所示

这里的URL就是填写以上BAE中的域名就好了，当然了要注意加上http://前缀，以后用户发送的消息都会经过微信服务器转发到该接口。Token可以随便填写一些东西，这里填写了weixin。关于Token的用途下面会讲到。

好了，现在先别急着点击提交，因为我们还没有在URL指向的服务器里编写任何的代码，还不能正确响应微信服务器的请求。

在编写任何的代码之前，我先说一下本博客的一些习惯，为了便于理解，我会先将文件的结构和代码先贴出来，然后才解释具体代码的含义，这样如果熟悉的人就可以直接跳过该部分了。

文件结构如下

index.php用于处理消息。

output_log.php和output_query.php分别用来输出post过来的数据和请求的查询字符串，Utils.php主要用来将数据输出到文件中，看了下面的代码你就明白了，其实相当简单，这三个东西是我用来调试用的，相比起微信公众号提供的在线调试接口而言（需要设置一堆的信息），我觉得这样更加简单。

Utils.php，提供了两个函数，traceHttp()将请求的时间、远程主机地址和查询字符串输出到query.xml文件中。logger()将类型、时间和post数据输出到log.xml中。

<?php
class Utils
{
    public static function traceHttp()
    {
        $content = date('Y-m-d H:i:s')."\n\rremote_ip：".$_SERVER["REMOTE_ADDR"].
            "\n\r".$_SERVER["QUERY_STRING"]."\n\r\n\r";
        $max_size = 1000;
        $log_filename = "./query.xml";
        if (file_exists($log_filename) and (abs(filesize($log_filename))) > $max_size){
            unlink($log_filename);
        }else {

        }
        file_put_contents($log_filename, $content, FILE_APPEND);
    }

    public static function logger($log_content, $type = '用户')
    {
        $max_size = 3000;
        $log_filename = "./log.xml";
        if (file_exists($log_filename) and (abs(filesize($log_filename)) >
                $max_size)) {
            unlink($log_filename);
        }
        file_put_contents($log_filename, "$type  ".date('Y-m-d H:i:s')."\n\r".$log_content."\n\r",
            FILE_APPEND);
    }
}

output_query.php，输出query.xml的内容

<?php
@header('Content-type: text/plain;charset=UTF-8');
$filepath = './query.xml';
readfile($filepath);

output_log.php，输出log.xml的内容。

<?php
@header('Content-type: text/plain;charset=UTF-8');
$filepath = './log.xml';
readfile($filepath);

是不是非常简单，然后我们开始写处理消息index.php

<?php
//设置时区
date_default_timezone_set("Asia/Shanghai");
//定义TOKEN常量，这里的"weixin"就是在公众号里配置的TOKEN
define("TOKEN", "weixin");

require_once("Utils.php");
//打印请求的URL查询字符串到query.xml
Utils::traceHttp();

$wechatObj = new wechatCallBackapiTest();
/**
 * 如果有"echostr"字段，说明是一个URL验证请求，
 * 否则是微信用户发过来的信息
 */
if (isset($_GET["echostr"])){
    $wechatObj->valid();
}else {
    $wechatObj->responseMsg();
}

class wechatCallBackapiTest
{
    /**
     * 用于微信公众号里填写的URL的验证，
     * 如果合格则直接将"echostr"字段原样返回
     */
    public function valid()
    {
        $echoStr = $_GET["echostr"];
        if ($this->checkSignature()){
            echo $echoStr;
            exit;
        }
    }

    /**
     * 用于验证是否是微信服务器发来的消息
     * @return bool
     */
    private function checkSignature()
    {
        $signature = $_GET["signature"];
        $timestamp = $_GET["timestamp"];
        $nonce = $_GET["nonce"];

        $token = TOKEN;
        $tmpArr = array($token, $timestamp, $nonce);
        sort($tmpArr);
        $tmpStr = implode($tmpArr);
        $tmpStr = sha1($tmpStr);

        if ($tmpStr == $signature){
            return true;
        }else {
            return false;
        }
    }

    /**
     * 响应用户发来的消息
     */
    public function responseMsg()
    {
        //获取post过来的数据，它一个XML格式的数据
        $postStr = $GLOBALS["HTTP_RAW_POST_DATA"];
        //将数据打印到log.xml
        Utils::logger($postStr);
        if (!empty($postStr)){
            //将XML数据解析为一个对象
            $postObj = simplexml_load_string($postStr, 'SimpleXMLElement', LIBXML_NOCDATA);
            $RX_TYPE = trim($postObj->MsgType);
            //消息类型分离
            switch($RX_TYPE){
                case "event":
                    $result = $this->receiveEvent($postObj);
                    break;
                default:
                    $result = "unknow msg type:".$RX_TYPE;
                    break;
            }
            //打印输出的数据到log.xml
            Utils::logger($result, '公众号');
            echo $result;
        }else{
            echo "";
            exit;
        }
    }

    /**
     * 接收事件消息
     */
    private function receiveEvent($object)
    {
        switch ($object->Event){
            //关注公众号事件
            case "subscribe":
                $content = "欢迎关注微微一笑很倾城";
                break;
            default:
                $content = "";
                break;
        }
        $result = $this->transmitText($object, $content);
        return $result;
    }

    /**
     * 回复文本消息
     */
    private function transmitText($object, $content)
    {
        $xmlTpl = "<xml>
    <ToUserName><![CDATA[%s]]></ToUserName>
    <FromUserName><![CDATA[%s]]></FromUserName>
    <CreateTime><![CDATA[%s]]></CreateTime>
    <MsgType><![CDATA[text]]></MsgType>
    <Content><![CDATA[%s]]></Content>
</xml>";
        $result = sprintf($xmlTpl, $object->FromUserName, $object->ToUserName, time(), $content);
        return $result;
    }
}

这几个文件写好之后，直接通过git push到BAE上，如果设置了快捷发布，过1、2秒钟就会自动发布了，状态里面会显示绿色的"正常"，如果没有设置快捷发布，上传代码后需要手动点击右边的快捷发布按钮。