使用场景

tp6连接除database.php配置外的数据库（临时数据库等）

使用方式

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

//use think\facade\Config;
$config = Config::get('database');
$config['connections']['tmp'] = [
 'type'            => 'mysql',
 'hostname'        => 'localhost',
 'database'        => 'test',
 'username'        => 'root',
 'password'        => 'root',
 'hostport'        => 3306,
 'params'          => [],
 'charset'         => 'utf8mb4'
];
Config::set($config, 'database');

Db::connect('tmp')->query('select * from t limit 1');

概述

• tp5.0 -> tp5.1 -> tp6.0 都有较大改动，虽然有官方的升级指导文件但是也没有覆盖所有情况
• 本次升级的过程也是作为一次尝试，以下问题仅是本人在升级项目中遇到，未包括所有情况
• 如果不是必要情况，强烈不推荐升级

遇到的问题

• 路由参数绑定不再支持按照名称成对解析（url_param_type）
  • 本项可直接查看此链接
• model不再支持get()/all()方法
  • 可以使用find()/select()来作为替换
  • 若遇到get()参数使用的不是主键，则需配合where()->find()使用
• 系统库think\Db | think\Session等需要使用门面
  • 如think\facade\Session等，具体可查看此处
• model中init()方法的模型事件self::beforeInsert(function ($obj) { })等无法使用
  • 更改为public static function onBeforeInsert($obj) {}
• 控制器中$this->redirect('/path'); return true;无法使用
  • 直接更改为return redirect('/path');
• Session需设置为中间件使用
• ROOT_PATH | TEMP_PATH | DS等全局变量不可使用
  • 可替换为app()->getRootPath() | app()->getRuntimePath()等
• 上传文件validate方法不可用
  • 控制器中可使用$this->validate()或validate()->check($file)

背景

原项目使用tp5多应用模式，未使用强制路由，且url参数是按照顺序解析url_param_type = 1
想尝试能不能从tp5升级到tp6，虽然有官方升级文档，但tp6的url参数方式只能按照名称成对解析，无法满足需求，于是看了下源码看看能不能处理

示例

tp5原模式

• 顺序参数模式（config.php文件中设置'url_param_type' => 1）

• 文件路径：application/index/controller/TestController.php

  1 2 3 4 5

  public function test($a = '', $b = '') { echo '参数a：', $a, '<br/>'; echo '参数b：', $b, '<br/>'; }

• 执行curl http://localhost/index/test/test/111/222

• 输出

  1 2	参数a：111 参数b：222

tp6尝试

• 同样代码输出

  1 2	参数a：222 参数b：

• 推荐方式：curl http://localhost/index/test/test/a/111/b/222

• 或者其实：curl http://localhost/index/test/test/fff/111/fff/222也行，具体可以打印request()->param()看看就知道了

分析

• 从上述结果可以看出只要解决param解析问题即可，tp6不定义路由时都是按照名称成对解析的
• 找到tp6解析的地方think\route\dispatch\Url->parseUrl(string $url): array

解决

• 更改parseUrl方法可以处理，但对框架有影响，所以建议从项目内部替换Url类

• 可以直接引入我写的包

• composer require aichenk/tp6-route-param

• 在config/route.php中添加参数'url_param_type' => 1即可（0即为关闭）

• tp6输出

  1 2	参数a：111 参数b：222

使用php自带的ZipArchive来解压带中文文件名压缩包时会造成乱码，现象如下：

原结构

解压代码

1
2
3
4
5
6
7

$zip = new \ZipArchive();
$res = $zip->open('./钱学森班.zip');
if ($res !== true){
    throw new \Exception('打开压缩包失败');
}
$zip->extractTo('./cache');
$zip->close();

解压后

原因

默认windows，mac打压缩包时编码为简体中文，解压时未作文件转化导致解压结果与预期不符

解决方法

打开压缩包后先将内部文件名及目录进行转码，转码后需关闭压缩包并重新打开解压

实现如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

$zipName = './钱学森班.zip';
$zip = new \ZipArchive();
$res = $zip->open($zipName);
if ($res !== true){
    throw new \Exception('打开压缩包失败');
}

// 加入此段↓
$fileNum = $zip->numFiles;
for ($i = 0; $i < $fileNum; $i++) {
    $statInfo = $zip->statIndex($i, ZipArchive::FL_ENC_RAW);
    $zip->renameIndex($i, iconv('GBK', 'utf-8//IGNORE', $statInfo['name']));
}
$zip->close();
$zip->open($zipName);
// 截至↑

$zip->extractTo($extractTo);
$zip->close();

注意事项

• 转码后因为修改了原压缩包文件，所以不可重复转码，若不想对原文件产生影响需先复制（php-zip扩展是自己读文件流，不需要复制）
• 转换前使用mb_detect_encoding进行编码判断依然是返回UTF-8

tp6是一个封装度很高的框架，在大部分场景下都能做到开箱即用
本次遇到情况为，当请求消息体为索引数组时，路由参数无法正常获取

首先看正常路由匹配

路由定义

1

Route::post('test/:a/:b', 'index/test');

Index控制器输出参数

1
2
3
4
5

public function test($a, $b)
{
  echo 'a:', $a, PHP_EOL;
  echo 'b:', $b, PHP_EOL;
}

启动服务php think run -p 8080

请求测试，如下我们得到了我们所需要的结果

1
2
3

➜  ~ curl -X POST http://localhost:8080/test/1/2
a:1
b:2

将IndexController->test中$a, $b参数调换位置（路由不变）

1
2
3
4
5

public function test($b, $a)
{
  echo 'a:', $a, PHP_EOL;
  echo 'b:', $b, PHP_EOL;
}

重新请求，得到的结果依然不变

1
2
3

➜  ~ curl -X POST http://localhost:8080/test/1/2
a:1
b:2

那么我们是否可以得到结论：tp6控制器参数会根据路由参数名自动匹配？
看以上结果好像是没问题，但是有个大坑！

请求体正文中加入数组内容

路由，控制器输出方法都不变，仅增加requestBody，得到如下结果

1
2
3

➜  ~ curl -X POST -H "content-type:application/json" -d "[3, 4]" http://localhost:8080/test/1/2
a:4
b:3

说好的路由匹配呢！

原因说明

在方法中打印出request->param()可查看到刚才的请求最终得到的参数

1
2
3
4
5
6

array:4 [
  0 => 3
  1 => 4
  "a" => "1"
  "b" => "2"
]

可以看到消息体中参数是索引数组部分，而路由参数a，b为关联数组部分
tp在最终匹配action参数的时候，按照先分配索引，再分配关联的顺序进行了参数传入，导致没有得到我们想要的效果
若消息体内增加键值，我们重新尝试，如下依然是我们想要的结果

1
2
3

➜  ~ curl -X POST -H "content-type:application/json" -d "{\"a\":3}" http://localhost:8080/test/1/2
a:1
b:2

所以大概得到结论：param()参数的来源为先获取query、body等参数，再覆盖上路由参数

解决方案

既然已经知道原因，那么解决方案就比较好处理了

方案1

更改消息体，避免直接使用索引数组传递，如

1
2
3

➜  ~ curl -X POST -H "content-type:application/json" -d "{\"data\":[3, 4]}" http://localhost:8080/test/1/2
a:1
b:2

我们在方法内根据键值data即可获取想要的数据

方案2

不需要更改结构体，但action参数不通过传入参数获取，由内部自己获取

1
2
3
4
5
6
7
8
9

// action代码如下
public function test()
{
    $a = $this->request->param('a');
    $b = $this->request->param('b');
    echo 'a:', $a, PHP_EOL;
    echo 'b:', $b, PHP_EOL;
    var_dump($this->request->param());
}

使用原消息体测试

1
2
3
4
5
6
7
8
9
10
11
12
13

➜  ~ curl -X POST -H "content-type:application/json" -d "[3, 4]" http://localhost:8080/test/1/2
a:4
b:3
array(4) {
  [0]=>
  int(3)
  [1]=>
  int(4)
  ["a"]=>
  string(1) "1"
  ["b"]=>
  string(1) "2"
}

总结

根据结果，不能说这是tp的BUG，可以说这次问题是不熟悉导致，但也算是一个坑吧，在遇到这种情况下确实容易摸不着头脑
大家项目内使用时多多注意即可~