ホームページ > 記事 > WeChat アプレット > php WeChatを使用してパラメータ付きのQRコードを開発する手順の詳細な説明
この記事では主に、PHP WeChat を使用してパラメータ付きの QR コードを開発する手順を詳細に説明します。興味のある友人は参照してください。
私は最近、WeChat PC Web ページの WeChat 関連機能の開発に取り組みました。初心者 彼は、WeChat のパブリック アカウントのドキュメントはまだ理解するのが難しいと述べ、オンラインで見つかるほとんどの投稿は基本的に WeChat のパブリック プラットフォームで提供されるドキュメントをコピーしています。WeChat のパラメータ化された QR コードの開発プロセスにはまだ多くの落とし穴があります。私の開発プロセスをより詳細に記録します。これが皆さんの役に立つことを願っています。
この開発には認証サービスアカウントを使用しています。
1
にアクセスするには、まずWeChat公式アカウントを入力します -> 基本設定
以下は基本設定ページで、URLにサーバーアドレスを入力します。このアドレスはWeChatプッシュイベントを受け入れるためのインターフェースです、I これは、thinkPHP フレームワーク を使用して開発されたプログラムです。Module (Decoration) の 1 つの Action ディレクトリに新しいクラスを作成します。例: WechatAction.class.php を作成します。たとえば、URLRedirect() という名前の場合、この URL には http://[IP]:[port]/index.php/Decoration が入力されます。 /Wechat/UrlRedirect、トークンを入力します。トークン 必要に応じて入力します。EncodingAESKey は OK で、確認をクリックします。WeChat は、多くのパラメータを含む取得リクエストをこの URL に送信します。これにより、このアクセスが WeChat サーバーによって要求されたかどうかを確認できますが、私自身はそれを確認していません。彼の要件は、確認が成功した場合、get リクエストのパラメーター echostr がそのまま返されることです。ここでの return は return や ajaxReturn ではなく、 echo を使用します。 thinkPHP で開発した場合は、 echo I('echostr'); を直接使用してください。その後、インターフェイスの検証は成功します。
2 パラメータ付きQRコードの役割
WeChatにはパラメータ付きQRコードの2種類があり、1つは一時的なQRコード、もう1つは永続的なQRコードですが、永続的なQRコードには制限があります今回実装したい機能は、ある商品の詳しい見積りが欲しいけど登録したくないけどログインせずにWebサイト上の商品を利用できる機能です。この時点で、ユーザーが WeChat で QR コードをスキャンする限り、Web ページはグラフィック メッセージをユーザーに送信します。をクリックすると、ユーザーが取得したばかりの見積書が表示されます。クリックするといつでも見積書を表示でき、価格比較のために友人と共有できます。したがって、一時的な QR コードは正常に使用できます。 上記は私が使用する方法です。ここでは対話プロセス全体を紹介します
:
ユーザーがこの QR コードをスキャンすると、ユーザーが公式アカウントをフォローしている場合、ユーザーは公式との会話ページに直接入ります。アカウント、WeChat サーバー メッセージは、前の手順で設定したサーバー URL にプッシュされます。これにはカスタム パラメーターを含めることができます。ユーザーが公式アカウントをフォローしていない場合、ユーザーはまず公式アカウントのフォローページに移動し、クリックすると公式アカウントの会話ページに直接アクセスします。パラメータをカスタマイズして、設定した URL にイベント メッセージをプッシュします。このパラメータとイベント タイプに基づいて次のアクションを制御できます。
3.1 access_token を取得する
この access_token は、プログラムが WeChat インターフェースを呼び出すための証明書です。現在の有効期間は 7200 秒なので、access_token を定期的に 更新する必要があります。
取得メソッド:
メソッド: GET
url: https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET
パラメータAPPIDとAPPSECRETは、公式アカウントの APPID と APPSECRET で、WeChat 公式アカウント -> 基本設定で確認できます。呼び出しが成功すると、次の JSON データが返されます:
{"access_token":"ACCESS_TOKEN","expires_in" :7200 }
ここで、access_token は呼び出し側インターフェイスの資格情報、expire_in はトークンの有効期限です。
個人的に access_token をデータベースに保存し、有効期限を保存してから、パブリック 関数 getWechatAccessToken() をカプセル化します。そのたびに、access_token の有効期限が切れているかどうかを確認し、有効期限が切れている場合は再度取得します。データベースに保存されている access_token を直接使用できます。どこで見たか忘れましたが、この access_token は 1 日に取得できる回数に制限があるはずです。 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']; //前面不用管,是我数据库相应设置 if (time() < $expireTime){ //access_token未过期 return $wechatInfo['PUBLIC_WECHAT_ACCESSTOKEN']['conf_value']; }else{ //access_token过期,重新获取 $baseUrl = C('WECHAT_PUBLIC_GET_ACCESS_TOKEN'); $url = str_replace("##APPSECRET##", $wechatInfo['PUBLIC_WECHAT_APPSECRET']['conf_value'], str_replace("##APPID##", $wechatInfo['PUBLIC_WECHAT_APPID']['conf_value'], $baseUrl)); $result = file_get_contents($url); $result = json_decode($result, true); if (array_key_exists('errorcode', $result)){ //失败重试一次 return false; }else{ M('wechat_info')->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
これを梱包したら、いつでも安心して使用できます。
.2 一時的なQRコードを作成
3.2.1 ticket3を取得
リクエストメソッド: POST
インターフェース:https://api.weixin.qq.com/cgi-bin/qrcode / create?access_token=TOKEN
POST data: {"expire_seconds": 604800, "action_name": "QR_SCENE", "action_info": {"scene": {"scene_id": 123}}}
インターフェース URL 内の TOKEN 3.1 で取得した access_token は、QR コードの有効期限であり、action_name が一時的な QR コードの場合は、QR_SCENE に固定されます。パラメータは、0 以外の 32 ビットの整数です。WeChat サーバーがイベントをプッシュすると、この値が設定したインターフェイスに返されます。この値を使用して、対応する注文データを取得し、Web ページに表示します。これについては後ほど説明します。
//创建临时二维码 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']); }メソッド api_notice_increment() は、私がカプセル化した POST メソッド関数です。これは、おそらく WeChat インターフェイスがカプセル化されていないためです。 POST メソッドとパラメータの制限は比較的厳しく、最終的にオンラインで使用できるカプセル化された POST メソッドを見つけました。WeChat がエラーを返した場合は、まずそれを使用してください。少なくとも私にとっては、WeChat インターフェイスをテストする場合、postman テストによって返されるすべてのエラーは JSON
string である必要があり、これは非常に厳密な JSON 文字列でなければなりません。このメソッドは次のとおりです:
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()
設定ファイルには誰でも見ることができるパラメータがあります。これは実際にはWeChatインターフェースリンクです: C('WECHAT_PUBLIC_GET_TEMPORARY_TICKET') =
https:/ /api.weixin.qq.com/cgi-bin/qrcode/create?access_token=##TOKEN##
ここで、ticket は次の通話に使用するバウチャー、expire_seconds は QR コードの有効期間です、URL は生成された QR コードをスキャンした後に開かれるリンクです。したがって、QR コードを生成するメソッドを自分で実装する場合は、このステップで停止して URL の値を直接返し、この URL の値を使用して QR コードを生成する必要はありません。ローカルに保存できます。 phpqrcode を使用すると、PHP で QR コードを生成でき、非常に使いやすくなります。次のステップについて簡単に説明しましょう:
3.2.2 获取二维码地址
请求方式: GET
接口:https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=TICKET
这个接口的返回值是一张图片,可以直接展示或者下载,我们有具体使用过,所以也不知道应该怎么展示。
3.3 用户扫描二维码之后发生的事情
3.3.1 扫描后发生了什么
上面提到了,用户扫描我们生成的临时二维码,如果用户未关注公众号,则首先会跳转到公众号的关注页面,点击关注后,会进入公众号的会话页面,同时会给我们设置的接口推送一个事件。如果用户已经关注了,用户微信会直接跳转到公众号会话页面,然后微信服务器会给我们设置的接口推送一个事件。
用户关注与否微信服务器给我们推送的事件是差不多的,只是新关注用户推送的事件中scene_id前面会加一个前缀。下面是微信公众平台文档的说明:
用户未关注时,进行关注后的事件推送
<xml><ToUserName><![CDATA[toUser]]></ToUserName> //开发者微信号 <FromUserName><![CDATA[FromUser]]></FromUserName> //发送者账号(openid) <CreateTime>123456789</CreateTime> //消息创建时间(整型) <MsgType><![CDATA[event]]></MsgType> //消息类型 event <Event><![CDATA[subscribe]]></Event> //事件类型(subscribe) <EventKey><![CDATA[qrscene_123123]]></EventKey> //事件KEY值,qrscene_为前缀,后面为二维码参数值 <Ticket><![CDATA[TICKET]]></Ticket> //二维码ticke值,可以用来换取二维码图片 </xml>
用户已关注时的事件推送
<xml> <ToUserName><![CDATA[toUser]]></ToUserName> //开发者微信号 <FromUserName><![CDATA[FromUser]]></FromUserName> //发送者账号(openid) <CreateTime>123456789</CreateTime> //消息创建时间 <MsgType><![CDATA[event]]></MsgType> //消息类型event <Event><![CDATA[SCAN]]></Event> //事件类型 event <EventKey><![CDATA[SCENE_VALUE]]></EventKey> //事件key值,是一个32位无符号整数,即创建二维码时的二维码scene_id <Ticket><![CDATA[TICKET]]></Ticket> //二维码的ticke,可以用来换取二维码图片 </xml>
3.3.2 我们要做些什么
我们需要在自己填写的URL接口中接收这个事件,然后拿到我们需要的东西做我们想干的事儿。因为我要实现的功能比较简单,只需要拿到scene_id即可,因为这是我要展示给用户看的订单数据。下面是我写的接收和处理部分,比较简单,主要看一下应该怎么接收微信推送的事件:
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){ //已关注者扫描 $this->sendMessage($fromUsername, $EventKey); }else{ //未关注者关注后推送事件 $this->sendMessage($fromUsername, $keyArray[1]); } }
我没有使用其他参数,只是根据不同的推送事件拿到我想要的订单ID,然后这时候其实相当于你在这里用公众号的客服在跟扫码的这个用户对话,上段代码中调用的sendMessage()是使用客户账号给扫码用户发送一个图文消息,因为我在拿scen_id的同时也拿到了用户的openid,可以利用这个给用户发送消息。
下面是sendMessage()方法:
//给用户发送图文消息,点击跳转到报价页面 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,就是在组给用户发送的文字而已,需要注意$dataStr的格式,这里面要求JSON字符串比较严格,必须所有的字符串都用双引号括起来。微信接口对POST参数的限制真心严格。
下面是微信公众平台开发者文档中要求发送图文消息的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是用户点击这个消息之后打开的地址,这个时候我就组了一个自己网站的地址,是一个get请求地址,里面携带参数是用户的openid和订单id,这样用户点击开图文消息就可以看到自己刚才下单的内容了,因为需要在网页上展示用户的微信头像和昵称,所以我把openid也放到参数里,在页面加载前先拿到用户的个人信息和订单数据,再展示网页。这样流程:用户未登录下单 -> 生成微信二维码 -> 用户扫码关注公众号 -> 查看订单详细信息 就完成了。而且因为这个图文消息打开后的链接携带的参数是这个用户的额openid和其下单的订单ID,不管分享到哪儿,用什么浏览器打开都是可以访问的,且展示的也是这个用户的头像和昵称信息,这也是我要实现的一个效果。
以上がphp WeChatを使用してパラメータ付きのQRコードを開発する手順の詳細な説明の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。