php源码-扩展中抛出和处理错误

先说说源码层面的错误种类，大概有下面几种

//zend_errors.h 文件
#define E_ERROR             (1<<0L)
#define E_WARNING           (1<<1L)
#define E_PARSE             (1<<2L)
#define E_NOTICE            (1<<3L)
#define E_CORE_ERROR        (1<<4L)
#define E_CORE_WARNING      (1<<5L)
#define E_COMPILE_ERROR     (1<<6L)
#define E_COMPILE_WARNING   (1<<7L)
#define E_USER_ERROR        (1<<8L)
#define E_USER_WARNING      (1<<9L)
#define E_USER_NOTICE       (1<<10L)
#define E_STRICT            (1<<11L)
#define E_RECOVERABLE_ERROR (1<<12L)
#define E_DEPRECATED        (1<<13L)
#define E_USER_DEPRECATED   (1<<14L)

其中 E_CORE_ERROR， E_ERROR， E_RECOVERABLE_ERROR， E_PARSE， E_COMPILE_ERROR，E_USER_ERROR， 这种错误会触发try catch 异常处理流程，也就是会中断当前request的执行，发生这种错误时会把当前要执行的opcode设置为 ZEND_HANDLE_EXCEPTION， 从而跳出程序执行 ，具体跳出过程参考: php源码-异常throw处理过程-02

我们在写扩展的时候如何抛出错误提示呢?

扩展中可以通过 php_error_docref()函数来抛出错误提示，比如

PHP_FUNCTION(academy_sample_fopen)
{
    FILE *fp;
    char *filename, *mode;
    int filename_len, mode_len;
    if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "ss", &filename, &filename_len, &mode, &mode_len) == FAILURE)
    {
            RETURN_NULL();
    }
    if (!filename_len || !mode_len)
    {
           php_error_docref(NULL TSRMLS_CC, E_WARNING,"Invalid filename or mode length");
            RETURN_FALSE;
    }
    fp = fopen(filename, mode);
    if (!fp)
    {
        php_error_docref(NULL TSRMLS_CC, E_WARNING,"Unable to open %s using mode %s", filename, mode);
            RETURN_FALSE;
    }

}

通过php_error_docref这是的错误提示，如果触发的时候会出现类型下面的错误提示输出
相信在写php代码的时候也都见过这样类似的错误提示输出

PHP Fatal error:  Unknown: EEEEEEEEEEEEEEEEEEE in Unknown on line 0
PHP Warning:  Swoole\Php\Runner::run() expects exactly 4 parameters, 0 given in /var/www/swoole/http_test.php on line 22

这个错误提示输出是如何实现的呢？
跟进php_error_docref的源码

//main/php.h
#define php_error_docref php_error_docref0

//main/main.c
PHPAPI ZEND_COLD void php_error_docref0(const char *docref, int type, const char *format, ...) 
{
    va_list args;
    va_start(args, format);
    php_verror(docref, "", type, format, args);
    va_end(args);
}

//main/main.c
PHPAPI ZEND_COLD void php_verror(const char *docref, const char *params, int type, const char *format, va_list args)
{
    php_error(type, "%s", message);
    efree(message);
}

//main/php.h
#define php_error zend_error

//Zend/zend.c
ZEND_API ZEND_COLD void zend_error(int type, const char *format, ...) /* {{{ */
{
    va_list va;

    va_start(va, format);
    zend_error_va_list(type, format, va);
    va_end(va);
}

static ZEND_COLD void zend_error_va_list(int type, const char *format, va_list args)
{

    if (EG(exception)) {
        switch (type) {
            case E_CORE_ERROR:
            case E_ERROR:
            case E_RECOVERABLE_ERROR:
            case E_PARSE:
            case E_COMPILE_ERROR:
            case E_USER_ERROR:
                                //严重错误，通过ZEND_HANDLE_EXCEPTION 中断程序
                if (ex && ex->opline->opcode == ZEND_HANDLE_EXCEPTION &&
                    EG(opline_before_exception)) {
                    opline = EG(opline_before_exception);
                }
                break;
        }
    }

      //...

   // zend_error_cb 很重要， 这个函数是在 sapi启动的时候，通过 php_module_startup() 赋值为 php_error_cb() 函数
   zend_error_cb(type, error_filename, error_lineno, format, args);

}

zend_error_cb 很重要， 这个函数是在 sapi启动的时候，通过 php_module_startup() 赋值为 php_error_cb()函数 , 而php_error_cb() 最终会调用 _sapi_module_struct.log_message()， 也就是当你调用php_error_docref()函数来抛出错误的时候，实际上会回调 _sapi_module_struct.log_message (具体执行过程参考：php源码-sapi中自定义错误输出)， 比如fpm sapi就会把错误信息返回给， cli sapi通过自定义这个函数把错误信息输出到标准输出