基于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 中

设置日志记录级别
'level' => ['emergency'],

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

设置日志保存目录
'path' => App()->getRuntimePath() .'/log',
然后在程序中用下面的语句实时写入日志文件

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：

在app/middleware.php 中去掉\think\middleware\SessionInit::class的注释。
并且把代码中的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...