先说说源码层面的错误种类,大概有下面几种
//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通过自定义这个函数把错误信息输出到标准输出