تحميل ملف Laravel: برنامج تعليمي شامل خطوة بخطوة

نشرت: 2024-10-07

جدول المحتويات

تبديل

تحميل ملف لارافيل

يعد تحميل الملفات ميزة أساسية في العديد من تطبيقات الويب، مما يسمح للمستخدمين بتحميل أنواع مختلفة من الملفات، مثل الصور أو المستندات أو مقاطع الفيديو. يوفر Laravel، وهو إطار عمل PHP شائع، طريقة سلسة وآمنة للتعامل مع تحميل الملفات. في هذا البرنامج التعليمي، سنستكشف كيفية إعداد وتنفيذ عمليات تحميل الملفات في Laravel من البداية. سواء كنت مطورًا مبتدئًا أو متوسطًا، سيساعدك هذا الدليل على إتقان تحميل الملفات في Laravel.

1. مقدمة إلى تحميل ملف Laravel

تعد عمليات تحميل الملفات جزءًا لا يتجزأ من تطبيقات الويب الحديثة. سواء كان الأمر يتعلق بتحميل صور الملف الشخصي أو السير الذاتية أو محتوى الوسائط المتعددة، فإن وجود نظام موثوق وآمن لتحميل الملفات يعد أمرًا بالغ الأهمية. يجعل Laravel، بوظائفه المضمنة، هذه العملية واضحة وفعالة. من خلال دعم التحقق من صحة الملفات وتخزينها وأمانها، يوفر Laravel طريقة سلسة لإدارة تحميلات الملفات.

في هذا البرنامج التعليمي، سوف نقوم بما يلي:

  • إنشاء نموذج تحميل ملف.
  • التعامل مع التحقق من صحة الملف.
  • تخزين الملفات على الخادم.
  • عرض الملفات التي تم تحميلها.
  • تأمين عملية تحميل الملف.

بحلول نهاية هذا الدليل، سيكون لديك فهم قوي لكيفية تنفيذ وتخصيص تحميلات الملفات في تطبيقات Laravel.

2. المتطلبات الأساسية

قبل الغوص في البرنامج التعليمي، تأكد من تثبيت ما يلي على جهازك:

  • بي إتش بي >= 8.0
  • الملحن(مدير التبعية لـ PHP)
  • لارافيل 9 أو أعلى
  • MySQL أو SQLiteلإدارة قواعد البيانات
  • المعرفة الأساسية بـ Laravel و PHP

إذا لم تكن على دراية بكيفية إعداد Laravel، فارجع إلى وثائق Laravel الرسمية أو استخدم الأمر التالي لإنشاء مشروع Laravel جديد:

سحق

نسخ الرمز

إنشاء مشروع الملحن - البرنامج التعليمي لتحميل ملف laravel/laravel المفضل

بعد إنشاء المشروع، انتقل إلى مجلد المشروع:

سحق

نسخ الرمز

البرنامج التعليمي-تحميل ملف القرص المضغوط

3. إعداد مشروع Laravel

بمجرد إعداد مشروع Laravel الخاص بك، فلنضبط الإعدادات الأساسية:

تكوين قاعدة البيانات:افتح ملف .env في الدليل الجذر وقم بتحديث بيانات اعتماد قاعدة البيانات الخاصة بك. إذا كنت تستخدم MySQL، فقم بتحديث الحقول التالية:
 نص عادي
 نسخ الرمز
 DB_CONNECTION=mysql

DB_HOST=127.0.0.1

DB_PORT=3306

DB_DATABASE=laravel_upload

DB_USERNAME=root

DB_PASSWORD=

بعد تكوين ملف .env ، قم بتشغيل الأمر التالي لترحيل الجداول الافتراضية:
 سحق
 نسخ الرمز
 ترحيل الحرفيين PHP

أ. تثبيت Bootstrap (اختياري)

لتصميم نموذج التحميل، يمكنك تضمين Bootstrap لتسهيل الأمر. في مجلد Resources/views/layouts ، أنشئ ملف Layout.blade.php وقم بتضمين Bootstrap:

أتش تي أم أل
 نسخ الرمز
 <!DOCTYPE html>

<html لانج=”en”>

<الرأس>

<ميتا محارف =”UTF-8″>

<اسم التعريف = "منفذ العرض" content = "العرض = عرض الجهاز، المقياس الأولي = 1.0 ″>

<title>البرنامج التعليمي لتحميل الملفات</title>

<link href=”https://cdn.jsdelivr.net/npm/[email protected]/dist/css/bootstrap.min.css” rel=”stylesheet”>

</الرأس>

<الجسم>

<div class=”حاوية mt-5″>

@العائد('المحتوى')

</div>

</الجسم>

</html>

4. إنشاء نموذج تحميل الملف

الآن، لنقم بإنشاء نموذج تحميل ملف.

إنشاء وحدة تحكم:إنشاء وحدة تحكم للتعامل مع تحميلات الملفات:
 سحق
 نسخ الرمز
 PHP الحرفي الصنع: وحدة تحكم FileUploadController

تحديد النموذج:في مجلد Resources/views ، قم بإنشاء ملف يسمى upload.blade.php بالكود التالي:
 أتش تي أم أل
 نسخ الرمز
 @extends('layouts.layout')

@القسم('المحتوى')

<div class=”صف”>

<div class=”col-md-6 إزاحة-md-3″>

<h3 class=”text-center”>تحميل ملف</h3>

<إجراء النموذج =”{{ مسار ('file.upload.post') }}” طريقة =”POST” enctype=”multipart/form-data”>

@csrf

<div class=”form-group mb-3″>

<label for=”file”>اختر ملفًا:</label>

<نوع الإدخال=”ملف” class=”form-control” name=”file” id=”file”>

@خطأ('ملف')

<small class=”text-danger”>{{ $message }}</small>

@enderror

</div>

<button type=”submit” class=”btn btn-primary”>تحميل</button>

</النموذج>

</div>

</div>

@endsection

إعداد المسارات:في ملف المسارات/web.php ، حدد المسارات لعرض النموذج ومعالجة تحميلات الملفات:
 PHP
 نسخ الرمز
 استخدم App\Http\Controllers\FileUploadController;

Route::get('upload', [FileUploadController::class, 'showForm'])->name('file.upload');

Route::post('upload', [FileUploadController::class, 'uploadFile'])->name('file.upload.post');

5. التعامل مع منطق تحميل الملف

في FileUploadController.php ، اكتب المنطق للتعامل مع عملية تحميل الملف:

إظهار النموذج:
PHP
 نسخ الرمز
 الوظيفة العامة showForm() {

عرض العودة ("تحميل")؛

}

التعامل مع تحميلات الملفات:
في نفس وحدة التحكم، أضف الطريقة التالية للتعامل مع عمليات تحميل الملفات:
 PHP
 نسخ الرمز
 الوظيفة العامة uploadFile(طلب طلب $) {

// التحقق من صحة الملف الذي تم تحميله

طلب $->التحقق من الصحة([

'file' => 'مطلوب|ملف|mimes:jpeg,png,pdf,docx|max:2048',

]);

// قم بتخزين الملف

إذا ($طلب->ملف('ملف')) {

$fileName = time() . '_' . $request->file->getClientOriginalName();

$filePath = $request->file('file')->storeAs('uploads', $fileName, 'public');

}

return back()->with('success', 'تم تحميل الملف بنجاح.');

}

تقوم هذه الطريقة بالتحقق من صحة الملف، والتحقق من وجود الملف، وتخزينه باستخدام طريقة storeAs .

6. التحقق من صحة تحميلات الملفات

يعد التحقق من الصحة أمرًا بالغ الأهمية لضمان قيام المستخدمين بتحميل أنواع وأحجام الملفات المسموح بها فقط. تعمل طريقة التحقق من صحة Laravel على تبسيط هذه العملية. قواعد التحقق المستخدمة هنا هي:

  • مطلوب : التأكد من تحميل الملف.
  • ملف : يضمن أن العنصر الذي تم تحميله هو ملف.
  • التمثيل الصامت : يحدد أنواع الملفات المسموح بها (على سبيل المثال، jpeg، png، pdf، docx).
  • max : يحدد الحد الأقصى لحجم الملف بالكيلوبايت (على سبيل المثال، 2048 كيلو بايت = 2 ميجابايت).

يمكنك تخصيص هذه القواعد لتناسب متطلبات التطبيق الخاص بك.

7. تخزين الملفات

تتيح لك واجهة التخزين في Laravel تخزين الملفات بسهولة. في المثال أعلاه، نستخدم التابع storeAs لتخزين الملف في الدليل public/uploads . لتسهيل الوصول إلى المجلد العام/التحميلات ، تحتاج إلى ربط دليل التخزين بالمجلد العام. قم بتشغيل الأمر التالي:

سحق

نسخ الرمز

تخزين PHP الحرفي: الرابط

ينشئ هذا الأمر رابطًا رمزيًا من Storage/app/public إلى public/storage .

8. عرض الملفات المرفوعة

لعرض الملفات التي تم تحميلها، قم باستعادتها من مجلد التخزين وقم بإنشاء عنوان URL باستخدام واجهة التخزين . إليك كيفية عرض الصور أو الملفات:

في وحدة التحكم:
PHP
 نسخ الرمز
 الوظيفة العامة showUploads() {

$files = التخزين::disk('public')->files('uploads');

عرض الإرجاع('التحميلات', مضغوط('ملفات'));

}

  1. في العرض:

قم بإنشاء ملف Resources/views/uploads.blade.php :
 أتش تي أم أل
 نسخ الرمز
 @extends('layouts.layout')

@القسم('المحتوى')

<h3>الملفات المرفوعة:</h3>

<ul>

@foreach(ملفات $ كملف $)

<li><a href=”{{ asset('storage/' . $file) }}”>{{ basename($file) }}</a></li>

@endforeach

</ul>

@endsection

  1. سيؤدي هذا إلى إنشاء قائمة بالملفات التي تم تحميلها مع روابط التنزيل.

9. تأمين تحميلات الملفات

يمكن أن تشكل عمليات تحميل الملفات مخاطر أمنية إذا لم يتم التعامل معها بشكل صحيح. فيما يلي بعض أفضل الممارسات لتأمين تحميلات الملفات:

  • الحد من أنواع الملفات المسموح بها: تحقق دائمًا من صحة نوع الملف باستخدام قاعدة التمثيل الصامت .
  • الحد من حجم الملف: قم بتقييد أحجام الملفات لمنع الاستهلاك المفرط لموارد الخادم.
  • استخدم تسمية الملفات المناسبة: قم بتخزين الملفات باستخدام أسماء فريدة لتجنب الكتابة فوق الملفات الموجودة.
  • فحص الملفات: فكر في استخدام أدوات مكافحة الفيروسات أو أدوات فحص الملفات للكشف عن التحميلات الضارة.
  • تقييد الوصول العام: تجنب تخزين الملفات الحساسة في أدلة يمكن الوصول إليها بشكل عام. يمكنك استخدام دليل تخزين Laravel للملفات الخاصة وإنشاء وحدة تحكم لخدمتها بشكل آمن.

10. الاستنتاج

تعد تحميلات الملفات ميزة حيوية للعديد من تطبيقات الويب، ويعمل Laravel على تبسيط العملية من خلال أدواته ووظائفه المضمنة. في هذا البرنامج التعليمي، قمنا بتغطية أساسيات إعداد تحميلات الملفات، والتحقق من صحة الملفات وتخزينها، وعرضها، وتأمين عملية التحميل. باستخدام هذا الأساس، يمكنك تخصيص وظيفة تحميل الملفات وتوسيعها لتناسب احتياجات مشروعك.