看完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',
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/sarawang9012/thinkwechat