system system.base system.caching system.caching.dependencies system.collections system.console system.db system.db.ar system.db.schema system.db.schema.cubrid system.db.schema.mssql system.db.schema.mysql system.db.schema.oci system.db.schema.pgsql system.db.schema.sqlite system.gii system.i18n system.i18n.gettext system.logging system.test system.utils system.validators system.web system.web.actions system.web.auth system.web.filters system.web.form system.web.helpers system.web.renderers system.web.services system.web.widgets system.web.widgets.captcha system.web.widgets.pagers zii.behaviors zii.widgets zii.widgets.grid zii.widgets.jui

CErrorHandler

system.base
继承 class CErrorHandler » CApplicationComponent » CComponent
实现 IApplicationComponent
可用自 1.0
源码 framework/base/CErrorHandler.php
CErrorHandler 处理未捕获的PHP错误和异常。

It displays these errors using appropriate views based on the nature of the error and the mode the application runs at. It also chooses the most preferred language for displaying the error.

CErrorHandler uses two sets of views:
  • development views, named as exception.php;
  • production views, named as error<StatusCode>.php;
where <StatusCode> stands for the HTTP error code (e.g. error500.php). Localized views are named similarly but located under a subdirectory whose name is the language code (e.g. zh_cn/error500.php).

Development views are displayed when the application is in debug mode (i.e. YII_DEBUG is defined as true). Detailed error information with source code are displayed in these views. Production views are meant to be shown to end-users and are used when the application is in production mode. For security reasons, they only display the error message without any sensitive information.

CErrorHandler looks for the view templates from the following locations in order:
  1. themes/ThemeName/views/system: when a theme is active.
  2. protected/views/system
  3. framework/views
If the view is not found in a directory, it will be looked for in the next directory.

The property maxSourceLines can be changed to specify the number of source code lines to be displayed in development views.

CErrorHandler is a core application component that can be accessed via CApplication::getErrorHandler().

公共属性

隐藏继承的属性

属性类型描述被定义在
adminInfo string the application administrator information (could be a name or email link). CErrorHandler
behaviors array the behaviors that should be attached to this component. CApplicationComponent
discardOutput boolean whether to discard any existing page output before error display. CErrorHandler
error array Returns the details about the error that is currently being handled. CErrorHandler
errorAction string the route (eg 'site/error') to the controller action that will be used to display external errors. CErrorHandler
exception Exception|null Returns the instance of the exception that is currently being handled. CErrorHandler
isInitialized boolean Checks if this application component has been initialized. CApplicationComponent
maxSourceLines integer maximum number of source code lines to be displayed. CErrorHandler
maxTraceSourceLines integer maximum number of trace source code lines to be displayed. CErrorHandler

受保护的属性

隐藏继承的属性

属性类型描述被定义在
versionInfo string Returns server version information. CErrorHandler

公共方法

隐藏继承的方法

方法描述被定义在
__call() Calls the named method which is not a class method. CComponent
__get() Returns a property value, an event handler list or a behavior based on its name. CComponent
__isset() Checks if a property value is null. CComponent
__set() Sets value of a component property. CComponent
__unset() Sets a component property to be null. CComponent
asa() Returns the named behavior object. CComponent
attachBehavior() Attaches a behavior to this component. CComponent
attachBehaviors() Attaches a list of behaviors to the component. CComponent
attachEventHandler() Attaches an event handler to an event. CComponent
canGetProperty() Determines whether a property can be read. CComponent
canSetProperty() Determines whether a property can be set. CComponent
detachBehavior() Detaches a behavior from the component. CComponent
detachBehaviors() Detaches all behaviors from the component. CComponent
detachEventHandler() Detaches an existing event handler. CComponent
disableBehavior() Disables an attached behavior. CComponent
disableBehaviors() Disables all behaviors attached to this component. CComponent
enableBehavior() Enables an attached behavior. CComponent
enableBehaviors() Enables all behaviors attached to this component. CComponent
evaluateExpression() Evaluates a PHP expression or callback under the context of this component. CComponent
getError() Returns the details about the error that is currently being handled. CErrorHandler
getEventHandlers() Returns the list of attached event handlers for an event. CComponent
getException() Returns the instance of the exception that is currently being handled. CErrorHandler
getIsInitialized() Checks if this application component has been initialized. CApplicationComponent
handle() Handles the exception/error event. CErrorHandler
hasEvent() Determines whether an event is defined. CComponent
hasEventHandler() Checks whether the named event has attached handlers. CComponent
hasProperty() Determines whether a property is defined. CComponent
init() Initializes the application component. CApplicationComponent
raiseEvent() Raises an event. CComponent

受保护的方法

隐藏继承的方法

方法描述被定义在
argumentsToString() Converts arguments array to its string representation CErrorHandler
getExactTrace() Returns the exact trace where the problem occurs. CErrorHandler
getHttpHeader() Return correct message for each known http error code CErrorHandler
getVersionInfo() Returns server version information. CErrorHandler
getViewFile() Determines which view file should be used. CErrorHandler
getViewFileInternal() Looks for the view under the specified directory. CErrorHandler
handleError() Handles the PHP error. CErrorHandler
handleException() 异常处理。 CErrorHandler
isAjaxRequest() whether the current request is an AJAX (XMLHttpRequest) request. CErrorHandler
isCoreCode() Returns a value indicating whether the call stack is from application code. CErrorHandler
render() 渲染视图。 CErrorHandler
renderError() Renders the current error information. CErrorHandler
renderException() Renders the exception information. CErrorHandler
renderSourceCode() Renders the source code around the error line. CErrorHandler

属性详情

adminInfo 属性
public string $adminInfo;

the application administrator information (could be a name or email link). It is displayed in error pages to end users. Defaults to 'the webmaster'.

discardOutput 属性
public boolean $discardOutput;

whether to discard any existing page output before error display. Defaults to true.

error 属性 只读
public array getError()

Returns the details about the error that is currently being handled. The error is returned in terms of an array, with the following information:

  • code - the HTTP status code (e.g. 403, 500)
  • type - the error type (e.g. 'CHttpException', 'PHP Error')
  • message - the error message
  • file - the name of the PHP script file where the error occurs
  • line - the line number of the code where the error occurs
  • trace - the call stack of the error
  • source - the context source code where the error occurs

errorAction 属性
public string $errorAction;

the route (eg 'site/error') to the controller action that will be used to display external errors. Inside the action, it can retrieve the error information by Yii::app()->errorHandler->error. This property defaults to null, meaning CErrorHandler will handle the error display.

exception 属性 只读
public Exception|null getException()

Returns the instance of the exception that is currently being handled.

maxSourceLines 属性
public integer $maxSourceLines;

maximum number of source code lines to be displayed. Defaults to 25.

maxTraceSourceLines 属性 (自版本 v1.1.6 可用)
public integer $maxTraceSourceLines;

maximum number of trace source code lines to be displayed. Defaults to 10.

versionInfo 属性 只读
protected string getVersionInfo()

Returns server version information. If the application is in production mode, empty string is returned.

方法详情

argumentsToString() 方法
protected string argumentsToString(array $args)
$args array arguments array to be converted
{return} string string representation of the arguments array
源码: framework/base/CErrorHandler.php#452 (显示)
protected function argumentsToString($args)
{
    
$count=0;

    
$isAssoc=$args!==array_values($args);

    foreach(
$args as $key => $value)
    {
        
$count++;
        if(
$count>=5)
        {
            if(
$count>5)
                unset(
$args[$key]);
            else
                
$args[$key]='...';
            continue;
        }

        if(
is_object($value))
            
$args[$key] = get_class($value);
        elseif(
is_bool($value))
            
$args[$key] = $value 'true' 'false';
        elseif(
is_string($value))
        {
            if(
strlen($value)>64)
                
$args[$key] = '"'.substr($value,0,64).'..."';
            else
                
$args[$key] = '"'.$value.'"';
        }
        elseif(
is_array($value))
            
$args[$key] = 'array('.$this->argumentsToString($value).')';
        elseif(
$value===null)
            
$args[$key] = 'null';
        elseif(
is_resource($value))
            
$args[$key] = 'resource';

        if(
is_string($key))
        {
            
$args[$key] = '"'.$key.'" => '.$args[$key];
        }
        elseif(
$isAssoc)
        {
            
$args[$key] = $key.' => '.$args[$key];
        }
    }
    
$out implode(", "$args);

    return 
$out;
}

Converts arguments array to its string representation

getError() 方法
public array getError()
{return} array the error details. Null if there is no error.
源码: framework/base/CErrorHandler.php#150 (显示)
public function getError()
{
    return 
$this->_error;
}

Returns the details about the error that is currently being handled. The error is returned in terms of an array, with the following information:

  • code - the HTTP status code (e.g. 403, 500)
  • type - the error type (e.g. 'CHttpException', 'PHP Error')
  • message - the error message
  • file - the name of the PHP script file where the error occurs
  • line - the line number of the code where the error occurs
  • trace - the call stack of the error
  • source - the context source code where the error occurs

getExactTrace() 方法
protected array getExactTrace(Exception $exception)
$exception Exception 未捕获的异常
{return} array the exact trace where the problem occurs
源码: framework/base/CErrorHandler.php#316 (显示)
protected function getExactTrace($exception)
{
    
$traces=$exception->getTrace();

    foreach(
$traces as $trace)
    {
        
// property access exception
        
if(isset($trace['function']) && ($trace['function']==='__get' || $trace['function']==='__set'))
            return 
$trace;
    }
    return 
null;
}

Returns the exact trace where the problem occurs.

getException() 方法
public Exception|null getException()
{return} Exception|null exception instance. Null if there is no exception.
源码: framework/base/CErrorHandler.php#159 (显示)
public function getException()
{
    return 
$this->_exception;
}

Returns the instance of the exception that is currently being handled.

getHttpHeader() 方法
protected string getHttpHeader(integer $httpCode, string $replacement='')
$httpCode integer error code to map
$replacement string replacement error string that is returned if code is unknown
{return} string the textual representation of the given error code or the replacement string if the error code is unknown
源码: framework/base/CErrorHandler.php#553 (显示)
protected function getHttpHeader($httpCode$replacement='')
{
    
$httpCodes = array(
        
100 => 'Continue',
        
101 => 'Switching Protocols',
        
102 => 'Processing',
        
118 => 'Connection Timed Out',
        
200 => 'OK',
        
201 => 'Created',
        
202 => 'Accepted',
        
203 => 'Non-Authoritative',
        
204 => 'No Content',
        
205 => 'Reset Content',
        
206 => 'Partial Content',
        
207 => 'Multi-Status',
        
210 => 'Content Different',
        
300 => 'Multiple Choices',
        
301 => 'Moved Permanently',
        
302 => 'Found',
        
303 => 'See Other',
        
304 => 'Not Modified',
        
305 => 'Use Proxy',
        
307 => 'Temporary Redirect',
        
310 => 'Too Many Redirect',
        
400 => 'Bad Request',
        
401 => 'Unauthorized',
        
402 => 'Payment Required',
        
403 => 'Forbidden',
        
404 => 'Not Found',
        
405 => 'Method Not Allowed',
        
406 => 'Not Acceptable',
        
407 => 'Proxy Authentication Required',
        
408 => 'Request Timeout',
        
409 => 'Conflict',
        
410 => 'Gone',
        
411 => 'Length Required',
        
412 => 'Precondition Failed',
        
413 => 'Request Entity Too Large',
        
414 => 'Request-URI Too Long',
        
415 => 'Unsupported Media Type',
        
416 => 'Requested Range Not Satisfiable',
        
417 => 'Expectation Failed',
        
418 => 'I’m a teapot',
        
422 => 'Unprocessable entity',
        
423 => 'Locked',
        
424 => 'Method failure',
        
425 => 'Unordered Collection',
        
426 => 'Upgrade Required',
        
428 => 'Precondition Required',
        
429 => 'Too Many Requests',
        
431 => 'Request Header Fields Too Large',
        
449 => 'Retry With',
        
450 => 'Blocked by Windows Parental Controls',
        
451 => 'Unavailable For Legal Reasons',
        
500 => 'Internal Server Error',
        
501 => 'Not Implemented',
        
502 => 'Bad Gateway',
        
503 => 'Service Unavailable',
        
504 => 'Gateway Timeout',
        
505 => 'HTTP Version Not Supported',
        
507 => 'Insufficient Storage',
        
509 => 'Bandwidth Limit Exceeded',
        
510 => 'Not Extended',
        
511 => 'Network Authentication Required',
    );
    if(isset(
$httpCodes[$httpCode]))
        return 
$httpCodes[$httpCode];
    else
        return 
$replacement;
}

Return correct message for each known http error code

getVersionInfo() 方法
protected string getVersionInfo()
{return} string server version information. Empty if in production mode.
源码: framework/base/CErrorHandler.php#433 (显示)
protected function getVersionInfo()
{
    if(
YII_DEBUG)
    {
        
$version='<a href="http://www.yiiframework.com/">Yii Framework</a>/'.Yii::getVersion();
        if(isset(
$_SERVER['SERVER_SOFTWARE']))
            
$version=$_SERVER['SERVER_SOFTWARE'].' '.$version;
    }
    else
        
$version='';
    return 
$version;
}

Returns server version information. If the application is in production mode, empty string is returned.

getViewFile() 方法
protected string getViewFile(string $view, integer $code)
$view string view name (either 'exception' or 'error')
$code integer HTTP status code
{return} string view file path
源码: framework/base/CErrorHandler.php#387 (显示)
protected function getViewFile($view,$code)
{
    
$viewPaths=array(
        
Yii::app()->getTheme()===null null :  Yii::app()->getTheme()->getSystemViewPath(),
        
Yii::app() instanceof CWebApplication Yii::app()->getSystemViewPath() : null,
        
YII_PATH.DIRECTORY_SEPARATOR.'views',
    );

    foreach(
$viewPaths as $i=>$viewPath)
    {
        if(
$viewPath!==null)
        {
             
$viewFile=$this->getViewFileInternal($viewPath,$view,$code,$i===2?'en_us':null);
             if(
is_file($viewFile))
                  return 
$viewFile;
        }
    }
}

Determines which view file should be used.

getViewFileInternal() 方法
protected string getViewFileInternal(string $viewPath, string $view, integer $code, string $srcLanguage=NULL)
$viewPath string the directory containing the views
$view string view name (either 'exception' or 'error')
$code integer HTTP status code
$srcLanguage string the language that the view file is in
{return} string view file path
源码: framework/base/CErrorHandler.php#414 (显示)
protected function getViewFileInternal($viewPath,$view,$code,$srcLanguage=null)
{
    
$app=Yii::app();
    if(
$view==='error')
    {
        
$viewFile=$app->findLocalizedFile($viewPath.DIRECTORY_SEPARATOR."error{$code}.php",$srcLanguage);
        if(!
is_file($viewFile))
            
$viewFile=$app->findLocalizedFile($viewPath.DIRECTORY_SEPARATOR.'error.php',$srcLanguage);
    }
    else
        
$viewFile=$viewPath.DIRECTORY_SEPARATOR."exception.php";
    return 
$viewFile;
}

Looks for the view under the specified directory.

handle() 方法
public void handle(CEvent $event)
$event CEvent the event containing the exception/error information
源码: framework/base/CErrorHandler.php#94 (显示)
public function handle($event)
{
    
// set event as handled to prevent it from being handled by other event handlers
    
$event->handled=true;

    if(
$this->discardOutput)
    {
        
$gzHandler=false;
        foreach(
ob_list_handlers() as $h)
        {
            if(
strpos($h,'gzhandler')!==false)
                
$gzHandler=true;
        }
        
// the following manual level counting is to deal with zlib.output_compression set to On
        // for an output buffer created by zlib.output_compression set to On ob_end_clean will fail
        
for($level=ob_get_level();$level>0;--$level)
        {
            if(!@
ob_end_clean())
                
ob_clean();
        }
        
// reset headers in case there was an ob_start("ob_gzhandler") before
        
if($gzHandler && !headers_sent() && ob_list_handlers()===array())
        {
            if(
function_exists('header_remove')) // php >= 5.3
            
{
                
header_remove('Vary');
                
header_remove('Content-Encoding');
            }
            else
            {
                
header('Vary:');
                
header('Content-Encoding:');
            }
        }
    }

    if(
$event instanceof CExceptionEvent)
        
$this->handleException($event->exception);
    else 
// CErrorEvent
        
$this->handleError($event);
}

Handles the exception/error event. This method is invoked by the application whenever it captures an exception or PHP error.

handleError() 方法
protected void handleError(CErrorEvent $event)
$event CErrorEvent PHP 错误事件
源码: framework/base/CErrorHandler.php#228 (显示)
protected function handleError($event)
{
    
$trace=debug_backtrace();
    
// skip the first 3 stacks as they do not tell the error position
    
if(count($trace)>3)
        
$trace=array_slice($trace,3);
    
$traceString='';
    foreach(
$trace as $i=>$t)
    {
        if(!isset(
$t['file']))
            
$trace[$i]['file']='unknown';

        if(!isset(
$t['line']))
            
$trace[$i]['line']=0;

        if(!isset(
$t['function']))
            
$trace[$i]['function']='unknown';

        
$traceString.="#$i {$trace[$i]['file']}({$trace[$i]['line']}): ";
        if(isset(
$t['object']) && is_object($t['object']))
            
$traceString.=get_class($t['object']).'->';
        
$traceString.="{$trace[$i]['function']}()\n";

        unset(
$trace[$i]['object']);
    }

    
$app=Yii::app();
    if(
$app instanceof CWebApplication)
    {
        switch(
$event->code)
        {
            case 
E_WARNING:
                
$type 'PHP warning';
                break;
            case 
E_NOTICE:
                
$type 'PHP notice';
                break;
            case 
E_USER_ERROR:
                
$type 'User error';
                break;
            case 
E_USER_WARNING:
                
$type 'User warning';
                break;
            case 
E_USER_NOTICE:
                
$type 'User notice';
                break;
            case 
E_RECOVERABLE_ERROR:
                
$type 'Recoverable error';
                break;
            default:
                
$type 'PHP error';
        }
        
$this->_exception=null;
        
$this->_error=array(
            
'code'=>500,
            
'type'=>$type,
            
'message'=>$event->message,
            
'file'=>$event->file,
            
'line'=>$event->line,
            
'trace'=>$traceString,
            
'traces'=>$trace,
        );
        if(!
headers_sent())
        {
            
$httpVersion=Yii::app()->request->getHttpVersion();
            
header("HTTP/$httpVersion 500 Internal Server Error");
        }

        
$this->renderError();
    }
    else
        
$app->displayError($event->code,$event->message,$event->file,$event->line);
}

Handles the PHP error.

handleException() 方法
protected void handleException(Exception $exception)
$exception Exception 捕获的异常
源码: framework/base/CErrorHandler.php#168 (显示)
protected function handleException($exception)
{
    
$app=Yii::app();
    if(
$app instanceof CWebApplication)
    {
        if((
$trace=$this->getExactTrace($exception))===null)
        {
            
$fileName=$exception->getFile();
            
$errorLine=$exception->getLine();
        }
        else
        {
            
$fileName=$trace['file'];
            
$errorLine=$trace['line'];
        }

        
$trace $exception->getTrace();

        foreach(
$trace as $i=>$t)
        {
            if(!isset(
$t['file']))
                
$trace[$i]['file']='unknown';

            if(!isset(
$t['line']))
                
$trace[$i]['line']=0;

            if(!isset(
$t['function']))
                
$trace[$i]['function']='unknown';

            unset(
$trace[$i]['object']);
        }

        
$this->_exception=$exception;
        
$this->_error=$data=array(
            
'code'=>($exception instanceof CHttpException)?$exception->statusCode:500,
            
'type'=>get_class($exception),
            
'errorCode'=>$exception->getCode(),
            
'message'=>$exception->getMessage(),
            
'file'=>$fileName,
            
'line'=>$errorLine,
            
'trace'=>$exception->getTraceAsString(),
            
'traces'=>$trace,
        );

        if(!
headers_sent())
        {
            
$httpVersion=Yii::app()->request->getHttpVersion();
            
header("HTTP/$httpVersion {$data['code']} ".$this->getHttpHeader($data['code'], get_class($exception)));
        }

        
$this->renderException();
    }
    else
        
$app->displayException($exception);
}

异常处理。

isAjaxRequest() 方法
protected boolean isAjaxRequest()
{return} boolean whether the current request is an AJAX request.
源码: framework/base/CErrorHandler.php#306 (显示)
protected function isAjaxRequest()
{
    return isset(
$_SERVER['HTTP_X_REQUESTED_WITH']) && $_SERVER['HTTP_X_REQUESTED_WITH']==='XMLHttpRequest';
}

whether the current request is an AJAX (XMLHttpRequest) request.

isCoreCode() 方法
protected boolean isCoreCode(array $trace)
$trace array the trace data
{return} boolean whether the call stack is from application code.
源码: framework/base/CErrorHandler.php#507 (显示)
protected function isCoreCode($trace)
{
    if(isset(
$trace['file']))
    {
        
$systemPath=realpath(dirname(__FILE__).'/..');
        return 
$trace['file']==='unknown' || strpos(realpath($trace['file']),$systemPath.DIRECTORY_SEPARATOR)===0;
    }
    return 
false;
}

Returns a value indicating whether the call stack is from application code.

render() 方法
protected void render(string $view, array $data)
$view string the view name (file name without extension). See getViewFile for how a view file is located given its name.
$data array data to be passed to the view
源码: framework/base/CErrorHandler.php#335 (显示)
protected function render($view,$data)
{
    
$data['version']=$this->getVersionInfo();
    
$data['time']=time();
    
$data['admin']=$this->adminInfo;
    include(
$this->getViewFile($view,$data['code']));
}

渲染视图。

renderError() 方法
protected void renderError()
源码: framework/base/CErrorHandler.php#365 (显示)
protected function renderError()
{
    if(
$this->errorAction!==null)
        
Yii::app()->runController($this->errorAction);
    else
    {
        
$data=$this->getError();
        if(
$this->isAjaxRequest())
            
Yii::app()->displayError($data['code'],$data['message'],$data['file'],$data['line']);
        elseif(
YII_DEBUG)
            
$this->render('exception',$data);
        else
            
$this->render('error',$data);
    }
}

Renders the current error information. This method will display information from current error value.

renderException() 方法
protected void renderException()
源码: framework/base/CErrorHandler.php#347 (显示)
protected function renderException()
{
    
$exception=$this->getException();
    if(
$exception instanceof CHttpException || !YII_DEBUG)
        
$this->renderError();
    else
    {
        if(
$this->isAjaxRequest())
            
Yii::app()->displayException($exception);
        else
            
$this->render('exception',$this->getError());
    }
}

Renders the exception information. This method will display information from current error value.

renderSourceCode() 方法
protected string renderSourceCode(string $file, integer $errorLine, integer $maxLines)
$file string 源文件路径
$errorLine integer the error line number
$maxLines integer maximum number of lines to display
{return} string 渲染结果
源码: framework/base/CErrorHandler.php#524 (显示)
protected function renderSourceCode($file,$errorLine,$maxLines)
{
    
$errorLine--;    // adjust line number to 0-based from 1-based
    
if($errorLine<|| ($lines=@file($file))===false || ($lineCount=count($lines))<=$errorLine)
        return 
'';

    
$halfLines=(int)($maxLines/2);
    
$beginLine=$errorLine-$halfLines>$errorLine-$halfLines:0;
    
$endLine=$errorLine+$halfLines<$lineCount?$errorLine+$halfLines:$lineCount-1;
    
$lineNumberWidth=strlen($endLine+1);

    
$output='';
    for(
$i=$beginLine;$i<=$endLine;++$i)
    {
        
$isErrorLine $i===$errorLine;
        
$code=sprintf("<span class=\"ln".($isErrorLine?' error-ln':'')."\">%0{$lineNumberWidth}d</span> %s",$i+1,CHtml::encode(str_replace("\t",'    ',$lines[$i])));
        if(!
$isErrorLine)
            
$output.=$code;
        else
            
$output.='<span class="error">'.$code.'</span>';
    }
    return 
'<div class="code"><pre>'.$output.'</pre></div>';
}

Renders the source code around the error line.