Récemment, j'ai développé des fonctions liées à WeChat pour la page Web WeChat PC. Du point de vue d'un novice, les documents des comptes publics WeChat sont encore difficiles à comprendre. La plupart des publications trouvées en ligne sont essentiellement des copies de WeChat. comptes publics. Selon les documents fournis sur la plateforme, il existe encore de nombreux pièges dans le processus de développement des codes QR WeChat avec des paramètres. Je vais enregistrer mon processus de développement plus en détail ici, en espérant que cela sera utile à tout le monde.

J'utilise le compte du service d'authentification pour ce développement.

1 Accès

Entrez d'abord dans le compte officiel WeChat -> Configuration de base

Ce qui suit est la page de configuration de base. Remplissez l'adresse du serveur dans l'URL. Cette adresse est une interface pour accepter les événements push WeChat. J'ai développé le programme en utilisant le framework thinkPHP. des Modules (Décoration). Créez une nouvelle classe, par exemple : WechatAction.class.php , et créez une nouvelle méthode publique dans l'Action, par exemple : URLRedirect() , alors l'URL renseignée est http://[IP]:[port]/index.php/Decoration/Wechat/UrlRedirect , puis remplissez le Token, remplissez le Token comme vous le souhaitez, EncodingAESKey ou non, puis cliquez sur Confirmer, WeChat ira à cette URL. Envoyez une requête get, qui contient de nombreux paramètres, dont la plupart nous permettent de vérifier si l'accès est demandé par le serveur WeChat. Je ne l'ai pas vérifié moi-même. si nous vérifions avec succès, il sera renvoyé à la requête get tel quel. Un paramètre de echostr, le retour ici n'est pas return, ni ajaxReturn. Si vous utilisez echo, si vous le développez avec thinkPHP, utilisez simplement echo. I('echostr'); directement. La vérification de l'interface est alors réussie.

2 La fonction du code QR avec paramètres

Il existe deux types de codes QR avec paramètres dans WeChat, l'un est un code QR temporaire et l'autre est un code QR permanent. Cependant, il y a une limite au nombre de codes QR permanents qui peuvent être générés. à La fonction implémentée permet aux utilisateurs d'utiliser les produits sur le site Web sans se connecter, par exemple pour obtenir un devis détaillé pour un certain produit, mais ne souhaitent pas s'inscrire, mais souhaitent enregistrer le devis. à ce stade, la page Web peut. générer un code QR, et l'utilisateur n'a qu'à utiliser WeChat. Scannez ce code QR, et le compte public officiel enverra un message graphique à l'utilisateur pendant une journée. Après avoir cliqué sur le message graphique, ce sera la citation que l'utilisateur a. vient d'être obtenu, et vous pouvez cliquer pour le voir à tout moment et le partager avec des amis pour comparer les prix. Par conséquent, le code QR temporaire peut être utilisé normalement.

Voici comment je l'utilise. Voici une introduction à l'ensemble du processus d'interaction?:

Lorsque l'utilisateur scanne ce code QR, si l'utilisateur Après avoir suivi le compte officiel, l'utilisateur entrera directement dans la page de conversation avec le compte officiel. Le serveur WeChat enverra un message à l'URL du serveur que nous avons définie à l'étape précédente, qui peut contenir un paramètre personnalisé. Si l'utilisateur ne suit pas le compte officiel, l'utilisateur accédera d'abord à la page de suivi du compte officiel. Après que l'utilisateur ait cliqué pour suivre, il entrera directement dans la page de conversation du compte officiel. à ce moment, le serveur WeChat le fera également. envoyez un message d'événement à l'URL que nous avons définie, portant Nous personnalisons les paramètres et nous pouvons contr?ler l'action suivante en fonction de ce paramètre et de ce type d'événement.

3 Processus de développement spécifique

3.1 Obtenir access_token

Cet access_token est le certificat permettant à notre programme d'appeler l'interface WeChat. La période de validité actuelle est de 7?200 secondes, nous devons donc mettre à jour régulièrement l'access_token.

Comment obtenir :

方法?：?GET
url?：https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET

Les paramètres APPID et APPSECRET sont les APPID et APPSECRET de notre compte officiel, que l'on retrouve dans le compte officiel WeChat- > Configuration de base On constate que si l'appel réussit, les données JSON suivantes seront renvoyées?:

{"access_token":"ACCESS_TOKEN","expires_in":7200}

Où access_token est l'identifiant de l'interface appelante et expire_in est le jeton. durée de validité.

Je stocke personnellement le access_token dans la base de données, enregistre le délai d'expiration, puis encapsule la fonction publique getWechatAccessToken() à chaque fois, je vérifie d'abord si le. access_token a expiré. S'il a expiré, récupérez-le à nouveau, sinon utilisez simplement le access_token enregistré dans la base de données. J'ai oublié où je l'ai vu. Le nombre de fois que ce access_token peut être obtenu chaque jour devrait être limité. Voici l'implémentation spécifique de getWechatAccessToken()?:

?//獲取access_token
function?getWechatAccessToken(){
????$wechatInfo?=?M('wechat_info')->select();
????$wechatInfo?=?array_reduce($wechatInfo,?create_function('$result,?$v',?'$result[$v["conf_name"]]?=?$v;return?$result;'));
????$expireTime?=?$wechatInfo['PUBLIC_WECHAT_ACCESSTOKEN_EXPIRES']['conf_value'];?????????????????????????????//前面不用管，是我數(shù)據(jù)庫相應(yīng)設(shè)置

????if?(time()?< $expireTime){              //access_token未過期
        return $wechatInfo[&#39;PUBLIC_WECHAT_ACCESSTOKEN&#39;][&#39;conf_value&#39;];
    }else{                                  //access_token過期，重新獲取
        $baseUrl = C(&#39;WECHAT_PUBLIC_GET_ACCESS_TOKEN&#39;);
        $url = str_replace("##APPSECRET##", $wechatInfo[&#39;PUBLIC_WECHAT_APPSECRET&#39;][&#39;conf_value&#39;], str_replace("##APPID##", $wechatInfo[&#39;PUBLIC_WECHAT_APPID&#39;][&#39;conf_value&#39;], $baseUrl));
        $result = file_get_contents($url);
        $result = json_decode($result, true);

        if (array_key_exists(&#39;errorcode&#39;, $result)){        //失敗重試一次
            return false;
        }else{
            M(&#39;wechat_info&#39;)->where(array('conf_name'?=>?'PUBLIC_WECHAT_ACCESSTOKEN'))->save(array('conf_value'?=>?$result['access_token']));
????????????M('wechat_info')->where(array('conf_name'?=>?'PUBLIC_WECHAT_ACCESSTOKEN_EXPIRES'))->save(array('conf_value'?=>?time()+$result['expires_in']-200));
????????????return?$result['access_token'];
????????}
????}
}

C('WECHAT_PUBLIC_GET_ACCESS_TOKEN')?=?https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET

Après avoir encapsulé cela, nous pouvons l'utiliser en toute tranquillité d'esprit à chaque fois.

3.2 Créer un code QR temporaire

3.2.1 Obtenir un ticket

　　　　??請求方式：?POST
　　?????接口：https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=TOKEN
????????POST數(shù)據(jù)：?{"expire_seconds":?604800,?"action_name":?"QR_SCENE",?"action_info":?{"scene":?{"scene_id":?123}}}

Le TOKEN dans l'URL de l'interface est le access_token que nous avons obtenu en 3.1. expire_seconds dans les données de publication est la durée de validité du code QR, qui peut aller jusqu'à 30 jours. pour les codes QR temporaires. Il s'agit de QR_SCENE. scene_id est notre paramètre personnalisé. Il s'agit d'un entier non nul de 32 bits. Je le définis comme identifiant de la commande dans l'application. Lorsque le serveur WeChat envoie l'événement, il est renvoyé. cette valeur à l'interface que nous avons définie. Ensuite, je le ferai. En fonction de cette valeur, les données de commande correspondantes sont obtenues et affichées sur la page Web. C'est un sujet ultérieur.

Voici la méthode encapsulée pour générer un code QR temporaire?:

//創(chuàng)建臨時二維碼
function?getTemporaryQrcode($orderId){
????$accessToken?=?getWechatAccessToken();
????$url?=?str_replace("##TOKEN##",?$accessToken,?C('WECHAT_PUBLIC_GET_TEMPORARY_TICKET'));
????$qrcode?=?'{"expire_seconds":?1800,?"action_name":?"QR_SCENE",?"action_info":?{"scene":?{"scene_id":?'.$orderId.'}}}';
????$result?=?api_notice_increment($url,?$qrcode);
????$result?=?json_decode($result,?true);
????return?urldecode($result['url']);
}

La méthode est api_notice_increment() C'est une fonction de méthode POST que j'ai encapsulée. J'ai essayé de nombreuses méthodes POST. Peut-être parce que l'interface WeChat a des restrictions strictes sur les méthodes et les paramètres POST, cela a fait perdre beaucoup de temps. Finalement, j'en ai trouvé une qui peut être utilisée en ligne. .POST, je vous suggère de l'essayer vous-même d'abord. Si WeChat renvoie une erreur, utilisez simplement ceci. Au moins lorsque j'ai testé l'interface WeChat, j'ai utilisé postman pour tester et renvoyé toutes les erreurs, et ce doit être une cha?ne JSON. doit être une cha?ne JSON très stricte. Voici cette méthode?:

function?api_notice_increment($url,?$data){????$ch?=?curl_init();????$header?=?"Accept-Charset:?utf-8";
????curl_setopt($ch,?CURLOPT_URL,?$url);
????curl_setopt($ch,?CURLOPT_CUSTOMREQUEST,?"POST");
????curl_setopt($ch,?CURLOPT_SSL_VERIFYPEER,?FALSE);
????curl_setopt($ch,?CURLOPT_SSL_VERIFYHOST,?FALSE);
????curl_setopt($ch,?CURLOPT_HTTPHEADER,?$header);
????curl_setopt($ch,?CURLOPT_USERAGENT,?'Mozilla/5.0?(compatible;?MSIE?5.01;?Windows?NT?5.0)');
????curl_setopt($ch,?CURLOPT_FOLLOWLOCATION,?1);
????curl_setopt($ch,?CURLOPT_AUTOREFERER,?1);
????curl_setopt($ch,?CURLOPT_POSTFIELDS,?$data);
????curl_setopt($ch,?CURLOPT_RETURNTRANSFER,?true);????$tmpInfo?=?curl_exec($ch);????if?(curl_errno($ch))?{
????????curl_close(?$ch?);????????return?$ch;
????}else{
????????curl_close(?$ch?);????????return?$tmpInfo;
????}

}

getTemporaryQrcode() Il y a un paramètre dans le fichier de configuration que tout le monde peut voir, qui est en fait le lien de l'interface WeChat?:

C('WECHAT_PUBLIC_GET_TEMPORARY_TICKET')?=?https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=##TOKEN##

La valeur de retour de cette interface est?:

{"ticket":"gQH47joAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL2taZ2Z3TVRtNzJXV1Brb3ZhYmJJAAIEZ23sUwMEmm3sUw==","expire_seconds":60,"url":"http:\/\/weixin.qq.com\/q\/kZgfwMTm72WWPkovabbI"}

Où ticket est l'identifiant que nous utilisons pour passer le prochain appel , expire_seconds est la période de validité du code QR et url est le lien que nous avons généré après avoir scanné le code QR. Donc, si nous implémentons nous-mêmes la méthode de génération de code QR, nous n'avons pas besoin de passer l'appel suivant. Je m'arrête à cette étape et renvoie directement la valeur de l'url, puis j'utilise la valeur de cette url pour générer le code QR. et stockez-le localement. Vous pouvez utiliser phpqrcode pour générer des codes QR en PHP, ce qui est très simple à utiliser. La prochaine étape est également brièvement évoquée?:

3.2.2 Obtention de l'adresse du code QR

　　?請求方式：?GET
　　?接口：https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=TICKET

La valeur de retour de cette interface est une image, qui peut être affichée ou téléchargée directement. Nous l'avons utilisée en détail, nous ne savons donc pas comment l'afficher.

3.3 Que se passe-t-il une fois que l'utilisateur a scanné le code QR

3.3.1 掃描后發(fā)生了什么

　　上面提到了，用戶掃描我們生成的臨時二維碼，如果用戶未關(guān)注公眾號，則首先會跳轉(zhuǎn)到公眾號的關(guān)注頁面，點擊關(guān)注后，會進(jìn)入公眾號的會話頁面，同時會給我們設(shè)置的接口推送一個事件。如果用戶已經(jīng)關(guān)注了，用戶微信會直接跳轉(zhuǎn)到公眾號會話頁面，然后微信服務(wù)器會給我們設(shè)置的接口推送一個事件。

　　用戶關(guān)注與否微信服務(wù)器給我們推送的事件是差不多的，只是新關(guān)注用戶推送的事件中scene_id前面會加一個前綴。下面是微信公眾平臺文檔的說明：

　用戶未關(guān)注時，進(jìn)行關(guān)注后的事件推送

<xml><ToUserName><![CDATA[toUser]]></ToUserName>　　　　　　　　
//開發(fā)者微信號<FromUserName><![CDATA[FromUser]]></FromUserName>　　　　　　　
//發(fā)送者賬號（openid）<CreateTime>123456789</CreateTime>　　　　　　　　　　　　　　　　
//消息創(chuàng)建時間（整型）<MsgType><![CDATA[event]]></MsgType>　　　　　　　　　　　　　　
//消息類型?event<Event><![CDATA[subscribe]]></Event>　　　　　　　　　　　　　　
//事件類型（subscribe）<EventKey><![CDATA[qrscene_123123]]></EventKey>　　　　　　　　
//事件KEY值，qrscene_為前綴，后面為二維碼參數(shù)值<Ticket><![CDATA[TICKET]]></Ticket>　　　　　　　　　　　　　　　
//二維碼ticke值，可以用來換取二維碼圖片</xml>

?　　用戶已關(guān)注時的事件推送

?<xml><ToUserName><![CDATA[toUser]]></ToUserName>　　　　　　　　
?//開發(fā)者微信號<FromUserName><![CDATA[FromUser]]></FromUserName>　　　　?
?//發(fā)送者賬號（openid）<CreateTime>123456789</CreateTime>　　　　　　　　　　　　　
?//消息創(chuàng)建時間<MsgType><![CDATA[event]]></MsgType>????????????????????
?//消息類型event<Event><![CDATA[SCAN]]></Event>　　　　　　　　　　　　　　?
?//事件類型?event<EventKey><![CDATA[SCENE_VALUE]]></EventKey>????????????
?//事件key值，是一個32位無符號整數(shù)，即創(chuàng)建二維碼時的二維碼scene_id<Ticket><![CDATA[TICKET]]></Ticket>?????????????????????
?//二維碼的ticke，可以用來換取二維碼圖片</xml>

?

3.3.2 我們要做些什么

　　我們需要在自己填寫的URL接口中接收這個事件，然后拿到我們需要的東西做我們想干的事兒。因為我要實現(xiàn)的功能比較簡單，只需要拿到scene_id即可，因為這是我要展示給用戶看的訂單數(shù)據(jù)。下面是我寫的接收和處理部分，比較簡單，主要看一下應(yīng)該怎么接收微信推送的事件：

public?function?urlRedirect(){????????
$postStr?=?$GLOBALS["HTTP_RAW_POST_DATA"];????????
$postObj?=?simplexml_load_string($postStr,?'SimpleXMLElement',?LIBXML_NOCDATA);????????
$fromUsername?=?(string)$postObj->FromUserName;????????
$EventKey?=?trim((string)$postObj->EventKey);????????
$keyArray?=?explode("_",?$EventKey);????????
if?(count($keyArray)?==?1)
{?????????
//已關(guān)注者掃描
$this->sendMessage($fromUsername,?$EventKey);
}
else
{　　　　　　　　　　　　　　　　　　　
//未關(guān)注者關(guān)注后推送事件
$this->sendMessage($fromUsername,?$keyArray[1]);
????????}
????}

　　我沒有使用其他參數(shù)，只是根據(jù)不同的推送事件拿到我想要的訂單ID，然后這時候其實相當(dāng)于你在這里用公眾號的客服在跟掃碼的這個用戶對話，上段代碼中調(diào)用的sendMessage()是使用客戶賬號給掃碼用戶發(fā)送一個圖文消息，因為我在拿scen_id的同時也拿到了用戶的openid，可以利用這個給用戶發(fā)送消息。

　　下面是?sendMessage()?方法：

//給用戶發(fā)送圖文消息，點擊跳轉(zhuǎn)到報價頁面
????public?function?sendMessage($openid,$orderId){????????
????$url?=?str_replace('##TOKEN##',?getWechatAccessToken(),?C('WECHAT_SEND_MESSAGE'));????????
????$redirectUrl?=?str_replace("##ORDERID##",?$orderId,?str_replace("##OPENID##",?$openid,?C('WECHAT_REDIRECT_URL_PRE')));????????
????$orderInfo?=?M('order')->where(array('orderid'?=>?$orderId))->field(array('totalMoney',?'savedMoney',?'roomarea'))->find();????????
????$description?=?str_replace("##ROOMAREA##",?intval($orderInfo['roomarea']?*?1.25),?C('WECHAT_MESSAGE_BRIEF'));????????
????$description?=?str_replace("##TOTALBUDGET##",?$orderInfo['totalMoney'],?$description);????????
????$description?=?str_replace("##MARKETBUDGET##",?$orderInfo['totalMoney']+$orderInfo['savedMoney'],?$description);????????
????$description?=?str_replace("##SAVEMONEY##",?$orderInfo['savedMoney'],?$description);????????
????$dataStr?=?'{"touser":"'?.?$openid?.?'","msgtype":"news","news":{"articles":[{"title":"'?.?C('WECHAT_MESSAGE_TITLE')?.
????????????'","description":"'?.?$description?.?'","url":"'?.?$redirectUrl?.?'","picurl":"'?.?C('WECHAT_MESSAGE_PICURL')?.?'""}]}}';
????????api_notice_increment($url,?$dataStr);
????}

　　其中? C('WECHAT_SEND_MESSAGE') = 'https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token=##TOKEN##' ?至于下面的一大段str_replace，就是在組給用戶發(fā)送的文字而已，需要注意$dataStr的格式，這里面要求JSON字符串比較嚴(yán)格，必須所有的字符串都用雙引號括起來。微信接口對POST參數(shù)的限制真心嚴(yán)格。

　　下面是微信公眾平臺開發(fā)者文檔中要求發(fā)送圖文消息的POST data格式：

{
????"touser":"OPENID",
????"msgtype":"news",
????"news":{
????????"articles":?[
?????????{
?????????????"title":"Happy?Day",
?????????????"description":"Is?Really?A?Happy?Day",
?????????????"url":"URL",
?????????????"picurl":"PIC_URL"
?????????},
?????????{
?????????????"title":"Happy?Day",
?????????????"description":"Is?Really?A?Happy?Day",
?????????????"url":"URL",
?????????????"picurl":"PIC_URL"
?????????}
?????????]
????}
}

　　其中url是用戶點擊這個消息之后打開的地址，這個時候我就組了一個自己網(wǎng)站的地址，是一個get請求地址，里面攜帶參數(shù)是用戶的openid和訂單id，這樣用戶點擊開圖文消息就可以看到自己剛才下單的內(nèi)容了，因為需要在網(wǎng)頁上展示用戶的微信頭像和昵稱，所以我把openid也放到參數(shù)里，在頁面加載前先拿到用戶的個人信息和訂單數(shù)據(jù)，再展示網(wǎng)頁。這樣流程：用戶未登錄下單 -> 生成微信二維碼 -> 用戶掃碼關(guān)注公眾號 -> 查看訂單詳細(xì)信息?就完成了。而且因為這個圖文消息打開后的鏈接攜帶的參數(shù)是這個用戶的額openid和其下單的訂單ID，不管分享到哪兒，用什么瀏覽器打開都是可以訪問的，且展示的也是這個用戶的頭像和昵稱信息，這也是我要實現(xiàn)的一個效果。

更多微信開發(fā)—帶參數(shù)二維碼的使用?相關(guān)文章請關(guān)注PHP中文網(wǎng)！