webman exception
v1.5.4
composer require tinywan/exception-handler config/exception.php
return [
// 这里配置异常处理类
'' => Tinywan ExceptionHandler Handler::class,
];No modo multiaplicativo, você pode configurar classes de tratamento de exceções separadamente para cada aplicativo, consulte Multiaplicativo
Erro de parâmetro de solicitação
use support Request ;
use support Response ;
use Tinywan ExceptionHandler Exception BadRequestHttpException ;
class Token{
public function issueToken ( Request $ request ): Response
{
$ params = $ request -> post ();
if ( empty ( $ params )) {
throw new BadRequestHttpException ( '账号或密码不能为空' );
}
}
}A exceção acima gera uma mensagem de erro no seguinte formato:
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=utf-8
{
"code" : 0 ,
"msg" : "账号或密码不能为空" ,
"data" : {},
}Todas as informações de exceção retornadas serão retornadas no formato JSON. O texto acima é
返回简略的异常信息
Todos os manipuladores de erros de exceção ajustam a exibição do erro de acordo com o valor debug no arquivo de configuração config/app.php Quando debug for true (indicando que está no modo de depuração), o manipulador de erros exibirá a exceção e a chamada de função detalhada. pilha e código-fonte para ajudar na depuração, informações detalhadas de exceção serão retornadas. Quando debug for false , apenas informações de erro serão exibidas para evitar o vazamento de informações confidenciais do aplicativo, e breves informações de exceção serão retornadas.
Retornar informações detalhadas de exceção
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=utf-8
{
"code" : 0 ,
"msg" : " password不允许为空" ,
"data" : {
"request_url" : " POST //127.0.0.1:8888/oauth/issue-token " ,
"timestamp" : " 2022-03-06 15:19:12 " ,
"client_ip" : " 172.18.0.1 " ,
"request_param" : {
"username" : " webman "
},
"error_message" : " password不允许为空" ,
"error_trace": "#0 /var/www/webman-admin/app/functions.php(68): Tinywan\Validate\Validate->check(Array)n#1 /var/www/webman-admin/app/controller/Authentication.php(25): validate(Array, 'app\\common\\vali...')n#2 /var/www/webman-admin/vendor/workerman/webman-framework/src/App.php(234): app\controller\Authentication->issueToken(Object(support\Request))n#3 /var/www/webman-admin/app/middleware/AccessControlMiddleware.php(26): Webman\App::Webman\{closure}(Object(support\Request))n#4 /var/www/webman-admin/vendor/workerman/webman-framework/src/App.php(228): app\middleware\AccessControlMiddleware->process(Object(support\Request), Object(Closure))n#5 /var/www/webman-admin/vendor/workerman/webman-framework/src/App.php(137): Webman\App::Webman\{closure}(Object(support\Request))n#6 /var/www/webman-admin/vendor/workerman/workerman/Connection/TcpConnection.php(638): Webman\App->onMessage(Object(Workerman\Connection\TcpConnection), Object(support\Request))n#7 /var/www/webman-admin/vendor/workerman/workerman/Events/Select.php(295): Workerman\Connection\TcpConnection->baseRead(Resource id #254)n#8 /var/www/webman-admin/vendor/workerman/workerman/Worker.php(2417): Workerman\Events\Select->loop()n#9 /var/www/webman-admin/vendor/workerman/workerman/Worker.php(1541): Workerman\Worker->run()n#10 /var/www/webman-admin/vendor/workerman/workerman/Worker.php(1383): Workerman\Worker::forkOneWorkerForLinux(Object(Workerman\Worker))n#11 /var/www/webman-admin/vendor/workerman/workerman/Worker.php(1357): Workerman\Worker::forkWorkersForLinux()n#12 /var/www/webman-admin/vendor/workerman/workerman/Worker.php(549): Workerman\Worker::forkWorkers()n#13 /var/www/webman-admin/start.php(87): Workerman\Worker::runAll()n#14 {main}"
}
}Adicionar dados de resposta estendida de exceção
throw new BadRequestHttpException ( '验证码错误' ,[
' data ' => [
' data1 ' => '自定义响应数据1 ' ,
' data2 ' => '自定义响应数据2 ' ,
]
]);Parâmetros de resposta estendidos personalizados serão adicionados aos
data
Adicione data para retornar informações detalhadas de exceção
{
"code" : 0 ,
"msg" : "验证码错误" ,
"data" : {
"request_url" : " POST //127.0.0.1:8888/oauth/issue-token " ,
...
"data1" : "自定义响应数据1 " ,
"data2" : "自定义响应数据2 "
}
} Suponha que você personalize um: 405 Method Not Allowed (ou seja: o método de solicitação especificado na linha de solicitação não pode ser usado para solicitar o recurso correspondente)
As classes de exceção personalizadas só precisam herdar TinywanExceptionHandlerExceptionBaseException
<?php
declare (strict_types= 1 );
namespace support exception ;
use Tinywan ExceptionHandler Exception BaseException ;
class MethodNotAllowedException extends BaseException
{
/**
* @var int
*/
public int $ statusCode = 405 ;
/**
* @var string
*/
public string $ errorMessage = '请求行中指定的请求方法不能被用于请求相应的资源' ;
} use support Request ;
use support Response ;
use support exception MethodNotAllowedException ;
class Token{
public function issueToken ( Request $ request ): Response
{
$ params = $ request -> post ();
if ( empty ( $ params )) {
throw new MethodNotAllowedException ();
}
}
}Use o carteiro para solicitar capturas de tela
JwtTokenExceptionValidateException Mais: https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Status
Cenários de uso
HTTP状态码retornado pelo front-end não é 429 , mas 200 ou outrobody da resposta não é {"code":0,"msg":"Too Many Requests"} , mas {"error_code":200,"message":"Too Many Requests"} e outros conteúdos Edite o código de status HTTP do arquivo config/plugin/tinywan/exception-handler/app.php
body personalizado Edite os campos body do arquivo config/plugin/tinywan/exception-handler/app.php
A opção padrão é
{
"code" : 0 ,
"msg" : " Too Many Requests " ,
"data" : null
}As opções personalizadas fazem referência a uma
1. Suponha que o código de status HTTP esteja definido como 200
2. Suponha que o array body esteja definido como
' body ' => [
' error_code ' => 200 ,
' message ' => '请求太多请稍后重试'
]O conteúdo da resposta é
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
"error_code" : 200 ,
"message" : "请求太多请稍后重试"
}Outros podem ser personalizados de acordo com o seu negócio
Quando o projeto requer muita personalização, é provável que seja necessário estender o Handler. Nesse caso, você pode herdar TinywanExceptionHandlerHandler e modificar o método correspondente.
Cenários de uso
xml , não ao formato json, só precisa substituir o método buildResponsesolveExtraExceptiontriggerNotifyEvent ErrorHandler de exceção personalizada
namespace support ;
use Illuminate Validation ValidationException ;
use Tinywan ExceptionHandler Handler ;
use Webman Http Response ;
class ErrorHandler extends Handler
{
/**
* @inheritDoc
*/
protected function solveExtraException ( Throwable $ e ): void
{
// 当前项目下的异常扩展
if ( $ e instanceof ValidationException) {
$ this -> errorMessage = $ e -> validator -> errors ()-> first ();
$ this -> errorCode = 422 ;
return ;
}
parent :: solveExtraException ( $ e );
}
/**
* @inheritDoc
*/
protected function triggerNotifyEvent ( Throwable $ e ): void
{
// ... 这里省略触发其他错误推送渠道
parent :: triggerNotifyEvent ( $ e );
}
/**
* @inheritDoc
*/
protected function buildResponse (): Response
{
// 构造自己项目下的响应
return json ([
' code ' => $ this -> statusCode , // 使用 statusCode 作为 code 返回
' msg ' => $ this -> errorMessage ,
' data ' => $ this -> responseData ,
]);
}
}
vendor/bin/phpstan analyse src
vendor/bin/php-cs-fixer fix src
