ThinkPHP开发指南-错误和日志-异常处理

来自站长百科
跳转至: 导航、​ 搜索

导航:返回上一页

PHP默认的异常处理不同,ThinkPHP抛出的不是单纯的错误信息,而是一个人性化的错误页面。

Thankphp100514.gif

一旦系统发生严重错误会自动抛出异常,也可以用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所指向的页面不能再使用异常的模板变量了。