基于Thinkphp6的微信公众号交互式消息开发

看完thinkPHP实战,我从github上下载了书中的代码,准备运行一下微信公众号开发的程序。
可是,因为书中使用的是ThinkPHP3.2.3,而最新版本已经是6.0.X,反正我对ThinkPHP不熟悉,就下载了最新版来使用。我预料到因为版本不同,程序运行会有问题。我想的是,遇到一个解决一个吧。没想到,我遇到了很多困难,两天了才把程序跑起来。最后还更改了框架的一点点代码。

闲话少说,我依次罗列下遇到的困难吧。

如何在TP中引入ThinkWechat.php

书中是把ThinkWechat.php放在/Application/Home/Library下的。但TP6已经没有Application,我就在/app下新建了library目录,将文件放入其中。

在Index.php中需要引入该文件

use app\library\ThinkWechat;

在ThinkWechat.php文件中添加namespace

namespace app\library;

Class 'app\library\SimpleXMLElement' not found

一开始,百度说是要在环境上安装php7-xml. 我的macmini需要用brew来安装,很久没用brew,brew update慢死了,按照百度的帖子,替换了阿里云的链接。
结果还是不行。弄brew弄了几个小时。后来不知道怎么发现,原来tp6里面用了namespace,所以在使用SimpleXMLElement的时候,要在文件开头写如下语句
use SimpleXMLElement;

TP6怎么打印日志到日志文件

因为是和微信公众号进行交互,我不知道有什么办法方便调试,试过了微信提供的接口调试工具,但是也仅仅能够检查参数设置是否正确。于是我用了最笨的打印日志的方法。
要打印日志需要在TP6中做以下设置:

在config/log.php 中

  1. 设置日志记录级别

    'level' => ['emergency'],

我调试时几乎把所有的level值都写到这里了。

  1. 设置日志保存目录

    'path' => App()->getRuntimePath() .'/log',

  2. 然后在程序中用下面的语句实时写入日志文件

Log::write('index _get session id before set ID '. Session::getId(), 'notice');

关注测试公众号后,输入999,可以收到正常回复。输入1 程序则退出

这个问题卡了我大半天!!

一开始,我以为是返回给微信平台的response 有问题,因为我在ThinkWechat.php中打印了很多日志,发现只要我输入除999以外的信息,data2xml方法总是不能完全执行,日志在
$node = dom_import_simplexml($child);之后就无法打印。

我一直以为是$node->appendChild($node->ownerDocument->createCDATASection($value));
这句代码执行有问题。
因此还从《微信公众平台开发》一书中找到通过设置xml模板中,用sprintf方法替换模板中的变量来生成response的xml。

这样做的结果是,我能在日志中看到response xml 成功生成,但是输入1仍然没有得到我期望的回复,应该是没有任何回复,显示“该公众号暂时无法提供服务,请稍后再试”,并且才程序也是立即退出了。

后来我发现,自己随便写的程序,比如公众号每次都回复用户输入的信息,像应声桶那样,就没有问题,程序也不退出。我突然想着会不会是和session有关?因为源代码中用到了session来实现用户的注册和登录。
我看了下TP6的开发文档,果然,里面写到session默认是没初始化的。这里我有点欲哭无泪。

按照文档说明,我打开了session:

  1. 在app/middleware.php 中去掉\think\middleware\SessionInit::class的注释。
  2. 并且把代码中的session_start()去掉。因为TP6只支持通过Session类方法和session助手函数来操作session. 不支持一切的session_xx 函数。

Session 打开之后,程序不再退出。但出现新的问题,输入999后再输入1,公众号正确回复请输入用户名,但输入用户名后的回复却和输入999一样。提示输入1注册,输入2登录。 而正确的应该是提示输入用户名。

这时,我发现runtime/session目录中生成了多个session文件。对于同一个用户来说,应该仅有一个session文件才是正确的。相当于用户每一次和公众号交互,都有一个新的session文件产生,这样没法获取用户之前输入的信息。

百度后发现这个原因是

session是存储在服务器端的,那么区别每个用户的session就需要使用客户端的cookie,微信服务器是不发送cookie到开发者服务器,所以基于cookie的session无法使用。
但是只要为每个用户设置一个唯一的session_id,也可以达到同样的效果。
每个人微信号是唯一的,所以我们可以使用微信号作为用户的session_id,也可以将其md5加密后使用。

我打算用FromUserName的值作为sessionid。也就是每一个用户自己的openid。不过TP6 不支持session_id()方法来设置sessionid。我后来看文档发现可以用Session::setId来设置SessionID,但是不知道为什么每次还是会生成不同的sessionID。

网上说可以就用openid,我发现每次微信公众号向服务器发来的url确实都会附带openid,我就在session.php配置了openid,希望TP6每次用请求中的openid作为sessionid。不过仍然没有生效。

TP6的session.php有如下配置:

SESSION_ID的提交变量,解决flash上传跨域
'var_session_id' => 'openid',

查看了下框架的setId,原始代码如下

public function setId($id = null): void
    {
        $this->id = is_string($id) && strlen($id) === 32 && ctype_alnum($id) ? $id : md5(microtime
        (true).session_create_id());
    }

原来sessionid必须为32位包含字母数字的字符串,如果不满足要求(openid长度为28位),就用当前时间作为sessionid,所以我把setId改为下面的样子,然后在index方法中打印sessionid,发现每次都是一样的。

public function setId($id = null): void
    {
        $this->id = is_string($id) && strlen(md5($id)) === 32 && ctype_alnum(md5($id)) ? md5($id) : md5(microtime
        (true).session_create_id());
    }

运行了程序,一切正常,感觉太美好了。

这时,我想之前遇到的那么多问题,应该和xml response没有关系。于是我又用回以前的ThinkWechat.php,却发现runtime/session目录中没有生成session文件。

检查后才发现,原始的ThinkWechat.php的response方法最后是

exit($xml->asXML());

而TP6官方文档有以下提醒:

注意,Session写入数据的操作会在请求结束的时候统一进行本地化存储,所以不要在写入Session数据之后使用exit等中断操作,可能会导致Session没有正常写入。

因此我把exit语句改为return $xml->asXML(); 这时session文件正常生成,公众号回复的信息也正确了。

PS 代码已托管在github上 https://github.com/sarawang90...

你可能感兴趣的:(thinkphp6,wechatapi)