hyperf 六、异常处理

文档地址：Hyperf

 控制器那篇文里提到过php-fpm和swoole的区别。

这是找到相关内容的文档：PHP教程：PHP-FPM與Swoole的比較

 根据文档：php-fpm每个请求一个worker,swoole请求由Reactor线程监听socket事件变化，业务都在worker里运行。比如tp的自定义命令中有报错时手动处理程序结束，之后的程序都不会执行。这种情况在php-fpm里正常，以为每个请求处理对应的程序，程序异常退出，顶多是这个请求对应的逻辑没执行完。在swoole里，从worker异常退出，其他有对应业务的请求都不会成功。即php-fpm在worker中异常结束仅本次请求，而swoole中影响其他业务。

这也是swoole一个woeker内多个业务请求内存共享的原因。

所以这个框架中异常处理，对正常运行的影响更为重要。

1、定义异常处理

        1.1 注册

        在config/autoload/exceptions.php文件中设置对应类。

// config/autoload/exceptions.php
return [
    'handler' => [
        // 这里的 http 对应 config/autoload/server.php 内的 server 所对应的 name 值
        'http' => [
            // 这里配置完整的类命名空间地址已完成对该异常处理器的注册
            \App\Exception\Handler\FooExceptionHandler::class,
        ],    
    ],
];

        1.2 定义

承抽象类 Hyperf\ExceptionHandler\ExceptionHandler 并实现其中的抽象方法。

namespace App\Exception\Handler;

use Hyperf\ExceptionHandler\ExceptionHandler;
use Hyperf\HttpMessage\Stream\SwooleStream;
use Psr\Http\Message\ResponseInterface;
use App\Exception\FooException;
use Throwable;

class FooExceptionHandler extends  ExceptionHandler
{
    public function handle(Throwable $throwable, ResponseInterface $response)
    {
        // 判断被捕获到的异常是希望被捕获的异常
        if ($throwable instanceof FooException) {
            // 格式化输出
            $data = json_encode([
                'code' => $throwable->getCode(),
                'message' => $throwable->getMessage(),
            ], JSON_UNESCAPED_UNICODE);

            // 阻止异常冒泡
            $this->stopPropagation();
            return $response->withStatus(500)->withBody(new SwooleStream($data));
        }

        // 交给下一个异常处理器
        return $response;

        // 或者不做处理直接屏蔽异常
    }

    /**
     * 判断该异常处理器是否要对该异常进行处理
     */
    public function isValid(Throwable $throwable): bool
    {
        return true;
    }
}

        1.3 触发

namespace App\Controller;

use App\Exception\FooException;

class IndexController extends AbstractController
{
    public function index()
    {
        throw new FooException('Foo Exception...', 800);
    }
}

2、集成whoops

composer require --dev filp/whoops

 composer地址：filp/whoops - Packagist

whoops是一个用于PHP的错误处理程序框架。

3、error监听

框架提供了 error_reporting() 错误级别的监听器 Hyperf\ExceptionHandler\Listener\ErrorExceptionHandler。

config/autoload/listeners.php中设置监听器。

return [
    \Hyperf\ExceptionHandler\Listener\ErrorExceptionHandler::class
];