Question

我正在使用Laravel 5构建REST API。

在Laravel 5中，您可以继承App\Http\Requests\Request以定义在处理特定路由之前必须满足的验证规则。例如：

<?php

namespace App\Http\Requests;

use App\Http\Requests\Request;

class BookStoreRequest extends Request {

    public function authorize() {
        return true;
    }

    public function rules() {
        return [
            'title' => 'required',
            'author_id' => 'required'
        ];
    }
}

如果客户端通过AJAX请求加载相应的路由，并且BookStoreRequest发现请求不满足规则，它将自动将错误作为JSON对象返回。例如：

{
  "title": [
    "The title field is required."
  ]
}

但是，Request::rules()方法只能验证输入 - 即使输入有效，在请求已被接受并传递给控制器之后也可能出现其他类型的错误。例如，让我们说控制器出于某种原因需要将新书信息写入文件 - 但是文件无法打开：

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

use App\Http\Requests;
use App\Http\Controllers\Controller;

use App\Http\Requests\BookCreateRequest;

class BookController extends Controller {

    public function store( BookStoreRequest $request ) {

        $file = fopen( '/path/to/some/file.txt', 'a' );

        // test to make sure we got a good file handle
        if ( false === $file ) {
            // HOW CAN I RETURN AN ERROR FROM HERE?
        }

        fwrite( $file, 'book info goes here' );
        fclose( $file );

        // inform the browser of success
        return response()->json( true );

    }

}

显然，我可以die()，但这非常难看。我宁愿以与验证错误相同的格式返回我的错误消息。像这样：

{
  "myErrorKey": [
    "A filesystem error occurred on the server. Please contact your administrator."
  ]
}

我可以构建自己的JSON对象并返回它 - 但是Laravel肯定会支持它。

最好/最干净的方法是什么？或者是否有更好的方法从Laravel REST API返回运行时（而不是验证时间）错误？

Answer 1

您可以在json响应中设置状态代码，如下所示：

return Response::json(['error' => 'Error msg'], 404); // Status code here

或者只是使用帮助函数：

return response()->json(['error' => 'Error msg'], 404); // Status code here

Answer 2

你可以通过多种方式实现这一目标。

首先，您可以通过提供状态代码来使用简单的response()->json()：

return response()->json( /** response **/, 401 );

或者，以更复杂的方式确保每个错误都是json响应，您可以设置异常处理程序来捕获特殊异常并返回json。

打开App\Exceptions\Handler并执行以下操作：

class Handler extends ExceptionHandler
{
    /**
     * A list of the exception types that should not be reported.
     *
     * @var array
     */
    protected $dontReport = [
        HttpException::class,
        HttpResponseException::class,
        ModelNotFoundException::class,
        NotFoundHttpException::class,
        // Don't report MyCustomException, it's only for returning son errors.
        MyCustomException::class
    ];

    public function render($request, Exception $e)
    {
        // This is a generic response. You can the check the logs for the exceptions
        $code = 500;
        $data = [
            "error" => "We couldn't hadle this request. Please contact support."
        ];

        if($e instanceof MyCustomException) {
            $code = $e->getStatusCode();
            $data = $e->getData();
        }

        return response()->json($data, $code);
    }
}

这将返回应用程序中抛出的任何异常的json。现在，我们创建MyCustomException，例如在app / Exceptions：

class MyCustomException extends Exception {

    protected $data;
    protected $code;

    public static function error($data, $code = 500)
    {
        $e = new self;
        $e->setData($data);
        $e->setStatusCode($code);

        throw $e;
    }

    public function setStatusCode($code)
    {
        $this->code = $code;
    }

    public function setData($data)
    {
        $this->data = $data;
    }


    public function getStatusCode()
    {
        return $this->code;
    }

    public function getData()
    {
        return $this->data;
    }
}

我们现在可以使用MyCustomException或任何扩展MyCustomException的异常来返回json错误。

public function store( BookStoreRequest $request ) {

    $file = fopen( '/path/to/some/file.txt', 'a' );

    // test to make sure we got a good file handle
    if ( false === $file ) {
        MyCustomException::error(['error' => 'could not open the file, check permissions.'], 403);

    }

    fwrite( $file, 'book info goes here' );
    fclose( $file );

    // inform the browser of success
    return response()->json( true );

}

现在，不仅通过MyCustomException抛出的异常将返回json错误，而且一般会抛出任何其他异常。

Answer 3

一个简单的方法是在控制器中使用 abort() 方法。这将返回一个错误，该错误将被 ajax error:function(){}

控制器示例

public function boost_reputation(Request $request){
    
        $page_owner = User::where('id', $request->page_owner_id)->first();

        // user needs to login to boost reputation
        if(!Auth::user()){
            toast('Sorry, you need to login first.','info');
            abort();
        }

        // page owner cannot boost his own reputation
        if(Auth::user() == $page_owner){
            toast("Sorry, you can't boost your own reputation.",'info');
            abort();
        }
}

Ajax 示例

$('.reputation-btn').on('click',function(event){

   var btn = this;
   var route = "{{ route('boost_reputation') }}";
   var csrf_token = '{{ csrf_token() }}';
   var id = '{{ $page_owner->id }}';

   $.ajax({
     method: 'POST',
     url: route,
     data: {page_owner_id:id, _token:csrf_token},

     success:function(data) {
        ...your success code
     },
     error: function () {
        ...your error code
     }

   });
});

更多信息：https://laravel.com/docs/7.x/errors

如何从Laravel控制器返回AJAX错误？

3 个答案:

控制器示例

Ajax 示例