Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

[5.5] Ensure uncaught exceptions are returned in JSON if required #18732

Merged
merged 9 commits into from
Apr 10, 2017
Merged

[5.5] Ensure uncaught exceptions are returned in JSON if required #18732

Show file tree
Hide file tree
Changes from 8 commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
cd69e50
ajax for errors
laurencei Apr 8, 2017
655d3ce
refactor clean up array
laurencei Apr 8, 2017
44166d6
add Foundation Exceptions tests
laurencei Apr 8, 2017
4a4a6f6
remove unused class from test
laurencei Apr 8, 2017
bc16cc7
improve tests
laurencei Apr 8, 2017
7b33de4
fix typo and use local variable
laurencei Apr 8, 2017
f04172f
formatting
laurencei Apr 9, 2017
84506c1
formatting
laurencei Apr 9, 2017
bf5d8c4
refactor JsonResponse
laurencei Apr 10, 2017
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 15 additions & 7 deletions src/Illuminate/Foundation/Exceptions/Handler.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -139,7 +139,7 @@ public function render($request, Exception $e)
return $this->convertValidationExceptionToResponse($e, $request);
}

return $request->expectsJson() && config('app.debug')
return $request->expectsJson()
? $this->prepareJsonResponse($request, $e)
: $this->prepareResponse($request, $e);
}
Expand Down Expand Up @@ -220,12 +220,20 @@ protected function prepareJsonResponse($request, Exception $e)

$headers = $this->isHttpException($e) ? $e->getHeaders() : [];

return response(json_encode([
'message' => $e->getMessage(),
'file' => $e->getFile(),
'line' => $e->getLine(),
'trace' => $e->getTrace(),
], JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES), $status, array_merge($headers, [
if (config('app.debug')) {
$response = [
'message' => $e->getMessage(),
'file' => $e->getFile(),
'line' => $e->getLine(),
'trace' => $e->getTrace(),
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry, I don't think we should response a different json in debug mode and the production mode.

Further more, the exception code (getCode()) may have much more valuable.

May be we should just hide the trace for some security consideration. Also we should consider the translation for the message.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry, I don't think we should response a different json in debug mode and the production mode.

Taylor already added JSON stuff for debug in the master branch. This PR is not adding it.

We are just putting JSON for production when it was requested via AJAX.

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You should just hide the trace in production. Or replace it with the exception's getCode. I think the translation for the message is really important. Could you add these code ?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Translation of exceptions should probably be a different PR though - as that is a separate to what is occurring in this PR?

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe, but it is relate these code, about the exception. It doesn't matter how the code work. Please consider the exception code, the translation. The file name and the exception line shown in production may not be safe for the server.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The file name and the exception line shown in production may not be safe for the server.

Correct - we only return the detailed information if debug is true.

];
} else {
$response = [
'message' => $this->isHttpException($e) ? $e->getMessage() : 'Server Error',
];
}

return response(json_encode($response, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES), $status, array_merge($headers, [
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

So we actually can only return JSON here, why not just:

return new JsonResponse($response, $status, $headers, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);

@return doblock should be changed accordingly

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@lucasmichot - that line of code is basically what was already in the master branch. But I agree your way seems cleaner - so I've updated the PR.

'Content-Type' => 'application/json',
]));
}
Expand Down
107 changes: 107 additions & 0 deletions tests/Foundation/FoundationExceptionsHandlerTest.php
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,107 @@
<?php

namespace Illuminate\Tests\Foundation;

use Exception;
use Mockery as m;
use PHPUnit\Framework\TestCase;
use Illuminate\Container\Container;
use Illuminate\Config\Repository as Config;
use Illuminate\Foundation\Exceptions\Handler;
use Symfony\Component\HttpKernel\Exception\HttpException;

class FoundationExceptionsHandlerTest extends TestCase
{
protected $config;

protected $container;

protected $handler;

protected $request;

public function setUp()
{
$this->config = m::mock(Config::class);

$this->request = m::mock('StdClass');

$this->container = Container::setInstance(new Container);

$this->container->singleton('config', function () {
return $this->config;
});

$this->container->singleton('Illuminate\Contracts\Routing\ResponseFactory', function () {
return new \Illuminate\Routing\ResponseFactory(
m::mock(\Illuminate\Contracts\View\Factory::class),
m::mock(\Illuminate\Routing\Redirector::class)
);
});

$this->handler = new Handler($this->container);
}

public function tearDown()
{
m::close();
}

public function testReturnsHtmlPageWithStackTraceWhenHtmlRequestAndDebugTrue()
{
$this->config->shouldReceive('get')->with('app.debug', null)->twice()->andReturn(true);
$this->request->shouldReceive('expectsJson')->once()->andReturn(false);

$response = $this->handler->render($this->request, new Exception('My custom error message'))->getContent();

$this->assertContains('<!DOCTYPE html>', $response);
$this->assertContains('<h1>Whoops, looks like something went wrong.</h1>', $response);
$this->assertContains('My custom error message', $response);
$this->assertContains('::main()', $response);
$this->assertNotContains('"message":', $response);
}

public function testReturnsJsonWithStackTraceWhenAjaxRequestAndDebugTrue()
{
$this->config->shouldReceive('get')->with('app.debug', null)->once()->andReturn(true);
$this->request->shouldReceive('expectsJson')->once()->andReturn(true);

$response = $this->handler->render($this->request, new Exception('My custom error message'))->getContent();

$this->assertNotContains('<!DOCTYPE html>', $response);
$this->assertContains('"message": "My custom error message"', $response);
$this->assertContains('"file":', $response);
$this->assertContains('"line":', $response);
$this->assertContains('"trace":', $response);
}

public function testReturnsJsonWithoutStackTraceWhenAjaxRequestAndDebugFalseAndExceptionMessageIsMasked()
{
$this->config->shouldReceive('get')->with('app.debug', null)->once()->andReturn(false);
$this->request->shouldReceive('expectsJson')->once()->andReturn(true);

$response = $this->handler->render($this->request, new Exception('This error message should not be visible'))->getContent();

$this->assertContains('"message": "Server Error"', $response);
$this->assertNotContains('<!DOCTYPE html>', $response);
$this->assertNotContains('This error message should not be visible', $response);
$this->assertNotContains('"file":', $response);
$this->assertNotContains('"line":', $response);
$this->assertNotContains('"trace":', $response);
}

public function testReturnsJsonWithoutStackTraceWhenAjaxRequestAndDebugFalseAndHttpExceptionErrorIsShown()
{
$this->config->shouldReceive('get')->with('app.debug', null)->once()->andReturn(false);
$this->request->shouldReceive('expectsJson')->once()->andReturn(true);

$response = $this->handler->render($this->request, new HttpException(403, 'My custom error message'))->getContent();

$this->assertContains('"message": "My custom error message"', $response);
$this->assertNotContains('<!DOCTYPE html>', $response);
$this->assertNotContains('"message": "Server Error"', $response);
$this->assertNotContains('"file":', $response);
$this->assertNotContains('"line":', $response);
$this->assertNotContains('"trace":', $response);
}
}