php error docref,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通过自定义这个函数把错误信息输出到标准输出