Merge pull request #8 from hankz1108/main

Release v0.2.1

Author: hankz1108

docs/en/11/index.md

@@ -8,6 +8,9 @@ Run the Composer require command from the Terminal:
 composer require hankz/laravel-plus-api
 ```
 
+> [!TIP]
+> After Laravel 11, you may need to use `php artisan install:api` first to utilize the API.
+
 ### 2. Setup
 
 This package supports Laravel's auto-discovery feature and it's ready to use once installed.
@@ -57,6 +60,14 @@ Set exception Handler.
 in `bootstrap/app.php`，add：
 
 ```php
+use Hankz\LaravelPlusApi\Classes\ApiResponseBuilder;
+use Illuminate\Auth\AuthenticationException;
+use Illuminate\Http\Request;
+use Illuminate\Validation\ValidationException;
+use Symfony\Component\HttpKernel\Exception\HttpExceptionInterface;
+
+// other code...
+
 ->withExceptions(function (Exceptions $exceptions) {
     $exceptions->render(function (Throwable $throwable, Request $request) {
 

src/Classes/ApiResponseBuilder.php

@@ -23,12 +23,15 @@ public static function validationError(ValidationException $e): JsonResponse
             ->build();
     }
 
+    /**
+     * @param object|array|null $data
+     */
     public static function exceptionError(
         Throwable $throwable = null,
         string $apiCode = null,
         int $httpCode,
         string $message = null,
-        string $data = null,
+        mixed $data = null,
         array $headers = []
     ): JsonResponse {
         $apiCode = $apiCode ?? config('laravel-plus-api.default_response.error.api_code');

src/Exceptions/ApiException.php

@@ -11,10 +11,15 @@
 
 abstract class ApiException extends Exception implements HttpExceptionInterface
 {
+    // return api code, override if needed
     public const API_CODE = Response::HTTP_INTERNAL_SERVER_ERROR;
 
+    // return http code, override if needed
     public const HTTP_CODE = Response::HTTP_INTERNAL_SERVER_ERROR;
 
+    // return message, override if needed
+    public const API_MESSAGE = '';
+
     /**
      * message.
      *
@@ -33,13 +38,9 @@ public function __construct(string $message = null, $data = null)
     {
         parent::__construct($message);
 
-        if (!is_null($message)) {
-            $this->message = $message;
-        }
+        $this->message = $message ?? static::API_MESSAGE;
 
-        if (!is_null($data)) {
-            $this->data = $data;
-        }
+        $this->data = $data;
     }
 
     /**