ThinkPHP6.0 与5.0的差别及坑点

写在前面

tp6发布已经有大半年了，之前做项目一直用的tp5，甚至没有用5.1，是因为tp5用来做了很多个项目，文档前后翻了可能有两三遍，所以对tp5会比较熟悉（个人感觉）。最近刚好做数据库的大作业，时间不大够，放弃了原来用springboot 的打算；正巧又打算把之前的项目从tp5迁移到tp6，所以打算借着这个机会先把tp6的坑踩一下，而且有之前tp5的基础，应该问题不大。

接下来我会按照开发过程的顺序，从控制器（C）、模型（M）、一些配置、乱七八糟会用到的地方进行对比，同时也会讲一些坑点。

不同点

安装

首先一个比较大的差别是安装不再有分发压缩包的形式，改成了用composer来分发。2020年了，这确实是一个比较好的方案，看得出tp已经是一个比较成熟的框架了。而且同大版本号可以通过composer直接更新，整个流程比较流畅。

食用方式：

composer create-project topthink/think tp

※坑点：composer国内访问较慢，换源可以大大提升体验，方法可以参考https://blog.csdn.net/weixin_43409309/article/details/105577082

配置文件

比较明显的是tp5里面的config.php被拆分成了app、cache、database、route等等模块，放在了config文件夹里。这个部分实际上变动不太大，实现也是通过配置加载的方式，我在tp5的时候已经有自己定义配置然后加载了，这个部分没有太大亮点。

值得一提的是，tp6新引入了一个.env的文件，可以通过读取这个环境设置去配置数据库等等之类config里面的内容。文件采用ini格式，可以修改数据库连接等常用的配置，比较方便。之前如果分散在各处的一些配置（如ip地址、密码加密的盐值之类）可以放在同一个地方了，方便了在不同环境里部署。

但是，这里要打一个但是，我一开始以为这里是一个类似springboot里面.properties文件的那种机制，可以通过不同的环境文件区分例如测试环境和开发环境。实际上只能存在一个名叫".env"的文件（注意不是后缀名）。这里就会出现一个，在不同环境切换时可能会出现误操作覆盖了这个文件的情况，始终觉得有些别扭。

※坑点：环境文件的命名一定是“.env"，没有别的字符

自带web服务器

这确实是一个比较大的改变，调试的时候再也不需要拿出xampp了，直接php think run就可以在本地启动一个web服务器，还可以用-p参数指定端口，确实比较方便。我现在已经习惯了在PHPstormProjects下直接开发项目（因为用pycharm用多了），如果要把文件复制到htdocs里面才能测试就很麻烦，这个web服务器有点对我胃口。

※坑点：不知道是什么原因，感觉这个web服务器性能可能有问题，一个普通的响应居然用时500ms+，生产环境下还是用正经的web服务器。

目录

新版本的目录是有比较大的变化的，例如之前的config.php就拆分成了一个config文件夹，application文件夹重命名为app文件夹，等等之类。

※坑点：建议看一下tp6文档里的目录结构

控制器

这个方面变化还挺大，感觉底层可能有比较大的变动。以往控制器需要继承think\Controller类，现在官方有一个BaseController，实现的控制器只需要继承这个控制器基础类就可以。（在Model上就没有看到这个变化）

json接口

刚好说完控制器，就必须得说一下我在做JSON-RPC的时候经常用的一套方法：封装一个BaseController，在这里构造用来返回的JSON；然后其他控制器继承这个基类控制器，就可以比较方便地渲染JSON数据返回。现在的workaround跟原来也是类似的，用一个ResponseController去继承BaseController，然后其他控制器再继承ResponseController。

※坑点：这里有一个比较奇怪的改变是，tp5可以在配置文件中设置返回类型为json，这样在返回时只需要返回一个数组，框架就能包装成json返回。在tp6里没有找到这样的配置，好像只能手动json()然后再返回。

※坑点：输入的时候也是，以往输入函数可以自动处理json，例如可以通过input("post.")获取到post上来的json，然后解析成一个数组；tp6把json转换成一个表单，需要通过类似表单获取的方式访问，体验跟tp5稍有不同。

跨域

还记得之前的跨域问题吗？（https://blog.csdn.net/weixin_43409309/article/details/104287425）这个问题在tp6里终于有比较方便的解决方案了，只需要在middleware.php中注册\think\middleware\AllowCrossDomain就可以搞定跨域了。

中间件

tp6改进了中间件，具体的使用可以看一下文档，因为我没有用过 ，这方面没太大感觉。

总结

虽然说是一个大版本更新，底层有比较大的改变，实际操作跟tp5差别并不大。有朋友说tp6刚出的时候比较多bug，因此我也是没有第一时间尝新；现在半年多过去，感觉已经能够稳定使用了，在这一两天中也没有发现其他什么大的问题。

另外有一个比较想吐槽的问题是，tp6的文档更新得真的太慢，很多文档目前还欠缺，例如视图层的文档就直接叫你参考tp5的了，以及tp5的完全开发手册其实也还有很多坑没有填上，而且在说明上也不够清楚。另外，助手函数在附录中单列了出来，但又没有具体的文档，只有一个名录，这方面有点拉胯。希望团队能重视一下文档的建设，像我这样的菜鸡在学习起来会比较有困难。