php tp6 路由匹配参数获取问题

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

首先看正常路由匹配

路由定义

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

Index控制器输出参数

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

启动服务php think run -p 8080

---

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

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

---

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

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

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

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

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

---

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

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

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

说好的路由匹配呢！

---

原因说明

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

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

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

➜  ~ 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

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

➜  ~ 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参数不通过传入参数获取，由内部自己获取

// 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());
}

使用原消息体测试

➜  ~ 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，可以说这次问题是不熟悉导致，但也算是一个坑吧，在遇到这种情况下确实容易摸不着头脑
大家项目内使用时多多注意即可~