ThinkPHP开发指南-错误和日志-异常处理
导航:返回上一页
和PHP默认的异常处理不同,ThinkPHP抛出的不是单纯的错误信息,而是一个人性化的错误页面。
一旦系统发生严重错误会自动抛出异常,也可以用ThinkPHP定义的throw_exception方法手动抛出异常。
throw_exception方法支持三个参数:
$msg 异常信息,必须
$type 异常类型,即异常类的名称,默认是系统异常基础类ThinkException
$code 异常代码 默认为0
如果指定的异常类型不存在,系统自动调用halt方法直接输出异常信息文字,而不输出异常详细信息。
下面是throw_exception函数的一些使用例子:
PHP代码
throw_exception('新增失败'); throw_exception('信息录入错误','InfoException');
同样也可以使用throw 关键字来抛出异常,下面的写法是等效的:
PHP代码
throw new ThinkException('新增失败'); throw new InfoException('信息录入错误');
如果需要,我们建议在项目的类库目录下面增加Exception目录用于专门存放异常类库,以更加精确地定位异常。
异常页面的模板是可以修改的,如果没有定义,则采用系统内置的异常模板文件,该模板文件位于系统目录下目的Tpl目录下面的 ThinkException.tpl.php文件。通过设置EXCEPTION_TMPL_FILE 配置参数来修改系统默认的异常模板文件, 例如:
PHP代码
'EXCEPTION_TMPL_FILE' => APP_PATH.'/Public/exception.php'
异常模板中可以使用的异常变量有:
- $e['file'] 异常文件名
- $e['line'] 异常发生的文件行数
- $e['message'] 异常信息
- $e['trace'] 异常的详细Trace信息
因为异常模板使用的是原生PHP代码,所以还可以支持任何的PHP方法和系统变量使用。抛出异常后通常会显示具体的错误信息,如果不想让用户看到具体的错误信息,可以设置关闭错误信息的显示并设置统一的错误提示信息,例如:
'SHOW_ERROR_MSG' =>false,
'ERROR_MESSAGE' => '发生错误!'
设置之后,所有的异常页面只会显示“发生错误!”这样的提示信息,但是日志文件中仍然可以查看具体的错误信息。另外一种方式是配置ERROR_PAGE参数,把所有异常和错误都指向一个统一页面,从而避免让用户看到异常信息,通常在部署模式下面使用。ERROR_PAGE参数必须是一个完整的URL地址,例如:
'ERROR_PAGE' => '/Public/error.html'
如果不在当前域名,还可以指定域名:'ERROR_PAGE' => 'http://www.myDomain.com/Public/error.html'
注意ERROR_PAGE所指向的页面不能再使用异常的模板变量了。