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

درس مصغّر 14 من 30 · الحسابات والوصول

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

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

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

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

هدف هذا الدرس

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

قبل أن تبدأ

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

تحقّق من مهارات البداية

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

  1. كيف تتيح للناس تسجيل الدخول إلى موقعك

    اطلب رمز دخول حقيقيًا واستخدمه.

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

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

افهم الفكرة

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

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

مثال عملي

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

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

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

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

ابدأ هناملفات ورشة العمل

افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.

جرّب بنفسك

اختر الصورة الصغيرة المرفقة دون رفعها. ماذا يعرض حقل الملف، وما دليل التخزين أو القراءة الذي ما زال مفقودًا؟

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

مثال ملاحظة قبل الرفع: «عرض اختيار avatar-small.webp اسمه في حقل الملف. لم يُظهر التطبيق صورة مرفوعة بعد. لم أضغط Upload image ولم أجد كائنًا محفوظًا».

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

ما تتضمنه الإجابة السليمة

  • يسجل اسم الملف المختار منفصلًا عن الصورة المسترجعة بعد الرفع.
  • يحدد كائن المزود ونجاح قراءته لاحقًا دليلين ما زالا مطلوبين.
كيف يعمل؟ (اختياري)

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

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

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

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

مثال محلول

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

تمرين تقني إضافي

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

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

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

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

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

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

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

شرح ومثال محلول وتدريب

افهم الفكرة

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

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

مثال عملي

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

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

ابدأ هناملفات ورشة العمل

افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.

جرّب بنفسك

ما إعدادات التخزين التي طُبقت؟ وهل يستطيع حساب اختبارك فتح التطبيق الذي يعمل؟

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

مثال سجل إعداد: «أعدّ المساعد حاوية avatars الخاصة في المشروع المؤقت، وضبط حد 2 MB والصيغ PNG وJPEG وWebP المذكورة، وطبّق سياسات مجلد المالك المرفقة. يفتح التطبيق عبر HTTP ويستطيع A تسجيل الدخول».

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

ما تتضمنه الإجابة السليمة

  • يحدد المشروع المؤقت وحاوية avatars الخاصة وحدود الصيغ والحجم المُعدّة.
  • يسجل عمل تطبيق الدخول والرفع وأي عائق إعداد، دون إضعاف حماية التخزين.
كيف يعمل؟ (اختياري)

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

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

أنشئ حاوية 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: التحكم في الوصول إلى التخزين

تمرين تقني إضافي

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

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

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

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

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

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

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

شرح ومثال محلول وتدريب

افهم الفكرة

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

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

مثال عملي

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

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

ابدأ هناملفات ورشة العمل

افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.

جرّب بنفسك

هل خُزّنت الصورة الصغيرة؟ وهل أمكن قراءتها بعد ذلك؟

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

مثال سجل رفع: «رفع A ملف avatar-small.webp. أظهر المزود كائنًا داخل مجلد A، فاحتفظت بمرجعه مع إخفاء البيانات الحساسة. ثم ظهرت الصورة عبر المعاينة ذات الرابط الموقّع قصير الصلاحية».

يمكن وصف نتيجة جزئية هكذا: «الكائن موجود، لكن الوصول عبر المعاينة فشل». يستدعي ذلك فحص قراءة الكائن نفسه وصلاحياته، لا رفع نسخ متكررة دون معرفة هل نجح الحفظ.

ما تتضمنه الإجابة السليمة

  • يربط رفع A الناجح بمرجع الكائن المحفوظ فعليًا.
  • يسجل بصورة مستقلة هل استطاعت المعاينة الموقّعة قراءة هذا الكائن.
كيف يعمل؟ (اختياري)

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

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

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

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

مثال محلول

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

تمرين تقني إضافي

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

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

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

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

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

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

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

شرح ومثال محلول وتدريب

افهم الفكرة

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

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

مثال عملي

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

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

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

ابدأ هناملفات ورشة العمل

افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.

جرّب بنفسك

ماذا حدث للملفين الكبير جدًا وغير المدعوم؟ وما مسار الوصول الذي اختبرته فعلًا؟

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

مثال سجل رفض: «رُفض ملف PNG الزائد الحجم ولم يظهر كائن جديد. ورُفض الملف النصي أيضًا؛ وساعدني المساعد في اختباره إن أخفى منتقي الملفات الصيغ غير المدعومة».

«فُتح رابط الصورة المسموحة الموقّع خلال مدة صلاحيته القصيرة. أثبت ذلك الوصول عبر ذلك الرابط، لا أن الحاوية الخاصة أصبحت عامة». ترشيح منتقي الملفات وحده لا يختبر قيود التخزين لدى المزود مباشرةً.

ما تتضمنه الإجابة السليمة

  • يسجل الرفض وحالة التخزين بصورة منفصلة لكل من الملفين غير الصالحين المرفقين.
  • يميز القراءة عبر رابط موقّع مؤقت عن الوصول غير المقيد إلى حاوية عامة.
كيف يعمل؟ (اختياري)

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

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

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

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

مثال محلول

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

تمرين تقني إضافي

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

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

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

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

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

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

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

شرح ومثال محلول وتدريب

افهم الفكرة

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

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

مثال عملي

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

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

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

ابدأ هناملفات ورشة العمل

افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.

جرّب بنفسك

قدّم نتيجة حذف المالك ومحاولة الحساب الثاني، مع النتائج الفعلية للعناصر المخزنة.

ما المطلوب إنجازه: نتيجة الرفع والحذف، والاختبارات الفعلية للملف الصالح والكبير جدًا وغير المدعوم والمحاولة بين الحسابات.

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

مثال سجل حذف: «حذف A الكائن X وأكد المزود غيابه. ثم رفع A كائنًا جديدًا Y. حاولت جلسة B المنفصلة حذف Y؛ وتحقق A من أن Y ما زال موجودًا».

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

ما تتضمنه الإجابة السليمة

  • يحذف كائن A الأول بصفته المالك ويتحقق من غياب ذلك الكائن نفسه.
  • يرفع كائنًا جديدًا مملوكًا لـA، ويستهدفه من B، ويتحقق من بقائه محفوظًا.
كيف يعمل؟ (اختياري)

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

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

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

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

مثال محلول

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

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

تمرين تقني إضافي

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

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

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

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

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

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

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

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