微信公众平台PHP开发全教程

微信公众平台分为两种模式：

1. 订阅号：主要用于信息传递和内容创作，功能相对简单。
2. 服务号：提供更多服务和API接口，如微信支付、用户信息获取等，适合企业和组织。

本教程主要面向 服务号 的开发，因为其功能更全面，但大部分基础消息处理逻辑对订阅号同样适用。

第一部分：准备工作

在开始编码之前,你需要完成以下准备工作：

注册公众号

• 访问 微信公众平台官网。
• 使用一个未注册过公众号的邮箱进行注册。
• 根据提示完成身份认证（个人或企业），选择订阅号或服务号。
• 注意：个人主体只能注册订阅号，且部分高级接口（如微信支付）无法使用，企业主体可以注册服务号，功能更全。

获取开发者凭证

• 登录你的公众号后台。
• 在左侧菜单栏找到 “设置与开发” -> “基本配置”。
• 在这里你可以找到：
  • AppID (应用ID)：公众号的唯一标识。
  • AppSecret (应用密钥)：用于获取 Access Token 的密钥，请务必保密！

服务器配置（接入）

这是最关键的一步,用于验证你的服务器是否有效。

• 在 “基本配置” 页面，找到 “服务器配置”。
• 点击 “修改配置”。
• 你需要填写以下信息：
  • URL (服务器地址)：你的服务器上一个能够接收 HTTP POST 请求的 PHP 文件的完整地址。http://yourdomain.com/wechat.php。
  • Token (令牌)：可以任意填写，如 mywechat_token，用于后续验证请求的合法性。
  • EncodingAESKey (消息加解密密钥)：可以随机生成，用于安全地接收和发送消息。
  • 消息加解密方式：选择 “安全模式” 或 “兼容模式”，安全模式要求消息内容都经过加密，兼容模式则明文和加密消息均可，新手建议先选择 “明文模式”，调试成功后再切换到安全模式。

第二部分：接入验证

当你填写完服务器配置并提交后,微信服务器会向你的 URL 发送一个 GET 请求，以验证你的服务器地址，你需要编写 PHP 代码来响应这个请求。

验证逻辑

1. 你的服务器收到 GET 请求，会带上四个参数：signature, timestamp, nonce, echostr。
2. 你需要将 Token (你在后台填写的)、timestamp、nonce 三个参数进行字典序排序。
3. 将排序后的三个参数字符串拼接成一个字符串,并进行 SHA1 加密。
4. 将加密后的字符串与请求中的 signature 进行对比。
5. 如果一致,说明请求来自微信，原样返回 echostr 参数内容，接入成功。

PHP 代码实现 (wechat.php)

<?php
/**
 * 微信公众号接入验证
 */
// 1. 获取微信推送过来的数据
$signature = $_GET["signature"];
$timestamp = $_GET["timestamp"];
$nonce = $_GET["nonce"];
$echostr = $_GET["echostr"];
// 2. 你在后台填写的 Token
$token = "mywechat_token"; // 务必与后台配置的 Token 一致
// 3. 将 token, timestamp, nonce 三个参数进行字典序排序
$tmpArr = array($token, $timestamp, $nonce);
sort($tmpArr, SORT_STRING);
// 4. 将三个参数字符串拼接成一个字符串并进行 SHA1 加密
$tmpStr = implode($tmpArr);
$tmpStr = sha1($tmpStr);
// 5. 开发者获得加密后的字符串可与 signature 对比，标识该请求来源于微信
if ($tmpStr == $signature && $echostr) {
    // 如果是验证请求，则返回 echostr
    echo $echostr;
    exit;
} else {
    // 如果不是验证请求，则可能是正常的消息推送
    // ... 这里后面会处理消息 ...
}
?>

操作步骤：

1. 将上面的代码保存为 wechat.php，并上传到你的服务器（确保 PHP 环境已配置好）。
2. 在服务器上确保 http://yourdomain.com/wechat.php 可以通过浏览器访问。
3. 回到微信后台,点击 “提交”。
4. 如果提示成功,恭喜你，服务器已经成功接入！

第三部分：接收与回复消息

接入成功后,当用户与你的公众号进行交互（如发送消息、点击菜单等），微信服务器会向你的 wechat.php 发送一个 POST 请求，你需要解析这个请求，并根据内容做出回复。

消息格式

微信推送过来的消息是 XML 格式，不同类型的消息，XML 结构略有不同。

文本消息示例：

<xml>
  <ToUserName><![CDATA[toUser]]></ToUserName>
  <FromUserName><![CDATA[fromUser]]></FromUserName>
  <CreateTime>1348831860</CreateTime>
  <MsgType><![CDATA[text]]></MsgType>
  <Content><![CDATA[this is a test]]></Content>
  <MsgId>1234567890123456</MsgId>
</xml>

字段说明：

• ToUserName：开发者微信号（你的公众号ID）。
• FromUserName：发送方帐号（用户的 OpenID）。
• CreateTime：消息创建时间 （时间戳）。
• MsgType：消息类型 (text, image, event 等)。
• Content（文本消息特有）。
• MsgId：消息ID。

PHP 代码实现

我们需要修改 wechat.php，使其能够处理 POST 请求。

<?php
/**
 * 微信公众号PHP开发
 */
// 开启错误报告，方便调试
error_reporting(E_ALL);
ini_set('display_errors', 1);
// 1. 接入验证 (GET请求)
if (isset($_GET['echostr'])) {
    $signature = $_GET["signature"];
    $timestamp = $_GET["timestamp"];
    $nonce = $_GET["nonce"];
    $token = "mywechat_token";
    $tmpArr = array($token, $timestamp, $nonce);
    sort($tmpArr, SORT_STRING);
    $tmpStr = implode($tmpArr);
    $tmpStr = sha1($tmpStr);
    if ($tmpStr == $signature) {
        echo $_GET["echostr"];
        exit;
    }
}
// 2. 接收消息 (POST请求)
if ($_SERVER['REQUEST_METHOD'] == 'POST') {
    // 获取POST过来的XML数据
    $postStr = $GLOBALS["HTTP_RAW_POST_DATA"];
    // 如果没有 raw post data，尝试使用 php://input
    if (empty($postStr)) {
        $postStr = file_get_contents('php://input');
    }
    // 空判断
    if (!empty($postStr)) {
        // 将XML解析成PHP对象
        $postObj = simplexml_load_string($postStr, 'SimpleXMLElement', LIBXML_NOCDATA);
        $fromUsername = $postObj->FromUserName;
        $toUsername = $postObj->ToUserName;
        $keyword = trim($postObj->Content);
        $msgType = $postObj->MsgType;
        // 根据消息类型处理
        if ($msgType == 'text') {
            // 回复文本消息
            if (!empty($keyword)) {
                $contentStr = "你发送的是: " . $keyword;
            } else {
                $contentStr = "请输入文字";
            }
            $textTpl = "<xml>
                        <ToUserName><![CDATA[%s]]></ToUserName>
                        <FromUserName><![CDATA[%s]]></FromUserName>
                        <CreateTime>%s</CreateTime>
                        <MsgType><![CDATA[text]]></MsgType>
                        <Content><![CDATA[%s]]></Content>
                        <FuncFlag>0</FuncFlag>
                        </xml>";
            $resultStr = sprintf($textTpl, $fromUsername, $toUsername, time(), $contentStr);
            echo $resultStr;
        } else if ($msgType == 'event') {
            // 处理事件推送，比如关注/取消关注
            if ($postObj->Event == 'subscribe') {
                // 用户关注事件
                $welcomeMsg = "欢迎关注我们的公众号！";
                $textTpl = "<xml>
                            <ToUserName><![CDATA[%s]]></ToUserName>
                            <FromUserName><![CDATA[%s]]></FromUserName>
                            <CreateTime>%s</CreateTime>
                            <MsgType><![CDATA[text]]></MsgType>
                            <Content><![CDATA[%s]]></Content>
                            <FuncFlag>0</FuncFlag>
                            </xml>";
                $resultStr = sprintf($textTpl, $fromUsername, $toUsername, time(), $welcomeMsg);
                echo $resultStr;
            }
        }
    } else {
        echo "Not Weixin Server Request!";
    }
}
?>

代码解析：

1. 我们同时处理了 GET（接入验证）和 POST（消息接收）请求。
2. $GLOBALS["HTTP_RAW_POST_DATA"] 或 file_get_contents('php://input') 用于获取原始的 POST 数据，因为微信发送的是 XML，而不是表单数据。
3. simplexml_load_string() 是 PHP 内置的函数，用于将 XML 字符串解析成对象，LIBXML_NOCDATA 选项可以处理 <![CDATA[]]>
4. 我们判断了 MsgType，如果是 text，则回复一条文本消息。
5. 回复消息也必须是特定的 XML 格式，我们使用 sprintf() 来填充模板。
6. 我们还增加了对 event 消息类型的处理，特别是 subscribe（关注）事件，这是实现欢迎语的关键。

function getAccessToken($appId, $appSecret) {
    // 尝试从缓存中获取
    $cacheFile = 'access_token_' . $appId . '.cache';
    if (file_exists($cacheFile) && (time() - filemtime($cacheFile)) < 7000) { // 7000秒有效期，留有余地
        return file_get_contents($cacheFile);
    }
    // 如果缓存不存在或已过期，则向微信服务器请求
    $url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid={$appId}&secret={$appSecret}";
    $res = json_decode(file_get_contents($url));
    $accessToken = $res->access_token;
    // 将新的token写入缓存
    file_put_contents($cacheFile, $accessToken);
    return $accessToken;
}
// 使用示例
$accessToken = getAccessToken('你的AppID', '你的AppSecret');

use EasyWeChat\Factory;
$config = [
    'app_id'     => 'your-app-id',
    'app_secret' => 'your-app-secret',
    // ...
];
$app = Factory::officialAccount($config);
$user = $app->user->get($openId); // $openId 是用户的 OpenID
echo $user->nickname;
echo $user->avatar;