新版ThinkPHP针对API开发做了很多的优化,并且不依赖原来的API模式扩展。

数据输出

新版的控制器输出采用Response类统一处理,而不是直接在控制器中进行输出,通过设置default_return_type或者动态设置不同类型的Response输出就可以自动进行数据转换处理,一般来说,你只需要在控制器中返回字符串或者数组即可,例如如果我们配置:

  1. 'default_return_type'=>'json'

那么下面的控制器方法返回值会自动转换为json格式并返回。

  1. namespace app\index\controller;
  2. class Index
  3. {
  4. public function index()
  5. {
  6. $data = ['name'=>'ThinkPHP','url'=>'ThinkPHP.cn'];
  7. return ['data'=>$data,'code'=>1,'message'=>'操作完成'];
  8. }
  9. }

访问该请求URL地址后,最终可以在浏览器中看到输出结果如下:

  1. {"data":{"name":"ThinkPHP","url":"ThinkPHP.cn"},"code":1,"message":"\u64cd\u4f5c\u5b8c\u6210"}
如果你需要返回其他的数据格式的话,控制器本身的代码无需做任何改变。

支持明确指定输出类型的方式输出,例如下面指定JSON数据输出:

  1. namespace app\index\controller;
  2. class Index
  3. {
  4. public function index()
  5. {
  6. $data = ['name'=>'ThinkPHP','url'=>'ThinkPHP.cn'];
  7. // 指定json数据输出
  8. return json(['data'=>$data,'code'=>1,'message'=>'操作完成']);
  9. }
  10. }

或者指定输出XML类型数据:

  1. namespace app\index\controller;
  2. class Index
  3. {
  4. public function index()
  5. {
  6. $data = ['name'=>'ThinkPHP','url'=>'ThinkPHP.cn'];
  7. // 指定xml数据输出
  8. return xml(['data'=>$data,'code'=>1,'message'=>'操作完成']);
  9. }
  10. }

核心支持的数据类型包括viewxmljsonjsonp,其他类型的需要自己扩展。

错误调试

由于API开发不方便在客户端进行开发调试,但ThinkPHP1Trace调试功能支持Socket在内的方式,可以实现远程的开发调试。

设置方式:

  1. 'app_trace' => true,
  2. 'trace' => [
  3. 'type' => 'socket',
  4. // socket服务器
  5. 'host' => 'slog.ThinkPHP.cn',
  6. ],

然后安装chrome浏览器插件后即可进行远程调试,详细参考调试部分。