Completed
Push — fix-wrong-response-code-in-err... ( c1bff3...60af75 )
by Alexander
20:09
created

ErrorHandler::renderException()   C

Complexity

Conditions 12
Paths 54

Size

Total Lines 48
Code Lines 31

Duplication

Lines 0
Ratio 0 %

Code Coverage

Tests 23
CRAP Score 16.8751

Importance

Changes 0
Metric Value
dl 0
loc 48
ccs 23
cts 34
cp 0.6765
rs 5.1266
c 0
b 0
f 0
cc 12
eloc 31
nc 54
nop 1
crap 16.8751

How to fix   Complexity   

Long Method

Small methods make your code easier to understand, in particular if combined with a good name. Besides, if your method is small, finding a good name is usually much easier.

For example, if you find yourself adding comments to a method's body, this is usually a good sign to extract the commented part to a new method, and use the comment as a starting point when coming up with a good name for this new method.

Commonly applied refactorings include:

1
<?php
2
/**
3
 * @link http://www.yiiframework.com/
4
 * @copyright Copyright (c) 2008 Yii Software LLC
5
 * @license http://www.yiiframework.com/license/
6
 */
7
8
namespace yii\web;
9
10
use Yii;
11
use yii\base\Exception;
12
use yii\base\ErrorException;
13
use yii\base\UserException;
14
use yii\helpers\VarDumper;
15
16
/**
17
 * ErrorHandler handles uncaught PHP errors and exceptions.
18
 *
19
 * ErrorHandler displays these errors using appropriate views based on the
20
 * nature of the errors and the mode the application runs at.
21
 *
22
 * ErrorHandler is configured as an application component in [[\yii\base\Application]] by default.
23
 * You can access that instance via `Yii::$app->errorHandler`.
24
 *
25
 * For more details and usage information on ErrorHandler, see the [guide article on handling errors](guide:runtime-handling-errors).
26
 *
27
 * @author Qiang Xue <[email protected]>
28
 * @author Timur Ruziev <[email protected]>
29
 * @since 2.0
30
 */
31
class ErrorHandler extends \yii\base\ErrorHandler
32
{
33
    /**
34
     * @var int maximum number of source code lines to be displayed. Defaults to 19.
35
     */
36
    public $maxSourceLines = 19;
37
    /**
38
     * @var int maximum number of trace source code lines to be displayed. Defaults to 13.
39
     */
40
    public $maxTraceSourceLines = 13;
41
    /**
42
     * @var string the route (e.g. `site/error`) to the controller action that will be used
43
     * to display external errors. Inside the action, it can retrieve the error information
44
     * using `Yii::$app->errorHandler->exception`. This property defaults to null, meaning ErrorHandler
45
     * will handle the error display.
46
     */
47
    public $errorAction;
48
    /**
49
     * @var string the path of the view file for rendering exceptions without call stack information.
50
     */
51
    public $errorView = '@yii/views/errorHandler/error.php';
52
    /**
53
     * @var string the path of the view file for rendering exceptions.
54
     */
55
    public $exceptionView = '@yii/views/errorHandler/exception.php';
56
    /**
57
     * @var string the path of the view file for rendering exceptions and errors call stack element.
58
     */
59
    public $callStackItemView = '@yii/views/errorHandler/callStackItem.php';
60
    /**
61
     * @var string the path of the view file for rendering previous exceptions.
62
     */
63
    public $previousExceptionView = '@yii/views/errorHandler/previousException.php';
64
    /**
65
     * @var array list of the PHP predefined variables that should be displayed on the error page.
66
     * Note that a variable must be accessible via `$GLOBALS`. Otherwise it won't be displayed.
67
     * Defaults to `['_GET', '_POST', '_FILES', '_COOKIE', '_SESSION']`.
68
     * @see renderRequest()
69
     * @since 2.0.7
70
     */
71
    public $displayVars = ['_GET', '_POST', '_FILES', '_COOKIE', '_SESSION'];
72
73
74
    /**
75
     * Renders the exception.
76
     * @param \Exception $exception the exception to be rendered.
77
     */
78 1
    protected function renderException($exception)
79
    {
80 1
        if (Yii::$app->has('response')) {
81 1
            $response = Yii::$app->getResponse();
82
            // reset parameters of response to avoid interference with partially created response data
83
            // in case the error occurred while sending the response.
84 1
            $response->isSent = false;
85 1
            $response->stream = null;
86 1
            $response->data = null;
87 1
            $response->content = null;
88 1
        } else {
89
            $response = new Response();
90
        }
91
92 1
        $response->setStatusCodeByException($exception);
93
94 1
        $useErrorView = $response->format === Response::FORMAT_HTML && (!YII_DEBUG || $exception instanceof UserException);
95
96 1
        if ($useErrorView && $this->errorAction !== null) {
97
            $result = Yii::$app->runAction($this->errorAction);
98
            if ($result instanceof Response) {
99
                $response = $result;
100
            } else {
101
                $response->data = $result;
102
            }
103 1
        } elseif ($response->format === Response::FORMAT_HTML) {
104 1
            if ($this->shouldRenderSimpleHtml()) {
105
                // AJAX request
106
                $response->data = '<pre>' . $this->htmlEncode(static::convertExceptionToString($exception)) . '</pre>';
107
            } else {
108
                // if there is an error during error rendering it's useful to
109
                // display PHP error in debug mode instead of a blank screen
110 1
                if (YII_DEBUG) {
111 1
                    ini_set('display_errors', 1);
112 1
                }
113 1
                $file = $useErrorView ? $this->errorView : $this->exceptionView;
114 1
                $response->data = $this->renderFile($file, [
115 1
                    'exception' => $exception,
116 1
                ]);
117
            }
118 1
        } elseif ($response->format === Response::FORMAT_RAW) {
119
            $response->data = static::convertExceptionToString($exception);
120
        } else {
121
            $response->data = $this->convertExceptionToArray($exception);
122
        }
123
124 1
        $response->send();
125 1
    }
126
127
    /**
128
     * Converts an exception into an array.
129
     * @param \Exception $exception the exception being converted
130
     * @return array the array representation of the exception.
131
     */
132
    protected function convertExceptionToArray($exception)
133
    {
134
        if (!YII_DEBUG && !$exception instanceof UserException && !$exception instanceof HttpException) {
135
            $exception = new HttpException(500, Yii::t('yii', 'An internal server error occurred.'));
136
        }
137
138
        $array = [
139
            'name' => ($exception instanceof Exception || $exception instanceof ErrorException) ? $exception->getName() : 'Exception',
140
            'message' => $exception->getMessage(),
141
            'code' => $exception->getCode(),
142
        ];
143
        if ($exception instanceof HttpException) {
144
            $array['status'] = $exception->statusCode;
145
        }
146
        if (YII_DEBUG) {
147
            $array['type'] = get_class($exception);
148
            if (!$exception instanceof UserException) {
149
                $array['file'] = $exception->getFile();
150
                $array['line'] = $exception->getLine();
151
                $array['stack-trace'] = explode("\n", $exception->getTraceAsString());
152
                if ($exception instanceof \yii\db\Exception) {
153
                    $array['error-info'] = $exception->errorInfo;
154
                }
155
            }
156
        }
157
        if (($prev = $exception->getPrevious()) !== null) {
158
            $array['previous'] = $this->convertExceptionToArray($prev);
159
        }
160
161
        return $array;
162
    }
163
164
    /**
165
     * Converts special characters to HTML entities.
166
     * @param string $text to encode.
167
     * @return string encoded original text.
168
     */
169 3
    public function htmlEncode($text)
170
    {
171 3
        return htmlspecialchars($text, ENT_QUOTES, 'UTF-8');
172
    }
173
174
    /**
175
     * Adds informational links to the given PHP type/class.
176
     * @param string $code type/class name to be linkified.
177
     * @return string linkified with HTML type/class name.
178
     */
179
    public function addTypeLinks($code)
180
    {
181
        if (preg_match('/(.*?)::([^(]+)/', $code, $matches)) {
182
            $class = $matches[1];
183
            $method = $matches[2];
184
            $text = $this->htmlEncode($class) . '::' . $this->htmlEncode($method);
185
        } else {
186
            $class = $code;
187
            $method = null;
188
            $text = $this->htmlEncode($class);
189
        }
190
191
        $url = null;
192
193
        $shouldGenerateLink = true;
194
        if ($method !== null) {
195
            $reflection = new \ReflectionMethod($class, $method);
196
            $shouldGenerateLink = $reflection->isPublic() || $reflection->isProtected();
197
        }
198
199
        if ($shouldGenerateLink) {
200
            $url = $this->getTypeUrl($class, $method);
201
        }
202
203
        if ($url === null) {
204
            return $text;
205
        }
206
207
        return '<a href="' . $url . '" target="_blank">' . $text . '</a>';
208
    }
209
210
    /**
211
     * Returns the informational link URL for a given PHP type/class.
212
     * @param string $class the type or class name.
213
     * @param string|null $method the method name.
214
     * @return string|null the informational link URL.
215
     * @see addTypeLinks()
216
     */
217
    protected function getTypeUrl($class, $method)
218
    {
219
        if (strpos($class, 'yii\\') !== 0) {
220
            return null;
221
        }
222
223
        $page = $this->htmlEncode(strtolower(str_replace('\\', '-', $class)));
224
        $url = "http://www.yiiframework.com/doc-2.0/$page.html";
225
        if ($method) {
0 ignored issues
show
Bug Best Practice introduced by
The expression $method of type string|null is loosely compared to true; this is ambiguous if the string can be empty. You might want to explicitly use !== null instead.

In PHP, under loose comparison (like ==, or !=, or switch conditions), values of different types might be equal.

For string values, the empty string '' is a special case, in particular the following results might be unexpected:

''   == false // true
''   == null  // true
'ab' == false // false
'ab' == null  // false

// It is often better to use strict comparison
'' === false // false
'' === null  // false
Loading history...
226
            $url .= "#$method()-detail";
227
        }
228
229
        return $url;
230
    }
231
232
    /**
233
     * Renders a view file as a PHP script.
234
     * @param string $_file_ the view file.
235
     * @param array $_params_ the parameters (name-value pairs) that will be extracted and made available in the view file.
236
     * @return string the rendering result
237
     */
238 4
    public function renderFile($_file_, $_params_)
239
    {
240 4
        $_params_['handler'] = $this;
241 4
        if ($this->exception instanceof ErrorException || !Yii::$app->has('view')) {
242
            ob_start();
243
            ob_implicit_flush(false);
244
            extract($_params_, EXTR_OVERWRITE);
245
            require(Yii::getAlias($_file_));
246
247
            return ob_get_clean();
248
        } else {
249 4
            return Yii::$app->getView()->renderFile($_file_, $_params_, $this);
250
        }
251
    }
252
253
    /**
254
     * Renders the previous exception stack for a given Exception.
255
     * @param \Exception $exception the exception whose precursors should be rendered.
256
     * @return string HTML content of the rendered previous exceptions.
257
     * Empty string if there are none.
258
     */
259
    public function renderPreviousExceptions($exception)
260
    {
261
        if (($previous = $exception->getPrevious()) !== null) {
262
            return $this->renderFile($this->previousExceptionView, ['exception' => $previous]);
263
        } else {
264
            return '';
265
        }
266
    }
267
268
    /**
269
     * Renders a single call stack element.
270
     * @param string|null $file name where call has happened.
271
     * @param int|null $line number on which call has happened.
272
     * @param string|null $class called class name.
273
     * @param string|null $method called function/method name.
274
     * @param array $args array of method arguments.
275
     * @param int $index number of the call stack element.
276
     * @return string HTML content of the rendered call stack element.
277
     */
278
    public function renderCallStackItem($file, $line, $class, $method, $args, $index)
279
    {
280
        $lines = [];
281
        $begin = $end = 0;
282
        if ($file !== null && $line !== null) {
283
            $line--; // adjust line number from one-based to zero-based
284
            $lines = @file($file);
285
            if ($line < 0 || $lines === false || ($lineCount = count($lines)) < $line) {
286
                return '';
287
            }
288
289
            $half = (int) (($index === 1 ? $this->maxSourceLines : $this->maxTraceSourceLines) / 2);
290
            $begin = $line - $half > 0 ? $line - $half : 0;
291
            $end = $line + $half < $lineCount ? $line + $half : $lineCount - 1;
292
        }
293
294
        return $this->renderFile($this->callStackItemView, [
295
            'file' => $file,
296
            'line' => $line,
297
            'class' => $class,
298
            'method' => $method,
299
            'index' => $index,
300
            'lines' => $lines,
301
            'begin' => $begin,
302
            'end' => $end,
303
            'args' => $args,
304
        ]);
305
    }
306
307
    /**
308
     * Renders the global variables of the request.
309
     * List of global variables is defined in [[displayVars]].
310
     * @return string the rendering result
311
     * @see displayVars
312
     */
313
    public function renderRequest()
314
    {
315
        $request = '';
316
        foreach ($this->displayVars as $name) {
317
            if (!empty($GLOBALS[$name])) {
318
                $request .= '$' . $name . ' = ' . VarDumper::export($GLOBALS[$name]) . ";\n\n";
319
            }
320
        }
321
322
        return '<pre>' . $this->htmlEncode(rtrim($request, "\n")) . '</pre>';
323
    }
324
325
    /**
326
     * Determines whether given name of the file belongs to the framework.
327
     * @param string $file name to be checked.
328
     * @return bool whether given name of the file belongs to the framework.
329
     */
330
    public function isCoreFile($file)
331
    {
332
        return $file === null || strpos(realpath($file), YII2_PATH . DIRECTORY_SEPARATOR) === 0;
333
    }
334
335
    /**
336
     * Creates HTML containing link to the page with the information on given HTTP status code.
337
     * @param int $statusCode to be used to generate information link.
338
     * @param string $statusDescription Description to display after the the status code.
339
     * @return string generated HTML with HTTP status code information.
340
     */
341
    public function createHttpStatusLink($statusCode, $statusDescription)
342
    {
343
        return '<a href="http://en.wikipedia.org/wiki/List_of_HTTP_status_codes#' . (int) $statusCode . '" target="_blank">HTTP ' . (int) $statusCode . ' &ndash; ' . $statusDescription . '</a>';
344
    }
345
346
    /**
347
     * Creates string containing HTML link which refers to the home page of determined web-server software
348
     * and its full name.
349
     * @return string server software information hyperlink.
350
     */
351
    public function createServerInformationLink()
352
    {
353
        $serverUrls = [
354
            'http://httpd.apache.org/' => ['apache'],
355
            'http://nginx.org/' => ['nginx'],
356
            'http://lighttpd.net/' => ['lighttpd'],
357
            'http://gwan.com/' => ['g-wan', 'gwan'],
358
            'http://iis.net/' => ['iis', 'services'],
359
            'http://php.net/manual/en/features.commandline.webserver.php' => ['development'],
360
        ];
361
        if (isset($_SERVER['SERVER_SOFTWARE'])) {
362
            foreach ($serverUrls as $url => $keywords) {
363
                foreach ($keywords as $keyword) {
364
                    if (stripos($_SERVER['SERVER_SOFTWARE'], $keyword) !== false) {
365
                        return '<a href="' . $url . '" target="_blank">' . $this->htmlEncode($_SERVER['SERVER_SOFTWARE']) . '</a>';
366
                    }
367
                }
368
            }
369
        }
370
371
        return '';
372
    }
373
374
    /**
375
     * Creates string containing HTML link which refers to the page with the current version
376
     * of the framework and version number text.
377
     * @return string framework version information hyperlink.
378
     */
379
    public function createFrameworkVersionLink()
380
    {
381
        return '<a href="http://github.com/yiisoft/yii2/" target="_blank">' . $this->htmlEncode(Yii::getVersion()) . '</a>';
382
    }
383
384
    /**
385
     * Converts arguments array to its string representation
386
     *
387
     * @param array $args arguments array to be converted
388
     * @return string string representation of the arguments array
389
     */
390
    public function argumentsToString($args)
391
    {
392
        $count = 0;
393
        $isAssoc = $args !== array_values($args);
394
395
        foreach ($args as $key => $value) {
396
            $count++;
397
            if ($count>=5) {
398
                if ($count>5) {
399
                    unset($args[$key]);
400
                } else {
401
                    $args[$key] = '...';
402
                }
403
                continue;
404
            }
405
406
            if (is_object($value)) {
407
                $args[$key] = '<span class="title">' . $this->htmlEncode(get_class($value)) . '</span>';
408
            } elseif (is_bool($value)) {
409
                $args[$key] = '<span class="keyword">' . ($value ? 'true' : 'false') . '</span>';
410
            } elseif (is_string($value)) {
411
                $fullValue = $this->htmlEncode($value);
412
                if (mb_strlen($value, 'UTF-8') > 32) {
413
                    $displayValue = $this->htmlEncode(mb_substr($value, 0, 32, 'UTF-8')) . '...';
414
                    $args[$key] = "<span class=\"string\" title=\"$fullValue\">'$displayValue'</span>";
415
                } else {
416
                    $args[$key] = "<span class=\"string\">'$fullValue'</span>";
417
                }
418
            } elseif (is_array($value)) {
419
                $args[$key] = '[' . $this->argumentsToString($value) . ']';
420
            } elseif ($value === null) {
421
                $args[$key] = '<span class="keyword">null</span>';
422
            } elseif (is_resource($value)) {
423
                $args[$key] = '<span class="keyword">resource</span>';
424
            } else {
425
                $args[$key] = '<span class="number">' . $value . '</span>';
426
            }
427
428
            if (is_string($key)) {
429
                $args[$key] = '<span class="string">\'' . $this->htmlEncode($key) . "'</span> => $args[$key]";
430
            } elseif ($isAssoc) {
431
                $args[$key] = "<span class=\"number\">$key</span> => $args[$key]";
432
            }
433
        }
434
435
        return implode(', ', $args);
436
    }
437
438
    /**
439
     * Returns human-readable exception name
440
     * @param \Exception $exception
441
     * @return string human-readable exception name or null if it cannot be determined
442
     */
443 3
    public function getExceptionName($exception)
444
    {
445 3
        if ($exception instanceof \yii\base\Exception || $exception instanceof \yii\base\InvalidCallException || $exception instanceof \yii\base\InvalidParamException || $exception instanceof \yii\base\UnknownMethodException) {
446 3
            return $exception->getName();
447
        }
448
        return null;
449
    }
450
451
    /**
452
     * @return bool if simple HTML should be rendered
453
     */
454
    protected function shouldRenderSimpleHtml()
455
    {
456
        return YII_ENV_TEST || isset($_SERVER['HTTP_X_REQUESTED_WITH']) && $_SERVER['HTTP_X_REQUESTED_WITH'] === 'XMLHttpRequest';
457
    }
458
}
459