feat(api): 上传文件 (#77)

Author: zhaiyuxin103

Diff for: app/Http/Controllers/FileController.php

@@ -0,0 +1,78 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers;
+
+use App\Http\Requests\FileRequest;
+use Illuminate\Support\Facades\Storage;
+use Jiannei\Response\Laravel\Support\Facades\Response;
+use Throwable;
+
+class FileController extends Controller
+{
+    /**
+     * Display a listing of the resource.
+     */
+    public function index()
+    {
+        //
+    }
+
+    /**
+     * Show the form for creating a new resource.
+     */
+    public function create()
+    {
+        //
+    }
+
+    /**
+     * Store a newly created resource in storage.
+     */
+    public function store(FileRequest $request)
+    {
+        try {
+            $path = $request->file('file')->store('files');
+
+            return Response::created([
+                'path'      => $path,
+                'full_path' => Storage::url($path),
+            ], trans('messages.success.uploaded'));
+        } catch (Throwable $e) {
+            return Response::fail($e->getMessage() ?: trans('messages.failed.uploaded'));
+        }
+    }
+
+    /**
+     * Display the specified resource.
+     */
+    public function show()
+    {
+        //
+    }
+
+    /**
+     * Show the form for editing the specified resource.
+     */
+    public function edit()
+    {
+        //
+    }
+
+    /**
+     * Update the specified resource in storage.
+     */
+    public function update(FileRequest $request)
+    {
+        //
+    }
+
+    /**
+     * Remove the specified resource from storage.
+     */
+    public function destroy()
+    {
+        //
+    }
+}

Diff for: app/Http/Requests/FileRequest.php

@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Requests;
+
+class FileRequest extends Request
+{
+    /**
+     * Get the validation rules that apply to the request.
+     *
+     * @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
+     */
+    public function rules(): array
+    {
+        return match ($this->method()) {
+            'POST' => [
+                'file' => ['required', 'file', 'mimes:jpg,jpeg,png', 'max:10240'],
+            ],
+            default => [],
+        };
+    }
+}

Diff for: lang/en/messages.php

@@ -12,6 +12,7 @@
         'current_password_not_match'      => 'Current password does not match.',
         'password_same_current_password'  => 'New password is the same as the current password.',
         'reset_password'                  => 'Failed to reset password.',
+        'uploaded'                        => 'Failed to upload file.',
     ],
     'success' => [
         'verification_code_issued' => 'Verification code issued successfully.',
@@ -21,5 +22,6 @@
         'created'                  => 'Created successfully.',
         'updated'                  => 'Updated successfully.',
         'reset_password'           => 'Password reset successfully.',
+        'uploaded'                 => 'Uploaded successfully.',
     ],
 ];

Diff for: lang/en/validation.php

@@ -89,14 +89,14 @@
     ],
     'max_digits' => 'The :attribute field must not have more than :max digits.',
     'messages'   => [
-        'phone' => [
-            'phone' => 'The :attribute field must be a valid phone number.',
-        ],
         'holiday' => [
             'format' => [
                 'in' => 'The format :format is not supported. Supported formats are: :values.',
             ],
         ],
+        'phone' => [
+            'phone' => 'The :attribute field must be a valid phone number.',
+        ],
     ],
     'mimes'     => 'The :attribute must be a file of type: :values.',
     'mimetypes' => 'The :attribute must be a file of type: :values.',
@@ -192,6 +192,7 @@
         'duration'                 => 'duration',
         'email'                    => 'email',
         'excerpt'                  => 'excerpt',
+        'file'                     => 'file',
         'filter'                   => 'filter',
         'finished_at'              => 'finished at',
         'first_alias'              => 'first alias',

Diff for: lang/ja/messages.php

@@ -12,6 +12,7 @@
         'current_password_not_match'      => '現在のパスワードが正しくありません。',
         'password_same_current_password'  => '新しいパスワードが現在のパスワードと同じです。',
         'reset_password'                  => 'パスワードのリセットに失敗しました。',
+        'uploaded'                        => 'ファイルのアップロードに失敗しました。',
     ],
     'success' => [
         'verification_code_issued' => '認証コードを発行しました。',
@@ -21,5 +22,6 @@
         'created'                  => '作成に成功しました。',
         'updated'                  => '更新に成功しました。',
         'reset_password'           => 'パスワードをリセットしました。',
+        'uploaded'                 => 'アップロードに成功しました。',
     ],
 ];

Diff for: lang/ja/validation.php

@@ -89,14 +89,14 @@
     ],
     'max_digits' => ':Attributeは、:max桁以下の数字である必要があります。',
     'messages'   => [
-        'phone' => [
-            'phone' => ':Attributeは有効な電話番号ではありません。',
-        ],
         'holiday' => [
             'format' => [
                 'in' => 'フォーマット「:format」は無効です，:values のいずれかを指定してください。',
             ],
         ],
+        'phone' => [
+            'phone' => ':Attributeは有効な電話番号ではありません。',
+        ],
     ],
     'mimes'     => ':Attributeには、以下のファイルタイプを指定してください。:values',
     'mimetypes' => ':Attributeには、以下のファイルタイプを指定してください。:values',
@@ -192,6 +192,7 @@
         'duration'                 => '期間',
         'email'                    => 'eメール',
         'excerpt'                  => '抜粋',
+        'file'                     => 'ファイル',
         'filter'                   => 'フィルタ',
         'finished_at'              => 'に終了しました',
         'first_alias'              => '名前の別名',

Diff for: lang/zh_CN/messages.php

@@ -12,6 +12,7 @@
         'current_password_not_match'      => '当前密码不匹配。',
         'password_same_current_password'  => '新密码与当前密码相同。',
         'reset_password'                  => '重置密码失败。',
+        'uploaded'                        => '文件上传失败。',
     ],
     'success' => [
         'verification_code_issued' => '验证码发放成功。',
@@ -21,5 +22,6 @@
         'created'                  => '创建成功。',
         'updated'                  => '更新成功。',
         'reset_password'           => '密码重置成功。',
+        'uploaded'                 => '上传成功。',
     ],
 ];

Diff for: lang/zh_CN/validation.php

@@ -89,14 +89,14 @@
     ],
     'max_digits' => ':Attribute 不能超过 :max 位数。',
     'messages'   => [
-        'phone' => [
-            'phone' => '电话号码格式不正确。',
-        ],
         'holiday' => [
             'format' => [
                 'in' => '不支持的格式: :format，支持的格式有: :values。',
             ],
         ],
+        'phone' => [
+            'phone' => '电话号码格式不正确。',
+        ],
     ],
     'mimes'     => ':Attribute 必须是一个 :values 类型的文件。',
     'mimetypes' => ':Attribute 必须是一个 :values 类型的文件。',
@@ -192,6 +192,7 @@
         'duration'                 => '期间',
         'email'                    => '邮箱',
         'excerpt'                  => '摘要',
+        'file'                     => '文件',
         'filter'                   => '过滤',
         'finished_at'              => '完成于',
         'first_alias'              => '第一个别名',

Diff for: routes/api.php

@@ -3,6 +3,7 @@
 declare(strict_types=1);
 
 use App\Http\Controllers\AuthorizationController;
+use App\Http\Controllers\FileController;
 use App\Http\Controllers\UserController;
 use App\Http\Controllers\VerificationCodeController;
 use Illuminate\Http\Request;
@@ -28,6 +29,8 @@
 Route::middleware('throttle:' . config('api.rate_limits.access'))->group(function () {
     // 某个用户的详情
     Route::get('users/{user}', [UserController::class, 'show'])->name('users.show');
+    // 上传文件
+    Route::post('files', [FileController::class, 'store'])->name('files.store');
     // 登录后可以访问的接口
     Route::middleware('auth:sanctum')->group(function () {
         // 当前登录用户信息