رفع الملفات عبر واجهة برمجة التطبيقات

POST /api/posts HTTP/1.1 Host: example.com Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW Authorization: Bearer your-token-here ------WebKitFormBoundary7MA4YWxkTrZu0gW Content-Disposition: form-data; name="title" منشور مدونتي ------WebKitFormBoundary7MA4YWxkTrZu0gW Content-Disposition: form-data; name="content" هذا هو محتوى المنشور ------WebKitFormBoundary7MA4YWxkTrZu0gW Content-Disposition: form-data; name="image"; filename="photo.jpg" Content-Type: image/jpeg [بيانات الملف الثنائي هنا] ------WebKitFormBoundary7MA4YWxkTrZu0gW--

<?php namespace App\Http\Controllers\Api; use App\Http\Controllers\Controller; use Illuminate\Http\Request; use Illuminate\Support\Facades\Storage; class FileUploadController extends Controller { public function upload(Request $request) { // التحقق من صحة الملف المرفوع $request->validate([ \047file\047 => \047required|file|max:10240\047, // 10MB كحد أقصى ]); // تخزين الملف $path = $request->file(\047file\047)->store(\047uploads\047, \047public\047); // إرجاع عنوان URL للملف return response()->json([ \047success\047 => true, \047message\047 => \047تم رفع الملف بنجاح\047, \047data\047 => [ \047path\047 => $path, \047url\047 => Storage::url($path), \047size\047 => $request->file(\047file\047)->getSize(), \047mime_type\047 => $request->file(\047file\047)->getMimeType(), ], ], 201); } }

<?php public function uploadImage(Request $request) { $validator = Validator::make($request->all(), [ \047image\047 => [ \047required\047, \047file\047, \047image\047, // يجب أن تكون صورة \047mimes:jpeg,png,jpg,gif,webp\047, // التنسيقات المسموحة \047max:5120\047, // 5MB كحد أقصى \047dimensions:min_width=100,min_height=100,max_width=4000,max_height=4000\047, ], \047title\047 => \047sometimes|string|max:255\047, \047alt_text\047 => \047sometimes|string|max:255\047, ]); if ($validator->fails()) { return response()->json([ \047success\047 => false, \047message\047 => \047فشل التحقق من الصحة\047, \047errors\047 => $validator->errors(), ], 422); } // معالجة الرفع $image = $request->file(\047image\047); // أمان إضافي: التحقق من محتوى الملف الفعلي $imageInfo = getimagesize($image->getPathname()); if ($imageInfo === false) { return response()->json([ \047success\047 => false, \047message\047 => \047ملف صورة غير صالح\047, ], 422); } // التخزين باسم ملف مخصص $filename = time() . \047_\047 . uniqid() . \047.\047 . $image->extension(); $path = $image->storeAs(\047images\047, $filename, \047public\047); return response()->json([ \047success\047 => true, \047data\047 => [ \047url\047 => Storage::url($path), \047path\047 => $path, \047size\047 => $image->getSize(), \047width\047 => $imageInfo[0], \047height\047 => $imageInfo[1], ], ], 201); }

<?php return [ \047default\047 => env(\047FILESYSTEM_DISK\047, \047local\047), \047disks\047 => [ // التخزين المحلي \047local\047 => [ \047driver\047 => \047local\047, \047root\047 => storage_path(\047app\047), ], // التخزين العام (يمكن الوصول إليه عبر الويب) \047public\047 => [ \047driver\047 => \047local\047, \047root\047 => storage_path(\047app/public\047), \047url\047 => env(\047APP_URL\047).\047/storage\047, \047visibility\047 => \047public\047, ], // Amazon S3 \047s3\047 => [ \047driver\047 => \047s3\047, \047key\047 => env(\047AWS_ACCESS_KEY_ID\047), \047secret\047 => env(\047AWS_SECRET_ACCESS_KEY\047), \047region\047 => env(\047AWS_DEFAULT_REGION\047), \047bucket\047 => env(\047AWS_BUCKET\047), \047url\047 => env(\047AWS_URL\047), ], ], ];

<?php // التثبيت: composer require league/flysystem-aws-s3-v3 public function uploadToS3(Request $request) { $request->validate([ \047file\047 => \047required|file|max:10240\047, ]); $file = $request->file(\047file\047); // إنشاء اسم ملف فريد $filename = \047uploads/\047 . date(\047Y/m/d\047) . \047/\047 . uniqid() . \047.\047 . $file->extension(); // الرفع إلى S3 مع الرؤية العامة $path = Storage::disk(\047s3\047)->putFileAs( \047\047, $file, $filename, \047public\047 ); // الحصول على عنوان URL العام $url = Storage::disk(\047s3\047)->url($path); return response()->json([ \047success\047 => true, \047data\047 => [ \047url\047 => $url, \047path\047 => $path, \047size\047 => $file->getSize(), ], ], 201); }

<?php public function uploadMultiple(Request $request) { $request->validate([ \047files\047 => \047required|array|max:10\047, \047files.*\047 => \047required|file|mimes:jpeg,png,pdf,doc,docx|max:5120\047, ]); $uploadedFiles = []; foreach ($request->file(\047files\047) as $file) { $path = $file->store(\047uploads\047, \047public\047); $uploadedFiles[] = [ \047original_name\047 => $file->getClientOriginalName(), \047path\047 => $path, \047url\047 => Storage::url($path), \047size\047 => $file->getSize(), \047mime_type\047 => $file->getMimeType(), ]; } return response()->json([ \047success\047 => true, \047message\047 => count($uploadedFiles) . \047 تم رفع الملفات بنجاح\047, \047data\047 => $uploadedFiles, ], 201); }

<?php // التثبيت: composer require intervention/image use Intervention\Image\Facades\Image; public function uploadWithThumbnail(Request $request) { $request->validate([ \047image\047 => \047required|image|max:10240\047, ]); $image = $request->file(\047image\047); $filename = time() . \047_\047 . uniqid() . \047.\047 . $image->extension(); // تخزين النسخة الأصلية $originalPath = $image->storeAs(\047images/original\047, $filename, \047public\047); // إنشاء صورة مصغرة $thumbnailImage = Image::make($image) ->fit(300, 300) ->encode($image->extension(), 90); Storage::disk(\047public\047)->put( \047images/thumbnails/\047 . $filename, $thumbnailImage ); // إنشاء حجم متوسط $mediumImage = Image::make($image) ->resize(800, null, function ($constraint) { $constraint->aspectRatio(); $constraint->upsize(); }) ->encode($image->extension(), 90); Storage::disk(\047public\047)->put( \047images/medium/\047 . $filename, $mediumImage ); return response()->json([ \047success\047 => true, \047data\047 => [ \047original\047 => Storage::url($originalPath), \047medium\047 => Storage::url(\047images/medium/\047 . $filename), \047thumbnail\047 => Storage::url(\047images/thumbnails/\047 . $filename), ], ], 201); }

<?php public function uploadChunk(Request $request) { $request->validate([ \047chunk\047 => \047required|file\047, \047chunk_number\047 => \047required|integer|min:0\047, \047total_chunks\047 => \047required|integer|min:1\047, \047file_name\047 => \047required|string\047, \047upload_id\047 => \047required|string\047, ]); $uploadId = $request->upload_id; $chunkNumber = $request->chunk_number; $totalChunks = $request->total_chunks; $fileName = $request->file_name; // تخزين الجزء مؤقتًا $chunkPath = \047chunks/\047 . $uploadId . \047/chunk_\047 . $chunkNumber; Storage::put($chunkPath, file_get_contents($request->file(\047chunk\047))); // التحقق من رفع جميع الأجزاء $uploadedChunks = count(Storage::files(\047chunks/\047 . $uploadId)); if ($uploadedChunks === $totalChunks) { // دمج جميع الأجزاء $finalPath = \047uploads/\047 . $fileName; $finalFile = fopen(Storage::path($finalPath), \047wb\047); for ($i = 0; $i < $totalChunks; $i++) { $chunkContent = Storage::get(\047chunks/\047 . $uploadId . \047/chunk_\047 . $i); fwrite($finalFile, $chunkContent); } fclose($finalFile); // تنظيف الأجزاء Storage::deleteDirectory(\047chunks/\047 . $uploadId); return response()->json([ \047success\047 => true, \047message\047 => \047اكتمل رفع الملف\047, \047data\047 => [ \047url\047 => Storage::url($finalPath), \047path\047 => $finalPath, ], ], 201); } return response()->json([ \047success\047 => true, \047message\047 => \047تم رفع الجزء\047, \047data\047 => [ \047uploaded_chunks\047 => $uploadedChunks, \047total_chunks\047 => $totalChunks, \047progress\047 => round(($uploadedChunks / $totalChunks) * 100, 2), ], ], 200); }

<?php public function download($id) { $file = File::findOrFail($id); // التحقق من التفويض if (!auth()->user()->can(\047download\047, $file)) { return response()->json([ \047success\047 => false, \047message\047 => \047غير مصرح\047, ], 403); } // التحقق من وجود الملف if (!Storage::disk(\047private\047)->exists($file->path)) { return response()->json([ \047success\047 => false, \047message\047 => \047الملف غير موجود\047, ], 404); } // تسجيل التنزيل $file->increment(\047download_count\047); // إرجاع الملف return response()->download( Storage::disk(\047private\047)->path($file->path), $file->original_name ); }

<?php public function getTemporaryUrl($id) { $file = File::findOrFail($id); // التحقق من التفويض if (!auth()->user()->can(\047view\047, $file)) { return response()->json([ \047success\047 => false, \047message\047 => \047غير مصرح\047, ], 403); } // إنشاء عنوان URL مؤقت (صالح لمدة 30 دقيقة) $url = Storage::disk(\047s3\047)->temporaryUrl( $file->path, now()->addMinutes(30) ); return response()->json([ \047success\047 => true, \047data\047 => [ \047url\047 => $url, \047expires_at\047 => now()->addMinutes(30)->toIso8601String(), ], ]); }