درس مصغّر · العربية

كيف تتيح للمستخدمين رفع الصور

ارفع صور الاختبار المرفقة وافتحها لاحقًا واحذفها، مع فحص حدود الحجم وملكية الحساب.

ابدأ الدرس التفاعلياقرأ ملاحظات الدرس

لمن هذا الدرس؟

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

قبل أن تبدأ

تحتاج إلى مشروع Supabase تجريبي منفصل وحسابَي اختبار تتحكم بهما. الملفات الصغيرة والكبيرة جدًا وغير المدعومة مرفقة. اطلب من المساعد تجهيز تخزين avatars الخاص والسياسات المرفقة في هذا المشروع القابل للحذف.

الوقت المتوقع: 25–42 دقيقة

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

ما الذي ستتعلمه؟

  • ميّز المعاينة المحلية من ملف رُفع إلى التخزين.
  • اختبر الملفات المرفقة المقبولة والمرفوضة.
  • افحص الحذف المقصور على المالك وحدود حساب آخر.

ملفات ورشة العمل

الخطوة 1

افهم ما تثبته المعاينة

اختيار اسم ملف، وحفظ ملف مرفوع، والقدرة على قراءة صورة ثلاث ملاحظات مختلفة.

افتح التطبيق المرفق مع المساعد واختر fixtures/avatar-small.webp. قبل الضغط على Upload image، يعرض حقل الملف الاسم المختار. لا تنشئ نسخة البداية معاينة محلية للصورة عند الاختيار؛ ولا تظهر الصورة إلا بعد نجاح الرفع والوصول الموقّع.

قد تعاين تطبيقات أخرى صورة محلية دون حفظها. وهنا أيضًا لا يثبت اختيار اسم الملف أي رفع عن بُعد. افصل فحوص الاختيار والتخزين لدى المزود وقراءة الصورة لاحقًا.

مثال عملي

يمكن أن يعرض اختيار avatar-small.webp اسم الملف قبل إعداد حساب التخزين. لإثبات التخزين عن بُعد لاحقًا، ابحث عن الكائن المرفوع لدى المزود وافحص المعاينة ذات الرابط الموقّع التي تقرؤه.

استخدم حزمة رفع الصور الكاملة ومشروع Supabase التجريبي القابل للحذف الخاص بي. ساعدني في ضبط الدخول وحاوية avatars خاصة وحد 2 MB المعلن وصيغ الصور المسموحة باستخدام السياسات المرفقة. أبقِ المفاتيح الخاصة خارج الملفات العامة. شغّل الصفحة ووجّهني لاختبار الملفات الصغيرة والكبيرة جدًا وغير المدعومة، واختبارات الحذف بجلسات حسابات منفصلة. تولَّ تعديلات الكود نيابة عني.

ملفات هذه الخطوة

fixtures/avatar-small.webp
fixtures/avatar-small.webpتنزيل هذا الملف

Start hereملفات ورشة العمل

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

خزّن الصورة، لا معاينة محلية فقط

المعاينة المنشأة من ملف مختار ليست دليلًا على تلقي خدمة تخزين له.

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

سنستخدم حاوية Supabase خاصة بمجلد مالك لكل حساب. يرفع التطبيق ملفًا ثم يطلب رابط معاينة موقّعًا قصير العمر. ولا يجعل كل رفع قابلًا للقراءة العامة.

مثال محلول

قد تعمل معاينة blob: محلية دون أي طلب شبكة. سيفحص اختبارنا الكائن الفعلي ويجلبه عبر مسار مصرح به.

Extra implementation exercise

تظهر الصورة المختارة فورًا عبر رابط blob. هل حدث الرفع بالضرورة؟

عرض حل نموذجي مشروح

لا. تحقق من عملية التخزين والكائن المطابق قبل ادعاء الرفع.

  • تفصل المعاينة المحلية عن التخزين البعيد.
  • تفحص نتيجة الرفع والكائن المخزن.

الخطوة 2

جهّز تخزينًا خاصًا للاختبار

استخدم الإعدادات المرفقة واستعن بالمساعد في الضبط.

في مشروعك القابل للحذف، دع المساعد يضبط حاوية avatars الخاصة وحدود الحجم والصيغ وpolicies.sql. شغّل تطبيق الدخول والرفع الكامل عبر HTTP.

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

مثال عملي

يمكن أن تساعد واجهة الزائر في رفض ملف، لكن يجب أن تفرض خدمة التخزين قواعدها أيضًا.

Supabase: التحكم في الوصول إلى التخزين

ملفات هذه الخطوة

Start hereملفات ورشة العمل

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

أنشئ حاوية خاصة وقواعد مالك

يفرض إعداد الحاوية وسياسات الوصول جزأين مختلفين من المهمة.

أنشئ حاوية avatars خاصة. اضبط حد حجمها 2MB وأنواع MIME المسموحة ثم طبّق policies.sql. ينبغي ألا تتمكن أدوار المتصفح من الإدراج والقراءة إلا في مسارات تحت معرّف مستخدمها المتحقق منه.

سمة accept لدى العميل وسيلة راحة، لا فحص أمان. تظل قواعد الحجم والنوع لدى المزوّد وسياسات الملكية مطبقة على الطلبات المباشرة. تسميات MIME وحدها لا تثبت سلامة محتوى ملف اعتباطي؛ لا تقدم هذا المختبر بوصفه خدمة فحص كاملة.

لكائن اسمه USER_A/avatar-1.webp، تعيد storage.foldername(name) مكونات المجلد؛ وتختار [1] الأول منها في مصفوفة PostgreSQL هذه. يجب أن يساوي معرّف المستخدم المصادَق عليه. يفشل USER_B/avatar-1.webp للحساب A. تختلف هذه القاعدة في التخزين عن منتقي الملفات وفحص MIME المسبق في المتصفح.

يبقى مقطع المسار الأول معرّف المستخدم حتى مع مجلدات متداخلة: يظل USER_A مكون المجلد [1] في USER_A/subfolder/avatar.webp. لن يتطابق مسار يبدأ بـsubfolder/USER_A/.... أبقِ معرّف المالك أولًا؛ ولا ترخِ السياسة لمجرد استيعاب مسار خاطئ.

مثال محلول

تأتي بادئة المجلد من المستخدم المسجّل، بينما تقارنها سياسة قاعدة البيانات بـauth.uid(). يجب ألا يمنح تغيير مسار متصفح إلى مجلد مستخدم آخر إذنًا.

create policy "upload own avatar" on storage.objects for insert to authenticated
with check (bucket_id='avatars' and (storage.foldername(name))[1]=auth.uid()::text);
create policy "read own avatar" on storage.objects for select to authenticated
using (bucket_id='avatars' and (storage.foldername(name))[1]=auth.uid()::text);

Supabase: التحكم في الوصول إلى التخزين

Extra implementation exercise

لماذا لا يكفي فحص امتداد الملف في JavaScript فقط؟

عرض حل نموذجي مشروح

يستطيع مقدم الطلب إرسال طلب مباشر ببيانات وصفية مختلفة أو مسار مختلف. افرض الحاوية المقصودة وقواعد المالك عند حد الخدمة.

  • تدرك أن مقدم الطلب يستطيع تجاوز JavaScript.
  • تشترط قيودًا وتفويضًا على جانب التخزين.

الخطوة 3

ارفع صورة الاختبار الصغيرة

افحص العنصر المخزّن إلى جانب الصورة الظاهرة.

سجّل الدخول بالحساب A وارفع الصورة الصغيرة المرفقة. اعثر على عنصرها لدى المزود، واستخدم المعاينة الناتجة أو مسار الوصول عبر الرابط الموقّع.

إن نجح التخزين وفشلت المعاينة، فافحص القراءة والمعاينة قبل رفع نسخة أخرى. احتفظ بمرجع العنصر المسجّل.

مثال عملي

غياب المعاينة لا يعني بالضرورة فشل الرفع نفسه.

ملفات هذه الخطوة

Start hereملفات ورشة العمل

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

ارفع إلى مسار مالك فريد

استخدم اسمًا مولّدًا بدل الثقة بمسار مقدم الطلب أو استبدال ملف قائم.

بعد الدخول، يختار التطبيق مسارًا باستخدام معرّف المستخدم المتحقق منه واسم ملف عشوائي. يفحص حجم الصورة المختارة ونوعها قبل طلب الرفع، لكن تلك الفحوص لا تستبدل فرض المزوّد.

لا يفعّل الرفع upsert. إذا نجح التخزين وفشل إنشاء رابط موقّع، تبلغ الواجهة عنهما كملاحظتين منفصلتين. لا تقول أبدًا «لم يُرفع شيء» حين قد يكون الكائن موجودًا.

مثال محلول

يتجنب اسم ملف مولّد التصادم بالخطأ مع صورة أخرى اسمها photo.jpg. وليس آلية تفويض بمفرده.

Extra implementation exercise

الكائن موجود، لكن إنشاء المعاينة فشل. هل ينبغي رفع نسخة أخرى فورًا؟

عرض حل نموذجي مشروح

افحص مسار الكائن وسياسة القراءة أولًا. قد ينشئ تكرار الرفع نسخًا مكررة دون إصلاح مشكلة المعاينة.

  • تفصل نجاح الرفع عن تفويض المعاينة.
  • تفحص سياسة القراءة والمسار قبل إنشاء نسخ مكررة.

الخطوة 4

جرّب حالات الفشل المرفقة

يتضمن التمرين ملفات ينبغي ألا تُرفع.

استخدم fixtures/avatar-too-large.png وfixtures/not-an-image.txt. سجّل استجابة الصفحة والتخزين. اطلب من المساعد فحص رفض غير مفهوم أو ملف غير صالح مرّ رغم القيود.

يجب ألا تتحول الملفات المرفوضة إلى عناصر مخزنة. قد يسمح رابط موقّع صالح لحامله بعرض الصورة طوال صلاحيته؛ وهذا وحده لا يثبت أن الحاوية أصبحت عامة.

مثال عملي

قيود نافذة اختيار الملف وفرض القيود الفعلي في التخزين اختباران مختلفان.

ملفات هذه الخطوة

fixtures/avatar-small.webp
fixtures/avatar-small.webpتنزيل هذا الملف

Start hereملفات ورشة العمل

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

تحقق من الرفض والوصول المؤقت

اختبر قواعد الخدمة وافهم ما يمنحه رابط موقّع.

ارفع fixtures/avatar-small.webp بالحساب A. افحص مسار التخزين وافتح المعاينة الموقعة المسموح بها. جرّب بعد ذلك fixtures/avatar-too-large.png الذي يتجاوز 2MiB وfixtures/not-an-image.txt ذي النوع غير المدعوم؛ يجب رفضهما. الملفات الثلاثة مرفقة.

استخدم الحساب B لطلب رابط موقّع لمسار A؛ ينبغي أن ترفض سياسة المالك ذلك. يظل بإمكان أي شخص يحصل على رابط موقّع صدر لـA بصورة مشروعة استخدامه حتى انتهاء صلاحيته. تسجيل خروج العميل لا يلغي كل رابط صدر فورًا.

مثال محلول

يسجل تقرير مفيد مسارًا محجوب البيانات الحساسة ومدة صلاحية، لا رابط الوصول المؤقت كاملًا.

Extra implementation exercise

يفتح شخص يحمل رابطًا موقعًا صالحًا الصورة دون تسجيل دخول. هل يثبت ذلك وحده فشل سياسة الحاوية الخاصة؟

عرض حل نموذجي مشروح

لا. اختبر ما إذا كان حساب غير مصرح له يستطيع إنشاء الرابط أو القراءة دون صلاحية مصرح بها. تعامل مع الروابط الصادرة كبيانات حساسة حتى انتهاء صلاحيتها.

  • تدرك أن الروابط الموقعة صلاحيات حامل مؤقتة.
  • تميّز الوصول بالرابط عن الإذن بإنشائه.

الخطوة 5

أضف الحذف المقصور على المالك

تحقق ممن يستطيع إزالة العنصر المرفوع.

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

في جلسة B المنفصلة، اطلب من المساعد استهداف Y بمحاولة حذف مباشر. سجل الفاعل B والهدف Y ونتيجة المزود، ثم تحقق من أن Y المملوك لـA ما زال موجودًا. فحص زر حذف مخفي فقط، أو محاولة حذف X غير الموجود مجددًا، لا يثبت حد الملكية هذا.

مثال عملي

إزالة صورة من الشاشة لا تعادل حذف العنصر المخزّن.

ملفات هذه الخطوة

fixtures/avatar-small.webp
fixtures/avatar-small.webpتنزيل هذا الملف

Start hereملفات ورشة العمل

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

مهمتك: أضف حذفًا خاصًا بالمالك

تحتاج عملية جديدة إلى سياستها واختباراتها السلبية الخاصة.

أضف عنصر حذف للكائن المرفوع وسياسة DELETE مقيدة بمجلد مالكه. لا توسّع الحاوية القائمة إلى مساحة مشتركة عامة.

تحقق من قدرة A على إزالة كائنه وعدم قدرة B على ذلك. أبقِ حالة التخزين متسقة مع الواجهة بعد حذف فاشل.

مثال محلول

تسمح السياسات الأصلية عمدًا بالإدراج والقراءة فقط. لا يفوّض إذن الرفع الحذف تلقائيًا.

يتوفر الشرح المرجعي الكامل في reference/assignment-walkthrough.txt. قارن خطواته بنتيجتك؛ واملأ سجل الاختبار بملاحظات من مشروعك أنت.

Extra implementation exercise

نفّذ حذفًا خاصًا بالمالك وأظهر المحاولات المسموحة والممنوعة.

عرض حل نموذجي مشروح

استخدم حاوية avatars خاصة بإعدادات حجم ونوع في التخزين وسياسات مجلد المالك. ارفع صورة مسموحة بالحساب A؛ وافحص نتيجة التخزين المعادة ثم افتح المعاينة الموقعة القصيرة العمر. معاينة blob وحدها لا تثبت رفعًا بعيدًا.

جرّب ملفًا غير مدعوم أو أكبر من المسموح وحاول رفعًا أو قراءة تحت مجلد الحساب B. يجب ألا يحصل A على وصول بمجرد تغيير مسار في أدوات المطوّر. تمنح الروابط الموقعة عمدًا وصولًا مؤقتًا حتى انتهاء صلاحيتها.

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

  • يفحص إذن الحذف الحاوية ومجلد المالك المتحقق منه.
  • لا تزيل المحاولات الفاشلة كائن حساب آخر أو تمحو الواجهة كذبًا.

هل أفادك هذا الدرس؟

اترك إعجابًا، أو شاركه مع شخص قد يستفيد منه.

واصل التعلّم

استكشف الدروس الأخرى