php异常处理 之 BooBoo库介绍

本文介绍php开源库BooBoo,是一个处理php异常和错误的开源库,通过简单的分析代码,我们知道了实际项目中怎么正确的设置错误和异常。

这是php异常系列的第二篇,第一篇地址是:

如何组织PHP中的异常

基本概念

php中的异常和错误是不一样的,错误英文单词是error,异常英文单词是exception。异常一般指出现正常逻辑之外的情况,而错误是指运行时发生了不可恢复的故障,比如使用了未定义的变量,或者语法错误等。异常我们通过throw抛出,catch进行捕获,而错误一般发生程序就会终止,我们可以通过trigger_error触发用户级错误,然后通过set_error_handler设置处理函数,下面看段代码:

set_error_handler('errorHandler');
trigger_error("这里描述错误",E_USER_ERROR);
//E_USER_ERROR:该error 所特定的错误类型,默认是E_USER_NOTICE
function errorHandler($errno,$errstr){
    //用户的函数需要接受两个参数:错误码和描述错误的 string
    if($errno==E_USER_ERROR){
        echo "错误为:",$errstr.'<br>';
    }
}

运行后就会通过我们设定的errorHandler输出错误。

如果我们没有设定errorHandler,而且我们是在控制台中运行的脚本,那就会出现错误信息,

PHP Fatal error: 这里描述错误 in /Users/zhuanxu/workspace/php-exceptions/error.php on line 4

那我们怎么能够在生产环境中去除这些信息呢?

php.ini中有两个参数与错误有关,一个是display_errors,另一个是error_reporting,其中display_errors控制着是否将错误信息输出到控制台,而error_reporting则控制着错误报告级别。

讲完这些,我们下面将开始分析BooBoo,来看看实际项目中怎么处理错误和异常。

BooBoo介绍

此处我们通过库BooBoo来进行学习。

BooBoo的设计原则是:如果Errors是fatal的,那就按fatal处理,如果Errors不是Fatal的,则让程序继续执行。

在错误的处理上,我们希望能够在实际生产中处理错误,但是只在开发环境中才展示出这些错误信息,因此BooBoo在设计上有两个重要的概念:Handler,Formatter。

  • Handler做的事情就是针对错误执行一个操作,可能是记录日志,可能是发送错误给报警器。
  • Formatter则是将错误变为可阅读的错误信息。

另外当设置display_errors关闭的时候,不会执行Formatter操作,当然BooBoo也支持你自己针对错误自己制定Formatter。

代码结构:

├── Exception
│   └── NoFormattersRegisteredException.php
├── Formatter
│   ├── AbstractFormatter.php
│   ├── CommandLineFormatter.php
│   ├── FormatterInterface.php
│   ├── HtmlFormatter.php
│   ├── HtmlTableFormatter.php
│   ├── JsonFormatter.php
│   └── NullFormatter.php
├── Handler
│   ├── HandlerInterface.php
│   ├── LogHandler.php
│   └── RavenHandler.php
├── Runner.php
└── Util
    ├── Frame.php
    ├── FrameCollection.php
    └── Inspector.php

顶层是Runner.php,下面是重要的两个目录:Formatter和Handler,还有辅助函数Util,以及异常Exception。

我们先看使用方式

安装

$ composer require league/booboo

新建booboo.php

use League\BooBoo\Formatter\CommandLineFormatter;
use League\BooBoo\Runner;

require_once __DIR__ . "/vendor/autoload.php";


$runner = new Runner();
$runner->pushFormatter(new CommandLineFormatter());
$runner->register(); // Registers the handlers

echo $cc;

执行后输出:

+--------+
| NOTICE |
+--------+
Undefined variable: cc in /Users/zhuanxu/workspace/php-exceptions/booboo.php on line 12

有了使用的感性认识后,我们看看究竟发生了什么。

League\BooBoo\Runner的构造函数中:

public function __construct(array $formatters = [], array $handlers = []);

可以设置formatters和handlers,然后在register函数中,

//==> 关闭错误展示,设置3个处理函数
// We want the formaters we register to handle the errors.
ini_set('display_errors', false);

set_error_handler(array($this, self::ERROR_HANDLER));
set_exception_handler(array($this, self::EXCEPTION_HANDLER));
register_shutdown_function(array($this, self::SHUTDOWN_HANDLER));

通过3个注册函数注册了处理的函数。当异常发生的时候,调用exceptionHandler函数

里面会挨个调用用户注册的handlers,如果用户没有关闭错误显示,会通过formatters处理后直接打印出来,但是如果关闭了错误显示,则会返回给浏览器。

此处看下register_shutdown_function函数,其注册的函数调用条件是:

1、当页面被用户强制停止时

2、当程序代码运行超时时

3、当PHP代码执行完成时,代码执行存在异常和错误、警告

在函数shutdownHandler中:我们关闭了抛出异常,然后判断是否有错误发生,有则进行错误处理。

public function shutdownHandler()
    {
        // We can't throw exceptions in the shutdown handler.
        $this->treatErrorsAsExceptions(false);

        $error = error_get_last();
        if ($error && $error['type'] & $this->fatalErrors) {
            $this->errorHandler(
                $error['type'],
                $error['message'],
                $error['file'],
                $error['line']
            );
        }
    }

最后我们看下错误处理函数,在里面我们会判断错误是否是致命错误,如果是则进行处理,否则按照异常处理。

BooBoo库的介绍就到这了,通过BooBoo我们能很方便的对异常和错误进行统一处理,非常方便我们平常的开发,下一篇我们将再看看Whoops库,也是一个错误处理的函数,再平时开发中用到的很多。

这是 php异常系列 的第二篇,你的鼓励是我继续写下去的动力,期待我们共同进步。

参考

PHP异常、错误处理机制笔记

Introducing a new error handler for PHP projects

register_shutdown_function 函数详解

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏闻道于事

Java之线程,常用方法,线程同步,死锁

1, 线程的概念 进程与线程 进程:每个进程都有独立的代码和数据空间(进程上下文),进程间的切换会有较大的开销,一个进程包含1--n个线程。(进程是资源分配的最...

36390
来自专栏耕耘实录

一分钟在Linux环境下创建一台SFTP服务器(含账户创建)

FTP是比较常见的一种服务了,很多公司都会有可能使用到FTP服务器,本文将以最简洁的办法使用系统自带的ssh软件在1分钟内搭建一台使用方便的FTP服务器。 ...

21230
来自专栏钟绍威的专栏

linux常用命令之查阅文件用法选项功能键用法选项DEMO用法选项选项注意选项注意选项注意用法选项

CAT cat – concatenate print files 连续的输出文件内容 用法 cat [-nbA] file 选项 -n line number...

20250
来自专栏沈唁志

在Linux中vim的用法

22420
来自专栏互扯程序

java多线程-概念&创建启动&中断&守护线程&优先级&线程状态

在现代操作在运行一个程序时,会为其创建一个进程。例如启动一个QQ程序,操作系统就会为其创建一个进程。而操作系统中调度的最小单位元是线程,也叫轻量级进程,在一个进...

15030
来自专栏风中追风

java类的加载过程和类加载器的分析

我们知道,我们写的java代码保存的格式是 .java, java文件被编译后会转换为字节码,字节码可以在任何平台通过java虚拟机来运行,这也是java能够跨...

55880
来自专栏一个爱瞎折腾的程序猿

常用cmd代码片段及.net core打包脚本分享

保存:set currentPath=%cd% 输出:echo %currentPath

12830
来自专栏土豆专栏

Java面试之基本概念(二)

当两个线程竞争同一资源的时候,如果对资源的访问顺序敏感,就称存在竞态条件。导致竞态条件发生的代码区称作临界区。

23550
来自专栏PhpZendo

Nginx 烹调书

本书是「Complete Nginx Cookbook」一书的部分中英文对照翻译版本。

13910
来自专栏王亚昌的专栏

采用epoll模型服务器连接管理器实现

    在网络服务器中,需要维护所有连接信息,通常是以fd做为key,连接信息结构体做为value。每次有新连接接入时,需求加入一个映射关系;每次有新数据到达时...

11110

扫码关注云+社区

领取腾讯云代金券