init

2026-09-30 11:11:54 +08:00
parent cb9b7a4bd4
commit 2fb57ec490
160 changed files with 14764 additions and 53 deletions
@@ -0,0 +1,86 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tests\Feature;
+
+use App\Support\ApiResponse;
+use Illuminate\Http\Request;
+use Illuminate\Pagination\LengthAwarePaginator;
+use Illuminate\Support\Facades\Route;
+use Tests\TestCase;
+
+class ApiExceptionTest extends TestCase
+{
+    public function test_unknown_api_route_uses_the_failure_envelope(): void
+    {
+        config(['app.debug' => true]);
+
+        $response = $this->getJson('/api/v1/does-not-exist');
+
+        $response->assertNotFound()
+            ->assertExactJson([
+                'success' => false,
+                'message' => '资源不存在',
+                'errors' => [],
+            ]);
+    }
+
+    public function test_validation_errors_use_the_failure_envelope(): void
+    {
+        Route::post('/api/v1/_validation_probe', function (Request $request) {
+            $request->validate(['name' => ['required', 'string']]);
+
+            return ApiResponse::success();
+        });
+
+        $response = $this->postJson('/api/v1/_validation_probe', []);
+
+        $response->assertStatus(422)
+            ->assertJsonPath('success', false)
+            ->assertJsonPath('message', '参数错误')
+            ->assertJsonStructure(['errors' => ['name']]);
+    }
+
+    public function test_method_not_allowed_uses_the_failure_envelope(): void
+    {
+        $this->postJson('/api/v1/health')
+            ->assertStatus(405)
+            ->assertJsonPath('success', false)
+            ->assertJsonPath('message', '方法不允许');
+    }
+
+    public function test_paginated_payload_uses_meta(): void
+    {
+        $paginator = new LengthAwarePaginator(
+            items: [['sku_code' => 'A-1']],
+            total: 21,
+            perPage: 20,
+            currentPage: 1,
+        );
+
+        $payload = ApiResponse::paginated($paginator)->getData(true);
+
+        $this->assertSame([
+            'success' => true,
+            'message' => 'OK',
+            'data' => [
+                ['sku_code' => 'A-1'],
+            ],
+            'meta' => [
+                'current_page' => 1,
+                'per_page' => 20,
+                'total' => 21,
+                'last_page' => 2,
+            ],
+        ], $payload);
+    }
+
+    public function test_per_page_is_capped(): void
+    {
+        $this->assertSame(20, ApiResponse::perPage(null));
+        $this->assertSame(20, ApiResponse::perPage(0));
+        $this->assertSame(50, ApiResponse::perPage('50'));
+        $this->assertSame(100, ApiResponse::perPage(500));
+    }
+}