json yii2 mysql_Yii2 API接口输出统一Json和jsonp格式方法

本文介绍了如何在Yii2框架下创建一个API接口,使其能以统一的Json或Jsonp格式响应数据。包括在beforesend事件中处理数据格式,异常处理,以及如何在请求错误或成功时返回特定格式的数据。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

如果做API的话,如何使别人再调用你的接口时能够有一个统一标准的json或者jsonp格式,然而 json响应的格式和内容,每个人的约定都是有差异的,所以我们必须再数据出去之前做一定的处理。

1.首先我们需要初始化去调用beforeSend,因为我们需要对beforesend做一些处理,以下是init初始化处理代码:/**

* (non-PHPdoc)

* @see \yii\base\Object::init()

*/

public function init()

{

parent::init();

//绑定beforeSend事件,更改数据输出格式

Yii::$app->getResponse()->on(Response::EVENT_BEFORE_SEND, [$this, 'beforeSend']);

}

2.然后我们就需要对beforesend进行处理,处理点有下面几个重点:

1>更改数据输出格式

2>默认情况下输出Json数据

3>如果客户端请求时有传递$_GET['callback']参数,输出Jsonp格式

4>请求正确时数据为  {"success":true,"data":{...}}

5>请求错误时数据为  {"success":false,"data":{"name":"Not Found","message":"页面未找到。","code":0,"status":404}}

6>具体代码如下:/**

* 更改数据输出格式

* 默认情况下输出Json数据

* 如果客户端请求时有传递$_GET['callback']参数,输入Jsonp格式

* 请求正确时数据为  {"success":true,"data":{...}}

* 请求错误时数据为  {"success":false,"data":{"name":"Not Found","message":"页面未找到。","code":0,"status":404}}

* @param \yii\base\Event $event

*/

public function beforeSend($event)

{

/* @var $response \yii\web\Response */

$response = $event->sender;

$isSuccessful = $response->isSuccessful;

if ($response->statusCode>=400) {

//异常处理

if (true && $exception = Yii::$app->getErrorHandler()->exception) {

$response->data = $this->convertExceptionToArray($exception);

}

//Model出错了

if ($response->statusCode==422) {

$messages=[];

foreach ($response->data as $v) {

$messages[] = $v['message'];

}

//请求错误时数据为  {"success":false,"data":{"name":"Not Found","message":"页面未找到。","code":0,"status":404}}

$response->data = [

'name'=> 'valide error',

'message'=> implode("  ", $messages),

'info'=>$response->data

];

}

$response->statusCode = 200;

}

elseif ($response->statusCode>=300) {

$response->statusCode = 200;

$response->data = $this->convertExceptionToArray(new ForbiddenHttpException(Yii::t('yii', 'Login Required')));

}

//请求正确时数据为  {"success":true,"data":{...}}

$response->data = [

'success' => $isSuccessful,

'data' => $response->data,

];

$response->format = Response::FORMAT_JSON;

\Yii::$app->getResponse()->getHeaders()->set('Access-Control-Allow-Origin', '*');

\Yii::$app->getResponse()->getHeaders()->set('Access-Control-Allow-Credentials', 'true');

//jsonp 格式输出

if (isset($_GET['callback'])) {

$response->format = Response::FORMAT_JSONP;

$response->data = [

'callback' => $_GET['callback'],

'data'=>$response->data,

];

}

}

3.针对请求可能会发生一些异常,同样我们也需要对异常进行一些标准化处理,将异常转换为array输出,具体代码如下:/**

* 将异常转换为array输出

* @see \yii\web\ErrorHandle

* @param \Exception $exception

* @return multitype:string NULL Ambigous  \yii\web\integer \yii\db\array multitype:string NULL Ambigous  \yii\web\integer \yii\db\array

*/

protected function convertExceptionToArray($exception)

{

if (!YII_DEBUG && !$exception instanceof UserException && !$exception instanceof HttpException) {

$exception = new HttpException(500, Yii::t('yii', 'An internal server error occurred.'));

}

$array = [

'name' => ($exception instanceof Exception || $exception instanceof ErrorException) ? $exception->getName() : 'Exception',

'message' => $exception->getMessage(),

'code' => $exception->getCode(),

];

if ($exception instanceof HttpException) {

$array['status'] = $exception->statusCode;

}

if (YII_DEBUG) {

$array['type'] = get_class($exception);

if (!$exception instanceof UserException) {

$array['file'] = $exception->getFile();

$array['line'] = $exception->getLine();

$array['stack-trace'] = explode("\n", $exception->getTraceAsString());

if ($exception instanceof \yii\db\Exception) {

$array['error-info'] = $exception->errorInfo;

}

}

}

if (($prev = $exception->getPrevious()) !== null) {

$array['previous'] = $this->convertExceptionToArray($prev);

}

return $array;

}

好了,这样我们就有了标准同一个的api接口返回数据格式了,在调用接口的人员也不用为了格式不统一感到烦恼。

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值